ma5-expert


Namema5-expert JSON
Version 3.0.4 PyPI version JSON
download
home_pagehttps://github.com/MadAnalysis/ma5_expert
SummaryMadAnalysis 5 interpreter for Expert mode
upload_time2023-01-26 13:24:45
maintainer
docs_urlNone
authorJack Y. Araz
requires_python>=3.8
licenseMIT
keywords physics madanalysis5
VCS
bugtrack_url
requirements numpy
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # MadAnalysis 5 Interpreter For Expert Mode
[![EPJC](https://img.shields.io/static/v1?style=plastic&label=DOI&message=10.1140/epjc/s10052-021-09052-5&color=blue)](https://doi.org/10.1140/epjc/s10052-021-09052-5)
[![arxiv](https://img.shields.io/static/v1?style=plastic&label=arXiv&message=2006.09387&color=brightgreen)](https://arxiv.org/abs/2006.09387)

[![CI](https://github.com/MadAnalysis/ma5_expert/actions/workflows/pytest.yml/badge.svg?style=plastic)](https://github.com/MadAnalysis/ma5_expert/actions/workflows/pytest.yml)

 MadAnalysis 5 output interpreter for expert mode. Parses the cutflow and histogram collections and 
 constructs it with an interactable interface. 

## Installation
`pip install ma5-expert`

## Outline
* [Cutflow Collection](#cutflow-collection)
* [Histogram Collection](#histogram-collection)
* [Integration to Public Analysis Database through MadAnalysis](#integration-to-public-analysis-database-through-madanalysis)
* [Citation](#citation)

Examples can be found in [examples folder](https://github.com/jackaraz/ma5_expert/tree/master/docs/examples).

### Cutflow Collection

 * Parse all the signal regions and construct an object-base, interactable cutflow.
 * Write combined LaTeX tables for different samples.
 * Compare samples and construct validation tables which allow you to calculate the difference of the relative efficiencies for each given sample with respect to a reference sample.
 * Compare signal and background samples and calculate the figure of merit.
 * Possibility to include experimentally available cutflow data and compare it against MadAnalysis 5 cutflow output.
 * Calculate Monte Carlo uncertainty per cut on the fly


* Simple cutflow:

`CutFlowCollection` needs `CutFlows` path of your sample in MadAnalysis 5 Analysis folder.
We provide an ma5 directory in `examples` folder so we will go through and the code using that.
Parsing a cutflow simply requires the path of the `CutFlows` folder and optionally `xsection` [pb], `lumi` [1/fb]
and/or `Nevents`. Note that `xsec` overwrites the number of events option, if provided number of events
are always calculated using the cross section.

```python
import ma5_expert as ma5

sample = ma5.cutflow.Collection(
        "docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Cutflows",
        xsection = 5.689, lumi = 139.
)
```
Here the first input is the path of the `CutFlows` folder and the rest are simply cross section and 
luminosity information. One can see the signal regions by simply printing the `keys` of the `CutFlowCollection` object;
```python
print(sample.SRnames)
# Output: 
# ['SRC_28', 'SRA_M', 'SRA_L', 'SRA_H', 'SRA', 'SRC', 'SRB', 'SRC_26', 'SRC_24', 'SRC_22']
```
Each signal region is accessible through `CutFlowCollection` object. For instance one can get the names of 
the cuts applied in one of the signal regions.
```python
print(sample.SRA.CutNames)
# Output: 
# ['Initial', '$N_{lep} = 0$', '$N_{j} \\geq 6$', '$N_{b} \\geq 4$', 
# '$\\slashed{E}_T > 350$ [GeV]', '$min(\\Delta\\phi(j_{1-4},\\slashed{E}_T))>0.4$ [rad]', 
# '$\\tau^h$ veto', '$p^{b_1}_T > 200$ [GeV]', '$\\Delta R_{max}(b,b)>2.5$', 
# '$\\Delta R_{max-min}(b,b)<2.5$', '$m(h_{cand})>80$ [GeV]', '$m_{eff} > 1$ [TeV]']
```
Or simply print the entire cutflow;
```python
print(sample.SRA)
# Output: 
# * SRA :
#  * Initial :
#   - Number of Entries    : 200000
#   - Number of Events     : 790771.000 ± 0.000(ΔMC)
#   - Cut & Rel Efficiency : 1.000, 1.000
#  * $N_{lep} = 0$ :
#   - Number of Entries    : 156651
#   - Number of Events     : 499908.962 ± 609.064(ΔMC)
#   - Cut & Rel Efficiency : 0.632, 0.632
#  * $N_{j} \geq 6$ :
#   - Number of Entries    : 65546
#   - Number of Events     : 209971.179 ± 362.184(ΔMC)
#   - Cut & Rel Efficiency : 0.266, 0.420
#  * $N_{b} \geq 4$ :
#   - Number of Entries    : 19965
#   - Number of Events     : 63883.202 ± 123.205(ΔMC)
#   - Cut & Rel Efficiency : 0.081, 0.304
#  * $\slashed{E}_T > 350$ [GeV] :
#   - Number of Entries    : 191
#   - Number of Events     : 755.117 ± 1.688(ΔMC)
#   - Cut & Rel Efficiency : 0.001, 0.012
#  * $min(\Delta\phi(j_{1-4},\slashed{E}_T))>0.4$ [rad] :
#   - Number of Entries    : 72
#   - Number of Events     : 284.658 ± 0.636(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 0.377
#  * $\tau^h$ veto :
#   - Number of Entries    : 68
#   - Number of Events     : 268.850 ± 0.601(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 0.944
#  * $p^{b_1}_T > 200$ [GeV] :
#   - Number of Entries    : 33
#   - Number of Events     : 130.474 ± 0.292(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 0.485
#  * $\Delta R_{max}(b,b)>2.5$ :
#   - Number of Entries    : 25
#   - Number of Events     : 98.836 ± 0.221(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 0.758
#  * $\Delta R_{max-min}(b,b)<2.5$ :
#   - Number of Entries    : 25
#   - Number of Events     : 98.836 ± 0.221(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 1.000
#  * $m(h_{cand})>80$ [GeV] :
#   - Number of Entries    : 10
#   - Number of Events     : 39.543 ± 0.088(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 0.400
#  * $m_{eff} > 1$ [TeV] :
#   - Number of Entries    : 10
#   - Number of Events     : 39.543 ± 0.088(ΔMC)
#   - Cut & Rel Efficiency : 0.000, 1.000
```
As can be seen, it shows number of entries (MonteCarlo events), number of events (lumi weighted), 
cut efficiency and relative efficiency. The error in number of events is the MonteCarlo uncertainty.

It is also possible to access practical information 
```python
print(sample.SRA.isAlive)
# Output: True
```
which simply checks the number of entries in the final cut. Hence one can remove the SRs which does
not have any statistics;
```python
alive = sample.get_alive()
print(f"Number of cutflows survived : {len(alive)},\nNames of the cutflows : { ', '.join([x.id for x in alive]) }")
# Output: 
# Number of cutflows survived : 8,
# Names of the cutflows : SRA_M, SRA_L, SRA_H, SRA, SRC, SRB, SRC_24, SRC_22
```
Each cut is accessible through the interface;
```python
fifth = sample.SRA[5]
print(f"Efficiency : {fifth.eff:.3f}, Relative MC efficiency {fifth.mc_rel_eff:.3f}, number of events {fifth.Nevents:.1f}, sum of weights {fifth.sumW:.3f}")
# Output: 
# Efficiency : 0.0004, Relative MC efficiency 0.377, number of events 284.7, sum of weights 0.008
```
One can also construct independent signal regions for sake of comparisson with Ma5 results;
```python
SRA_presel = [319.7,230.5,192.3,87.9,45.1,20.9,19.3,18.2,17.6,15.0,13.7]

ATLAS = ma5.cutflow.Collection() 

ATLAS.addSignalRegion('SRA',   ma5.SRA.CutNames,   SRA_presel+[13.7])
ATLAS.addSignalRegion('SRA_L', ma5.SRA_L.CutNames, SRA_presel+[0.4])
ATLAS.addSignalRegion('SRA_M', ma5.SRA_M.CutNames, SRA_presel+[6.4])
ATLAS.addSignalRegion('SRA_H', ma5.SRA_H.CutNames, SRA_presel+[7.0])
```
where all properties shown above applies to this new object as well.

[back to top](#outline)

### Histogram Collection

* Parse all the histograms available in the `Histos.saf` file into interactable histogram object.

```python
import ma5_expert as ma5

collection = ma5.histogram.Collection(
        "docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Histograms/histos.saf",
        xsection = 5.689, lumi = 139.
)

print(collection)
# Collection of 6 histograms from `examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Histograms/histos.saf`
#    * SRA_Meff: [ nbin: 11, min: 800.00, max: 3000.00 ]
#    * SRA_Mh: [ nbin: 12, min: 0.00, max: 480.00 ]
#    * SRB_PTj1: [ nbin: 9, min: 50.00, max: 950.00 ]
#    * SRB_MhAvg: [ nbin: 16, min: 50.00, max: 450.00 ]
#    * SRC_MET: [ nbin: 13, min: 200.00, max: 1500.00 ]
#    * SRC_Sig: [ nbin: 19, min: 17.00, max: 36.00 ]
```

Extract the plotting information:
```python
xbins, bins, weights = collection.lumi_histogram("SRA_Mh")
plt.hist(xbins, bins=bins, weights=weights)
plt.xlabel("$M_{h}\ {\\rm [GeV]}$")
plt.ylabel("${\\rm Number\ of\ events}$")
plt.xlim([min(bins), max(bins)])
plt.show()
```
<p align="center">
<img src="docs/examples/SRA_Mh.png" alt="SRA_Mh" style="width:400px;"/>
</p>

[back to top](#outline)

### Integration to Public Analysis Database through MadAnalysis 5

`ma5-expert` is capable of running MadAnalysis sub-modules through a backend manager. Desired MadAnalysis 
backend can be set via
```python
import ma5_expert as ma5
ma5.BackendManager.set_madanalysis_backend("/PATH/TO/MADANALYSIS5")
```
This will initiate the MadAnalysis backend to be used. Then one can use the reinterpretation tools such as 
exclusion limit computation, externally. One can initiate PAD interface via
```python
interface = ma5.pad.PADInterface(
    sample_path="ma5_expert/docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689",
    dataset_name="defaultset"
)
```
where `sample_path` is the main location of the analysis which has been held, and `dataset_name` is the name
of the dataset which corresponds to the particular folder name under `sample_path + /Outputs/SAF/`. Then results
can be computed via
```python
results = interface.compute_exclusion("atlas_susy_2018_31", 5.689, ma5.backend.PADType.PADForSFS)
```
Note that the given example only computes for `atlas_susy_2018_31` and this analysis has been held under `PADForSFS`
which is indicated via `PADType`. This simply tells function where to look to find corresponding info file, which 
assumes that `PADForSFS` has been installed. The value `5.689` sets the cross section in pb. 

[back to top](#outline)

### Citation 
Developed for [arXiv:2006.09387](http://arxiv.org/abs/2006.09387)

```bibtex
@article{Araz:2020lnp,
    author = "Araz, Jack Y. and Fuks, Benjamin and Polykratis, Georgios",
    title = "{Simplified fast detector simulation in MADANALYSIS 5}",
    eprint = "2006.09387",
    archivePrefix = "arXiv",
    primaryClass = "hep-ph",
    doi = "10.1140/epjc/s10052-021-09052-5",
    journal = "Eur. Phys. J. C",
    volume = "81",
    number = "4",
    pages = "329",
    year = "2021"
}
```

[back to top](#outline)
## TODO

- [ ] Overall Ma5 Analysis parser

- [ ] Add theoretical uncertainties

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/MadAnalysis/ma5_expert",
    "name": "ma5-expert",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "physics madanalysis5",
    "author": "Jack Y. Araz",
    "author_email": "jack.araz@durham.ac.uk",
    "download_url": "https://files.pythonhosted.org/packages/d4/18/d1b0f8a5b2f1c983463106c608a6d37e496cd6a04f4b50f54dd38bf948b1/ma5_expert-3.0.4.tar.gz",
    "platform": null,
    "description": "# MadAnalysis 5 Interpreter For Expert Mode\n[![EPJC](https://img.shields.io/static/v1?style=plastic&label=DOI&message=10.1140/epjc/s10052-021-09052-5&color=blue)](https://doi.org/10.1140/epjc/s10052-021-09052-5)\n[![arxiv](https://img.shields.io/static/v1?style=plastic&label=arXiv&message=2006.09387&color=brightgreen)](https://arxiv.org/abs/2006.09387)\n\n[![CI](https://github.com/MadAnalysis/ma5_expert/actions/workflows/pytest.yml/badge.svg?style=plastic)](https://github.com/MadAnalysis/ma5_expert/actions/workflows/pytest.yml)\n\n MadAnalysis 5 output interpreter for expert mode. Parses the cutflow and histogram collections and \n constructs it with an interactable interface. \n\n## Installation\n`pip install ma5-expert`\n\n## Outline\n* [Cutflow Collection](#cutflow-collection)\n* [Histogram Collection](#histogram-collection)\n* [Integration to Public Analysis Database through MadAnalysis](#integration-to-public-analysis-database-through-madanalysis)\n* [Citation](#citation)\n\nExamples can be found in [examples folder](https://github.com/jackaraz/ma5_expert/tree/master/docs/examples).\n\n### Cutflow Collection\n\n * Parse all the signal regions and construct an object-base, interactable cutflow.\n * Write combined LaTeX tables for different samples.\n * Compare samples and construct validation tables which allow you to calculate the difference of the relative efficiencies for each given sample with respect to a reference sample.\n * Compare signal and background samples and calculate the figure of merit.\n * Possibility to include experimentally available cutflow data and compare it against MadAnalysis 5 cutflow output.\n * Calculate Monte Carlo uncertainty per cut on the fly\n\n\n* Simple cutflow:\n\n`CutFlowCollection` needs `CutFlows` path of your sample in MadAnalysis 5 Analysis folder.\nWe provide an ma5 directory in `examples` folder so we will go through and the code using that.\nParsing a cutflow simply requires the path of the `CutFlows` folder and optionally `xsection` [pb], `lumi` [1/fb]\nand/or `Nevents`. Note that `xsec` overwrites the number of events option, if provided number of events\nare always calculated using the cross section.\n\n```python\nimport ma5_expert as ma5\n\nsample = ma5.cutflow.Collection(\n        \"docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Cutflows\",\n        xsection = 5.689, lumi = 139.\n)\n```\nHere the first input is the path of the `CutFlows` folder and the rest are simply cross section and \nluminosity information. One can see the signal regions by simply printing the `keys` of the `CutFlowCollection` object;\n```python\nprint(sample.SRnames)\n# Output: \n# ['SRC_28', 'SRA_M', 'SRA_L', 'SRA_H', 'SRA', 'SRC', 'SRB', 'SRC_26', 'SRC_24', 'SRC_22']\n```\nEach signal region is accessible through `CutFlowCollection` object. For instance one can get the names of \nthe cuts applied in one of the signal regions.\n```python\nprint(sample.SRA.CutNames)\n# Output: \n# ['Initial', '$N_{lep} = 0$', '$N_{j} \\\\geq 6$', '$N_{b} \\\\geq 4$', \n# '$\\\\slashed{E}_T > 350$ [GeV]', '$min(\\\\Delta\\\\phi(j_{1-4},\\\\slashed{E}_T))>0.4$ [rad]', \n# '$\\\\tau^h$ veto', '$p^{b_1}_T > 200$ [GeV]', '$\\\\Delta R_{max}(b,b)>2.5$', \n# '$\\\\Delta R_{max-min}(b,b)<2.5$', '$m(h_{cand})>80$ [GeV]', '$m_{eff} > 1$ [TeV]']\n```\nOr simply print the entire cutflow;\n```python\nprint(sample.SRA)\n# Output: \n# * SRA :\n#  * Initial :\n#   - Number of Entries    : 200000\n#   - Number of Events     : 790771.000 \u00b1 0.000(\u0394MC)\n#   - Cut & Rel Efficiency : 1.000, 1.000\n#  * $N_{lep} = 0$ :\n#   - Number of Entries    : 156651\n#   - Number of Events     : 499908.962 \u00b1 609.064(\u0394MC)\n#   - Cut & Rel Efficiency : 0.632, 0.632\n#  * $N_{j} \\geq 6$ :\n#   - Number of Entries    : 65546\n#   - Number of Events     : 209971.179 \u00b1 362.184(\u0394MC)\n#   - Cut & Rel Efficiency : 0.266, 0.420\n#  * $N_{b} \\geq 4$ :\n#   - Number of Entries    : 19965\n#   - Number of Events     : 63883.202 \u00b1 123.205(\u0394MC)\n#   - Cut & Rel Efficiency : 0.081, 0.304\n#  * $\\slashed{E}_T > 350$ [GeV] :\n#   - Number of Entries    : 191\n#   - Number of Events     : 755.117 \u00b1 1.688(\u0394MC)\n#   - Cut & Rel Efficiency : 0.001, 0.012\n#  * $min(\\Delta\\phi(j_{1-4},\\slashed{E}_T))>0.4$ [rad] :\n#   - Number of Entries    : 72\n#   - Number of Events     : 284.658 \u00b1 0.636(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 0.377\n#  * $\\tau^h$ veto :\n#   - Number of Entries    : 68\n#   - Number of Events     : 268.850 \u00b1 0.601(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 0.944\n#  * $p^{b_1}_T > 200$ [GeV] :\n#   - Number of Entries    : 33\n#   - Number of Events     : 130.474 \u00b1 0.292(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 0.485\n#  * $\\Delta R_{max}(b,b)>2.5$ :\n#   - Number of Entries    : 25\n#   - Number of Events     : 98.836 \u00b1 0.221(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 0.758\n#  * $\\Delta R_{max-min}(b,b)<2.5$ :\n#   - Number of Entries    : 25\n#   - Number of Events     : 98.836 \u00b1 0.221(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 1.000\n#  * $m(h_{cand})>80$ [GeV] :\n#   - Number of Entries    : 10\n#   - Number of Events     : 39.543 \u00b1 0.088(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 0.400\n#  * $m_{eff} > 1$ [TeV] :\n#   - Number of Entries    : 10\n#   - Number of Events     : 39.543 \u00b1 0.088(\u0394MC)\n#   - Cut & Rel Efficiency : 0.000, 1.000\n```\nAs can be seen, it shows number of entries (MonteCarlo events), number of events (lumi weighted), \ncut efficiency and relative efficiency. The error in number of events is the MonteCarlo uncertainty.\n\nIt is also possible to access practical information \n```python\nprint(sample.SRA.isAlive)\n# Output: True\n```\nwhich simply checks the number of entries in the final cut. Hence one can remove the SRs which does\nnot have any statistics;\n```python\nalive = sample.get_alive()\nprint(f\"Number of cutflows survived : {len(alive)},\\nNames of the cutflows : { ', '.join([x.id for x in alive]) }\")\n# Output: \n# Number of cutflows survived : 8,\n# Names of the cutflows : SRA_M, SRA_L, SRA_H, SRA, SRC, SRB, SRC_24, SRC_22\n```\nEach cut is accessible through the interface;\n```python\nfifth = sample.SRA[5]\nprint(f\"Efficiency : {fifth.eff:.3f}, Relative MC efficiency {fifth.mc_rel_eff:.3f}, number of events {fifth.Nevents:.1f}, sum of weights {fifth.sumW:.3f}\")\n# Output: \n# Efficiency : 0.0004, Relative MC efficiency 0.377, number of events 284.7, sum of weights 0.008\n```\nOne can also construct independent signal regions for sake of comparisson with Ma5 results;\n```python\nSRA_presel = [319.7,230.5,192.3,87.9,45.1,20.9,19.3,18.2,17.6,15.0,13.7]\n\nATLAS = ma5.cutflow.Collection() \n\nATLAS.addSignalRegion('SRA',   ma5.SRA.CutNames,   SRA_presel+[13.7])\nATLAS.addSignalRegion('SRA_L', ma5.SRA_L.CutNames, SRA_presel+[0.4])\nATLAS.addSignalRegion('SRA_M', ma5.SRA_M.CutNames, SRA_presel+[6.4])\nATLAS.addSignalRegion('SRA_H', ma5.SRA_H.CutNames, SRA_presel+[7.0])\n```\nwhere all properties shown above applies to this new object as well.\n\n[back to top](#outline)\n\n### Histogram Collection\n\n* Parse all the histograms available in the `Histos.saf` file into interactable histogram object.\n\n```python\nimport ma5_expert as ma5\n\ncollection = ma5.histogram.Collection(\n        \"docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Histograms/histos.saf\",\n        xsection = 5.689, lumi = 139.\n)\n\nprint(collection)\n# Collection of 6 histograms from `examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689/Output/SAF/defaultset/atlas_susy_2018_31/Histograms/histos.saf`\n#    * SRA_Meff: [ nbin: 11, min: 800.00, max: 3000.00 ]\n#    * SRA_Mh: [ nbin: 12, min: 0.00, max: 480.00 ]\n#    * SRB_PTj1: [ nbin: 9, min: 50.00, max: 950.00 ]\n#    * SRB_MhAvg: [ nbin: 16, min: 50.00, max: 450.00 ]\n#    * SRC_MET: [ nbin: 13, min: 200.00, max: 1500.00 ]\n#    * SRC_Sig: [ nbin: 19, min: 17.00, max: 36.00 ]\n```\n\nExtract the plotting information:\n```python\nxbins, bins, weights = collection.lumi_histogram(\"SRA_Mh\")\nplt.hist(xbins, bins=bins, weights=weights)\nplt.xlabel(\"$M_{h}\\ {\\\\rm [GeV]}$\")\nplt.ylabel(\"${\\\\rm Number\\ of\\ events}$\")\nplt.xlim([min(bins), max(bins)])\nplt.show()\n```\n<p align=\"center\">\n<img src=\"docs/examples/SRA_Mh.png\" alt=\"SRA_Mh\" style=\"width:400px;\"/>\n</p>\n\n[back to top](#outline)\n\n### Integration to Public Analysis Database through MadAnalysis 5\n\n`ma5-expert` is capable of running MadAnalysis sub-modules through a backend manager. Desired MadAnalysis \nbackend can be set via\n```python\nimport ma5_expert as ma5\nma5.BackendManager.set_madanalysis_backend(\"/PATH/TO/MADANALYSIS5\")\n```\nThis will initiate the MadAnalysis backend to be used. Then one can use the reinterpretation tools such as \nexclusion limit computation, externally. One can initiate PAD interface via\n```python\ninterface = ma5.pad.PADInterface(\n    sample_path=\"ma5_expert/docs/examples/mass1000005_300.0_mass1000022_60.0_mass1000023_250.0_xs_5.689\",\n    dataset_name=\"defaultset\"\n)\n```\nwhere `sample_path` is the main location of the analysis which has been held, and `dataset_name` is the name\nof the dataset which corresponds to the particular folder name under `sample_path + /Outputs/SAF/`. Then results\ncan be computed via\n```python\nresults = interface.compute_exclusion(\"atlas_susy_2018_31\", 5.689, ma5.backend.PADType.PADForSFS)\n```\nNote that the given example only computes for `atlas_susy_2018_31` and this analysis has been held under `PADForSFS`\nwhich is indicated via `PADType`. This simply tells function where to look to find corresponding info file, which \nassumes that `PADForSFS` has been installed. The value `5.689` sets the cross section in pb. \n\n[back to top](#outline)\n\n### Citation \nDeveloped for [arXiv:2006.09387](http://arxiv.org/abs/2006.09387)\n\n```bibtex\n@article{Araz:2020lnp,\n    author = \"Araz, Jack Y. and Fuks, Benjamin and Polykratis, Georgios\",\n    title = \"{Simplified fast detector simulation in MADANALYSIS 5}\",\n    eprint = \"2006.09387\",\n    archivePrefix = \"arXiv\",\n    primaryClass = \"hep-ph\",\n    doi = \"10.1140/epjc/s10052-021-09052-5\",\n    journal = \"Eur. Phys. J. C\",\n    volume = \"81\",\n    number = \"4\",\n    pages = \"329\",\n    year = \"2021\"\n}\n```\n\n[back to top](#outline)\n## TODO\n\n- [ ] Overall Ma5 Analysis parser\n\n- [ ] Add theoretical uncertainties\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MadAnalysis 5 interpreter for Expert mode",
    "version": "3.0.4",
    "split_keywords": [
        "physics",
        "madanalysis5"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "04d123f4b09a610b5584ef70256580444a4c37c9cb557c676b4bae32618880ea",
                "md5": "2c0714d4cc6179bc480ddadc0d7f3081",
                "sha256": "e209c85c80266ab98c9258846d746405763005a23505e29863ed319e13ad559c"
            },
            "downloads": -1,
            "filename": "ma5_expert-3.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2c0714d4cc6179bc480ddadc0d7f3081",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 29677,
            "upload_time": "2023-01-26T13:24:43",
            "upload_time_iso_8601": "2023-01-26T13:24:43.846364Z",
            "url": "https://files.pythonhosted.org/packages/04/d1/23f4b09a610b5584ef70256580444a4c37c9cb557c676b4bae32618880ea/ma5_expert-3.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d418d1b0f8a5b2f1c983463106c608a6d37e496cd6a04f4b50f54dd38bf948b1",
                "md5": "c4ca95842e765d4bd3a3ecd39f6cd3f0",
                "sha256": "3ca5154f41bf0f312be73b51e72722a954549026c6612f24437f91d706fb8dcf"
            },
            "downloads": -1,
            "filename": "ma5_expert-3.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "c4ca95842e765d4bd3a3ecd39f6cd3f0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 28680,
            "upload_time": "2023-01-26T13:24:45",
            "upload_time_iso_8601": "2023-01-26T13:24:45.366792Z",
            "url": "https://files.pythonhosted.org/packages/d4/18/d1b0f8a5b2f1c983463106c608a6d37e496cd6a04f4b50f54dd38bf948b1/ma5_expert-3.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-01-26 13:24:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "MadAnalysis",
    "github_project": "ma5_expert",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.21.6"
                ]
            ]
        }
    ],
    "lcname": "ma5-expert"
}
        
Elapsed time: 0.03300s