diff --git a/ATLAS-Open-Data-Python-13-TeV-framework-script-analysis.ipynb b/ATLAS-Open-Data-Python-13-TeV-framework-script-analysis.ipynb index 2a163cbf3ce558c52f45dabe914207af608b5edc..b613628e935fa5ec40a4646bf6c0e4fa09f1a22e 100644 --- a/ATLAS-Open-Data-Python-13-TeV-framework-script-analysis.ipynb +++ b/ATLAS-Open-Data-Python-13-TeV-framework-script-analysis.ipynb @@ -44,7 +44,11 @@ "</p>\n", "\n", "\n", - "**TMath** encapsulate most frequently used Math functions. The basic functions Min, Max, Abs and Sign are defined in TMathBase." + "**TMath** encapsulate most frequently used Math functions. The basic functions Min, Max, Abs and Sign are defined in TMathBase.\n", + "\n", + "<p style='text-align: justify;'>\n", + "Finally, the <strong>pandas</strong> library is a Python library that serves as a tool for reading, writing and manipulating data in the form of DataFrames and Series objects. It will not be used to running or plotting the Analysis, but to read the ATLAS Open Data database with the descriptions of the analysis that can be done in this notebook.\n", + "</p>" ] }, { @@ -56,7 +60,8 @@ "import os\n", "import datetime\n", "import ROOT\n", - "from ROOT import TMath" + "from ROOT import TMath\n", + "import pandas as pd" ] }, { @@ -412,7 +417,7 @@ "### Let's run an Analysis now\n", "\n", "<p style='text-align: justify;'>\n", - "The naming of the sub-folders follows a simple rule: \"NNAnalysis\", where NN can be WBoson, ZBoson, TTbar, SingleTop, WZDiBoson, ZZDiBoson, HZZ, HWW, Hyy, ZPrimeBoosted, ZTauTau and SUSY.\n", + "The naming of the sub-folders follows a simple rule: \"NNAnalysis\", where NN can be WBoson, ZBoson, TTbar, SingleTop, WZDiBoson, ZZDiBoson, HZZ, HWW, Hyy, ZPrimeBoosted, ZTauTau and SUSY. After you enter your choice, you will see the description of the analysis that has been obtained from a pandas dataframe generated from a .csv file with the analysis information. \n", "</p>\n", "\n", "### Select one analysis" @@ -420,9 +425,38 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 2, "metadata": {}, "outputs": [], + "source": [ + "analysis_df = pd.read_csv(\"notebooks-info/analysis_info.csv\", sep=\"_\").set_index(\"Analysis\")" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "The options are:\n", + " WBosonAnalysis\n", + " ZBosonAnalysis\n", + " TTbarAnalysis\n", + " SingleTopAnalysis\n", + " WZDiBosonAnalysis\n", + " ZZDiBosonAnalysis\n", + " HZZAnalysis\n", + " HWWAnalysis\n", + " ZTauTauAnalysis\n", + " HyyAnalysis\n", + " SUSYAnalysis\n", + " ZPrimeBoostedAnalysis\n" + ] + } + ], "source": [ "print(\"The options are:\\n WBosonAnalysis\\n ZBosonAnalysis\\n TTbarAnalysis\\n SingleTopAnalysis\\n WZDiBosonAnalysis\\n ZZDiBosonAnalysis\\n HZZAnalysis\\n HWWAnalysis\\n ZTauTauAnalysis\\n HyyAnalysis\\n SUSYAnalysis\\n ZPrimeBoostedAnalysis\")" ] @@ -442,6 +476,23 @@ " print(\"Analysis not found\")" ] }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Higgs boson decay in the two-photon final state.\n" + ] + } + ], + "source": [ + "print(analysis_df[\"Description\"].loc[f\"{analysis}\"])" + ] + }, { "cell_type": "markdown", "metadata": {}, @@ -625,7 +676,7 @@ "metadata": {}, "outputs": [], "source": [ - "command5 = f\"echo \\{number}\\n0\\ | ./plotme.sh\"\n", + "command5 = f\"echo \\\"{number}\\n0\\\" | ./plotme.sh\"\n", "os.system(command5)" ] }, @@ -633,7 +684,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "Show histograms created." + "Show histograms created. " ] }, { @@ -646,6 +697,30 @@ "print(myCmd)" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Show explanation from the ATLAS Open Data 13 TeV Documentation." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "The H → yy decay mode provides a very clear and distinctive signature of two isolated and highly energetic photons, and is one of the main channels studied at the LHC. Despite the small branching ratio, a reasonably large signal yield can be obtained thanks to the high photon reconstruction and identification efficiency at the ATLAS experiment. Furthermore, due to the excellent photon energy resolution of the ATLAS calorimeter, the signal manifests itself as a narrow peak in the diphoton invariant mass spectrum on top of a smoothly falling irreducible background from QCD production of two photons.\n" + ] + } + ], + "source": [ + "print(analysis_df[\"Explanation\"].loc[f\"{analysis}\"])" + ] + }, { "cell_type": "code", "execution_count": null, diff --git a/notebooks-info/analysis_info.csv b/notebooks-info/analysis_info.csv new file mode 100644 index 0000000000000000000000000000000000000000..954ce57a9f39a81f60cc9b497fa40252581d6549 --- /dev/null +++ b/notebooks-info/analysis_info.csv @@ -0,0 +1,17 @@ +Analysis_Description_Explanation +WBosonAnalysis_W-boson production in the single-lepton final state._W-bosons are produced abundantly at the LHC and the measurements of the inclusive production cross section of the W bosons and of the asymmetry between the positively-charged and negatively-charged W-boson cross sections constitute important tests of the SM. In addition, W+jets processes are a significant background to studies of SM processes such as single-top production, top-quark pair production, as well as searches for the SM Higgs boson and for BSM physics. +ZBosonAnalysis_Z-boson production in the two-lepton final state._The study of Z-boson production in pp collisions provides a stringent test of perturbative QCD. In addition, the SM Z-boson process, often produced in association with one or more jets, is a significant background to searches for the SM Higgs boson and for physics beyond the SM. +TTbarAnalysis_Top-quark pair production in the single-lepton final state_"The top quark is the heaviest elementary particle in the SM, with a mass of around 172.5 GeV, which is close to the electroweak symmetry breaking scale. At the LHC, top quarks are primarily produced in quark–antiquark pairs (tt), and due to its large production cross section ( around 830 pb at 13 TeV), the LHC can be viewed as ""a top-quark factory"". Top quarks have a rich phenomenology which includes high-pTjets, b-jets, leptons and missing transverse momentum. Its understanding is crucial for studying rarer processes, given that tt production is a background to virtually all processes having leptons and multiple jets in their final states." +SingleTopAnalysis_Single-top-quark production in the single-lepton final state_"At hadron colliders, top quarks are predominantly produced in pairs via the flavour conserving strong interaction, but single top-quark production can occur via charged current electroweak processes involving a Wtb vertex. +In pp collisions, the t-channel exchange is the dominant production process of single top quarks: an exchange of a space-like W boson due to the interaction of a light quark with a b-quark produces a top quark and a forward light-quark (called the spectator quark) in the final state." +WZDiBosonAnalysis_WZ diboson production in the three-lepton final state._The study of the diboson production is an important part of the physics programme in hadron collisions as it represents an important test of the electroweak sector of the SM. In particular, the WZ diboson production arises from two vector bosons radiated by quarks or from the decay of a virtual W boson into a WZ pair, the latter of which involves a triple gauge coupling. +ZZDiBosonAnalysis_ZZ diboson production in the four-lepton final state._The study of ZZ diboson production in pp interactions at the LHC not only can be used as a test of the electroweak sector of the SM. The SM ZZ production can proceed via a SM Higgs boson propagator, although this contribution is suppressed in the region where both Z bosons are produced on-shell. Hence, non-resonant ZZ diboson production is an important background for searches of the SM Higgs boson with its subsequent decay to ZZ. +HWWAnalysis_Higgs boson production in the Higgs boson to WW bosons decay channel in the two-lepton final state._The H → WW decay branching ratio for the Higgs boson with a mass of 125 GeV is predicted to be 0.214 in the SM, and corresponds to the second-largest branching fraction after the dominant H → bb decay mode. The predicted Higgs-boson production cross sections via the dominant gluon–gluon fusion (ggF) and vector-boson fusion (VBF) times H → WW branching fraction are 10.4 pb and 0.81 pb for ggF and VBF, respectively. Reducing the numerous backgrounds contributing to this channel and accurately estimating the remainder is a major challenge in this analysis. The dominant background stems from non-resonant WW diboson production, while tt, single-top-quark and W+jets (with the jet misidentified as a lepton) events, as well as non-resonant WZ and ZZ processes contribute to the overall background. +HZZAnalysis_Higgs boson production in the Higgs boson to ZZ bosons decay channel in the four-lepton final state._"The search for the SM Higgs boson through the decay H → ZZ → 4l, where l = e or μ, represents the so called ""golden channel"" and leads to a narrow four-lepton invariant-mass peak on top a relatively smooth and small background, largely due to the excellent momentum resolution of the ATLAS detector. The Higgs-boson decay branching ratio to the four-lepton final state for the Higgs boson mass of 125 GeV is predicted to be 0.0124% in the SM, and the expected cross section times branching ratio for the process H → ZZ → 4l is 2.9 fb at 13 TeV. Hence, based on an integrated luminosity of the current ATLAS Open Data set of 10/fb, one expects a total of 29 events to have been produced in the four-lepton final state (before reconstruction and event selection)." +ZTauTauAnalysis_Z-boson production in the two-tau-lepton final state_"The τ-leptons play an important role in the physics programme of the LHC. They serve not only as a foundation to identify and precisely measure several SM production processes, but also are widely used in searches for new physics beyond the SM. +In the analysis a selection criteria is made in order to reconstruct the Z → ττ decays from a hadronically decaying τ-lepton, accompanied by a &tau-lepton that decays leptonically. The leptonic &tau-lepton decays are reconstructed as electrons and muons in the final state. The hadronic &tau-lepton decays produce a highly collimated jet in the detector consisting of an odd number of charged hadrons and possibly additional calorimetric energy deposits from neutral decay products." +HyyAnalysis_Higgs boson decay in the two-photon final state._The H → yy decay mode provides a very clear and distinctive signature of two isolated and highly energetic photons, and is one of the main channels studied at the LHC. Despite the small branching ratio, a reasonably large signal yield can be obtained thanks to the high photon reconstruction and identification efficiency at the ATLAS experiment. Furthermore, due to the excellent photon energy resolution of the ATLAS calorimeter, the signal manifests itself as a narrow peak in the diphoton invariant mass spectrum on top of a smoothly falling irreducible background from QCD production of two photons. +SUSYAnalysis_Search for supersymmetric particles in the two-lepton final state._"Supersymmetry (SUSY) is one of the most studied extensions of the SM. In its minimal form it predicts new fermionic (bosonic) partners of the fundamental SM bosons (fermions) and an additional Higgs doublet. +The focus in this analysis is on the search for direct production of pairs of sleptons, the superpartners of the SM leptons, where each slepton decays directly into the lightest neutralino and the corresponding lepton. A simplified benchmark model is chosen for this search, in which the mass of the slepton and the neutralino are the only free parameters. The predicted cross section for slepton production, each with a mass of 600 GeV, and neutralino mass of 300 GeV is 0.7 fb." +ZPrimeBoostedAnalysis_Search for BSM (Beyond the Standard Model) Z’ boson decay into top-quark pairs in the single-lepton boosted final state._"The searches for new physics phenomena at the LHC are constantly ongoing. As an example, with a mass close to the scale of electroweak symmetry breaking, the top quark, besides having a large coupling to the SM Higgs boson, is predicted to have large couplings to new particles hypothesised in many BSM models. +In the analysis, we focus on implementing the selection criteria of a search for new heavy particles that decay into top-quark pairs in events containing a single charged lepton, large-R jets and missing transverse momentum. A particular benchmark model chosen for this search produces a new gauge boson Z' with a mass of 1 TeV and width of 10 GeV that decays into a tt-pair."