| 11 | | The current (soon to be released) version of !MadAnalysis 5 is [https://launchpad.net/madanalysis5/trunk/v1.7/+download/ma5_v1.8.44.tgz version 1.8]. In order to use all analyses implement in the PAD, one needs to install both the Delphes and DelphesMA5tune detector simulators and the library of analyses shown below. To this aim, once !MadAnalysis 5 has been installed and started, it is sufficient to type: |
| | 11 | The current version of !MadAnalysis 5 is [https://launchpad.net/madanalysis5/trunk/v1.8/+download/MadAnalysis5_v1.8_patch1.tgz version 1.8]. One of the analyses below however requires a newer version, v1.9.4 (or more recent) that can be obtained [https://code.launchpad.net/~ma5dev/madanalysis5/v1.9_beta from LaunchPad]. |
| | 12 | |
| | 13 | In order to use the analyses implemented in the PAD, one needs to install a detector simulator and the corresponding library of recast analyses. Three options are available. |
| | 14 | - The simulation of the detector response can be dealt with Delphes 3. The PAD installation can be achieved by typing `install delphes; install PAD` in the !MadAnalysis 5 shell, and by then restarting the program. This setup concerns most run 2 analyses currently implemented. |
| | 15 | - The simulation of the detector response can be dealt with the SFS infrastructure relying on smearing and efficiency functions. The PAD installation can here be achieved by typing `install fastjet; install PADForSFS` in the !MadAnalysis 5 shell, and by then restarting the program. For now, this alternative to Delphes 3 is rather new and only few analyses use it. |
| | 16 | - The simulation of the detector response can be dealt with the MA5tune of Delphes 3 that is relevant for a good number of run 1 analyses. The PAD installation can be achieved by typing `install delphesMA5tune; install PADForMA5tune` in the !MadAnalysis 5 shell, and by then restarting the program. |
| | 17 | |
| | 18 | Although we have various options for taking care of the detector simulation (SFS, Delphes and DelphesMA5tune), we recommend, when developing a new recasting code, to use the latest MA5 version linked to either the SFS framework, or the standard Delphes 3. The implementation of a new analysis is detailed in [http://arxiv.org/abs/1808.00480 arXiv:1808.00480], as well as [http://madanalysis.irmp.ucl.ac.be/wiki/SFS here] for what concerns the SFS. In a nutshell, new analyses (within the PAD or separately) can be added by running the script `newAnalyzer.py` (located in `PAD/Build/SampleAnalyzer`), passing as an argument the name of the analysis of interest. For instance, |
| 18 | | and restart !MadAnalysis 5. Detailed information on the older way of running (with MadAnalysis5 version 1.2) can be found [https://madanalysis.irmp.ucl.ac.be/wiki/Ma5PadStepByStep here]. |
| | 22 | will create and modify the necessary files for adding the analysis named cms_sus_14_001. In particular, a pair of header and source C++ files cms_sus_14_001.cpp and cms_sus_14_001.h is now available in the sub-directory `PAD/Build/SampleAnalyzer/User/Analyzer`. We can now either implement the analysis on our own, or replace the newly created files with those shared by somebody else (or downloaded from the list below in case the automatic PAD installation introduced above is not used). |
| | 23 | |
| | 24 | ''We strongly encourage users to publish their re-implemented LHC analyses on the [https://dataverse.uclouvain.be/dataverse/madanalysis MadAnalysis 5 dataverse].'' This way they become individually citable. Please send us an email to get your recast code added to the dataverse and to the PAD. Recommendations regarding the proper validation are given in [http://arxiv.org/abs/1407.3278 arXiv:1407.3278] and [http://arxiv.org/abs/1808.00480 arXiv:1808.00480]. Note that for every analysis that is part of the PAD, a detailed validation note is required. |
| | 25 | |
| | 26 | For any information on the implementation of an analysis, on the database or on the expert mode of the program, please visit the 'Answers' section of our [https://launchpad.net/madanalysis5 LaunchPad page]. |
| 33 | | to provide the recasting card directly. The output directory contains the events of the store_root option has been set to True, as well as the CLs an efficiency information for each signal region of each of the selected analyses. The cross section excluded at the 95% CL by each region is also provided as additional information. |
| 34 | | |
| 35 | | ---- |
| 36 | | |
| 37 | | Although we have two options for taking care of the detector simulation (delphes and delphesMA5tune), we recommend, when developing a new recasting code, to use the latest MA5 version linked to the standard Delphes3. The implementation of a new analysis is detailed in [http://arxiv.org/abs/1808.00480 arXiv:1808.00480]. In a nutshell, new analyses (within the PAD or separately) can be added by running the script newAnalyzer.py (located in PAD/Build/SampleAnalyzer), passing as an argument the name of the analysis of interest. For instance, |
| 38 | | {{{ |
| 39 | | python newAnalyzer.py cms_sus_14_001 |
| 40 | | }}} |
| 41 | | will create and modify the necessary files for adding the analysis named cms_sus_14_001. In particular, a pair of header and source C++ files cms_sus_14_001.cpp and cms_sus_14_001.h is now available in the sub-directory PAD/Build/SampleAnalyzer/User/Analyzer. One can now either implement the analysis on our own, or replace the newly created files with those shared by somebody else (or downloaded from the list below in case automatic PAD installation introducesd above is not used). |
| 42 | | |
| 43 | | ''We strongly encourage users to publish their re-implemented LHC analyses via [https://inspirehep.net/help/data-submission?ln=en Inspire].'' This way they become individually citable. (Send us an email with the Inspire link to integrate your analysis in the PAD.) Recommendations regarding the proper validation are given in [http://arxiv.org/abs/1407.3278 arXiv:1407.3278] and [http://arxiv.org/abs/1808.00480 arXiv:1808.00480]. Note that for every analysis that is part of the PAD, a detailed validation note is required. |
| 44 | | |
| 45 | | For any information on the implementation of an analysis, on the database or on the expert mode of the program, please visit the 'Answers' section of our [https://launchpad.net/madanalysis5 launchpad page]. |
| | 41 | to provide the recasting card directly. The output directory contains event samples after detector simulation if the `store_root` option has been set to `True`, as well as exclusions (1-CLs) and efficiency information for each signal region of each of the selected analyses. The cross section excluded at the 95% CL for each region is also provided as additional information. |
