<img src="images/pisa4_logo_transparent.png" width="250">
[](https://github.com/icecube/pisa/actions/workflows/pythonpackage.yml)
[](https://github.com/icecube/pisa/pulls)
[](https://github.com/icecube/pisa/pulse)
[](https://github.com/icecube/pisa/graphs/contributors)
[](https://github.com/icecube/pisa/stargazers)
[Introduction](pisa/README.md) |
[Installation](INSTALL.md) |
[Documentation](https://icecube.github.io/pisa/) |
[Terminology](pisa/glossary.md) |
[Conventions](pisa/general_conventions.md) |
[License](LICENSE)
PISA is a software written to analyze the results (or expected results) of an experiment based on Monte Carlo (MC) simulation.
In particular, PISA was written by and for the IceCube Collaboration for analyses employing the [IceCube Neutrino Observatory](https://icecube.wisc.edu/), including the [DeepCore](https://arxiv.org/abs/1109.6096) and the planned [Upgrade](https://arxiv.org/abs/2307.15295) low-energy in-fill arrays.
> [!NOTE]
> However, any experiment can make use of PISA for analyzing expected and actual results.
PISA was originally developed to cope with low-statistics MC by using parameterizations of the MC and operate on histograms of the data rather than directly reweighting the MC. However, PISA's methods apply equally well to high-MC situations, and PISA also performs traditional reweighted-MC analysis as well.
If you use PISA, please cite our publication ([e-Print available here](https://arxiv.org/abs/1803.05390)):
```
Computational Techniques for the Analysis of Small Signals
in High-Statistics Neutrino Oscillation Experiments
IceCube Collaboration - M.G. Aartsen et al.
Mar 14, 2018
Published in: Nucl.Instrum.Meth.A 977 (2020) 164332
```
# Quick start
## Installation
For quick-start and detailed installation instructions see [Installation](INSTALL.md).
## Minimal Example
Producing some oscillograms
```python
from pisa.core import Pipeline
import matplotlib.pyplot as plt
```
<< PISA is running in single precision (FP32) mode; numba is running on CPU (single core) >>
Instantiate a `Pipeline` or multiple pipelines in a `DistributionMaker` using PISA config files
```python
template_maker = Pipeline("settings/pipeline/osc_example.cfg")
```
Run the pipeline with nominal settings
```python
template_maker.run()
```
Get the oscillation probabilities $P_{\nu_\mu\to\nu_\beta}$
```python
outputs = template_maker.data.get_mapset('prob_mu')
```
Plot some results
```python
fig, axes = plt.subplots(figsize=(18, 5), ncols=3)
outputs['nue_cc'].plot(ax=axes[0], cmap='RdYlBu_r', vmin=0, vmax=1);
outputs['numu_cc'].plot(ax=axes[1], cmap='RdYlBu_r', vmin=0, vmax=1);
outputs['nutau_cc'].plot(ax=axes[2], cmap='RdYlBu_r', vmin=0, vmax=1);
```
# Contributions
Contributors are listed specifically [here](CONTRIBUTORS.md), while the used external software is summarized [here](EXTERNAL_ATTRIBUTION.md).
Raw data
{
"_id": null,
"home_page": "http://github.com/icecubeopensource/pisa",
"name": "pisa",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "The IceCube Collaboration",
"author_email": "analysis@icecube.wisc.edu",
"download_url": "https://files.pythonhosted.org/packages/3e/c9/b70fb12c4c1c2e984ee0bb7cac09fd5a8a57b296b38d9c7a39292934c16b/pisa-4.1.4.tar.gz",
"platform": null,
"description": "<img src=\"images/pisa4_logo_transparent.png\" width=\"250\">\n\n[](https://github.com/icecube/pisa/actions/workflows/pythonpackage.yml)\n[](https://github.com/icecube/pisa/pulls)\n[](https://github.com/icecube/pisa/pulse)\n[](https://github.com/icecube/pisa/graphs/contributors)\n[](https://github.com/icecube/pisa/stargazers)\n\n[Introduction](pisa/README.md) |\n[Installation](INSTALL.md) |\n[Documentation](https://icecube.github.io/pisa/) |\n[Terminology](pisa/glossary.md) |\n[Conventions](pisa/general_conventions.md) |\n[License](LICENSE)\n\nPISA is a software written to analyze the results (or expected results) of an experiment based on Monte Carlo (MC) simulation.\n\nIn particular, PISA was written by and for the IceCube Collaboration for analyses employing the [IceCube Neutrino Observatory](https://icecube.wisc.edu/), including the [DeepCore](https://arxiv.org/abs/1109.6096) and the planned [Upgrade](https://arxiv.org/abs/2307.15295) low-energy in-fill arrays.\n\n> [!NOTE]\n> However, any experiment can make use of PISA for analyzing expected and actual results.\n\nPISA was originally developed to cope with low-statistics MC by using parameterizations of the MC and operate on histograms of the data rather than directly reweighting the MC. However, PISA's methods apply equally well to high-MC situations, and PISA also performs traditional reweighted-MC analysis as well.\n\nIf you use PISA, please cite our publication ([e-Print available here](https://arxiv.org/abs/1803.05390)):\n```\nComputational Techniques for the Analysis of Small Signals\nin High-Statistics Neutrino Oscillation Experiments\nIceCube Collaboration - M.G. Aartsen et al.\nMar 14, 2018\nPublished in: Nucl.Instrum.Meth.A 977 (2020) 164332\n```\n\n\n# Quick start\n\n## Installation\n\nFor quick-start and detailed installation instructions see [Installation](INSTALL.md).\n\n## Minimal Example\n\nProducing some oscillograms\n\n\n```python\nfrom pisa.core import Pipeline\nimport matplotlib.pyplot as plt\n```\n\n << PISA is running in single precision (FP32) mode; numba is running on CPU (single core) >>\n\n\nInstantiate a `Pipeline` or multiple pipelines in a `DistributionMaker` using PISA config files\n\n\n```python\ntemplate_maker = Pipeline(\"settings/pipeline/osc_example.cfg\")\n```\n\nRun the pipeline with nominal settings\n\n\n```python\ntemplate_maker.run()\n```\n\nGet the oscillation probabilities $P_{\\nu_\\mu\\to\\nu_\\beta}$\n\n\n```python\noutputs = template_maker.data.get_mapset('prob_mu')\n```\n\nPlot some results\n\n\n```python\nfig, axes = plt.subplots(figsize=(18, 5), ncols=3)\noutputs['nue_cc'].plot(ax=axes[0], cmap='RdYlBu_r', vmin=0, vmax=1);\noutputs['numu_cc'].plot(ax=axes[1], cmap='RdYlBu_r', vmin=0, vmax=1);\noutputs['nutau_cc'].plot(ax=axes[2], cmap='RdYlBu_r', vmin=0, vmax=1);\n```\n\n\n\n\n\n# Contributions\n\nContributors are listed specifically [here](CONTRIBUTORS.md), while the used external software is summarized [here](EXTERNAL_ATTRIBUTION.md).\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Tools for analyzing and drawing statistical conclusions from experimental data",
"version": "4.1.4",
"project_urls": {
"Homepage": "http://github.com/icecubeopensource/pisa"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ec9b70fb12c4c1c2e984ee0bb7cac09fd5a8a57b296b38d9c7a39292934c16b",
"md5": "42735d76ad55ec05a98fbcc61bd513f3",
"sha256": "c13e1b79171942c9375a6033c6c928c9091ec300ea35a44427d3179f8cc672c7"
},
"downloads": -1,
"filename": "pisa-4.1.4.tar.gz",
"has_sig": false,
"md5_digest": "42735d76ad55ec05a98fbcc61bd513f3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 21471070,
"upload_time": "2024-11-26T15:16:35",
"upload_time_iso_8601": "2024-11-26T15:16:35.201479Z",
"url": "https://files.pythonhosted.org/packages/3e/c9/b70fb12c4c1c2e984ee0bb7cac09fd5a8a57b296b38d9c7a39292934c16b/pisa-4.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-26 15:16:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "icecubeopensource",
"github_project": "pisa",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pisa"
}
JSON
