Skip to content

icecube/pisa

Folders and files

NameName
Last commit message
Last commit date
Dec 20, 2024
Sep 24, 2020
Mar 17, 2025
Apr 28, 2023
Mar 13, 2025
Mar 13, 2025
Feb 13, 2025
Dec 5, 2019
Dec 9, 2022
Mar 8, 2018
Sep 24, 2020
Feb 24, 2025
Nov 25, 2024
Feb 21, 2025
Sep 17, 2016
Nov 23, 2024
Sep 24, 2020
Dec 20, 2018
Sep 17, 2016
Feb 21, 2025
Sep 17, 2016

Repository files navigation

Unit Tests Pull Requests Activity Contributors Repo Stars

Introduction | Installation | Documentation | Terminology | Conventions | 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, including the DeepCore and the planned Upgrade 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):

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.

Minimal Example

Producing some oscillograms

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

template_maker = Pipeline("settings/pipeline/osc_example.cfg")

Run the pipeline with nominal settings

template_maker.run()

Get the oscillation probabilities P ν μ ν β

outputs = template_maker.data.get_mapset('prob_mu')

Plot some results

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);

png

Contributions

Contributors are listed specifically here, while the used external software is summarized here.