Changelog

4.3a1

Released on 2026-06-12 - GitHub

Pre-release for PISA 4.3.

Tip

A Docker image with PISA 4.3a1 pre-installed is available via docker pull ghcr.io/icecube/pisa:4.3a1.

• The virtual environment (Python 3.14.6) is located at /.venv.

• A .txt file containing all the installed packages in requirements format is provided among the release assets at the bottom (usage comments therein).

Important

This release is likely to require adapted pipeline configurations, because representations supported by Stages are now handled more strictly at the framework level.

Also, the (legacy) interface Analysis.fit_hypo() has been removed in favour of Analysis.fit_recursively().

What’s Changed

New Features

• Make VarBinning accept cut variables that are simultaneously part of a MultiDimBinning by @thehrh in https://github.com/icecube/pisa/pull/851

• Merging minor changes developed as part of the oscNext DynEdge analysis development by @ts4051 in https://github.com/icecube/pisa/pull/861

• Decouple DIS sys by @ts4051 in https://github.com/icecube/pisa/pull/865

• Ultrasurfaces service: add option of only looking up gradients from neighbours among original (classification) event groupings by @thehrh in https://github.com/icecube/pisa/pull/864

• Add Dockerfile by @JanWeldert in https://github.com/icecube/pisa/pull/857

• add charm correction stage and file with correction by @marialiubarska in https://github.com/icecube/pisa/pull/856

• Fix pipeline._get_outputs function for given output binning by @JanWeldert in https://github.com/icecube/pisa/pull/872

• Update csv data loader, introduce dedicated csv hypersurfaces service, clean up hypersurfaces docs by @JanWeldert in https://github.com/icecube/pisa/pull/855

• Update artificial PID changes by @JanWeldert in https://github.com/icecube/pisa/pull/884

• Adding the possibility to choose the calibration file that daemonflux… by @jpyanez in https://github.com/icecube/pisa/pull/885

• make CSV loader compatible with older data releases by @philippeller in https://github.com/icecube/pisa/pull/887

• Introduce option to use NLO CC matter potential in prob3 and document various physics options by @thehrh in https://github.com/icecube/pisa/pull/886

• Detector systematics through snowstorm split and hist stage by @JanWeldert in https://github.com/icecube/pisa/pull/893

• Add fast workflow for building PISA docker image and publishing to GitHub packages by @thehrh in https://github.com/icecube/pisa/pull/919

• Share pipeline output binning through new ContainerSet global auxiliary data (+ related changes) by @JanWeldert in https://github.com/icecube/pisa/pull/914

• Overhaul sphinx docs by @thehrh in https://github.com/icecube/pisa/pull/920

• Re-introduce true Poissonian log-likelihood as “poisson_llh” metric by @thehrh in https://github.com/icecube/pisa/pull/924

• Compatibility with Python 3.13 and 3.14 by @thehrh in https://github.com/icecube/pisa/pull/922

• pisa.core.container module documentation by @thehrh in https://github.com/icecube/pisa/pull/935

• Tolerances for snowstorm additional params by @JanWeldert in https://github.com/icecube/pisa/pull/936

• Granular control of PISA fast-histogram threading and more robust numba thread setup by @thehrh in https://github.com/icecube/pisa/pull/939

• Refactor analysis package by @thehrh in https://github.com/icecube/pisa/pull/916

• stages.flux.daemon_flux module improvements (documentation, speed-up option) and pipeline run duration benchmarking by @thehrh in https://github.com/icecube/pisa/pull/930

• Refactor write_benchmark_json to comply with github-action-benchmark format and ensure time series creation by @thehrh in https://github.com/icecube/pisa/pull/948

• Update data representation management at stage and pipeline level and fix service docs by @thehrh in https://github.com/icecube/pisa/pull/934

• Configuration file for auto-generated changelog by @thehrh in https://github.com/icecube/pisa/pull/952

• Fetch git tags when checking out repository in actions by @thehrh in https://github.com/icecube/pisa/pull/953

Bug Fixes

• remove setuptools and pip caps in setup.py by @thehrh in https://github.com/icecube/pisa/pull/858

• Fix script for adding fluxes to events files by @thehrh in https://github.com/icecube/pisa/pull/867

• Fix ultrasurfaces in event-grouping mode and improve debug output by @thehrh in https://github.com/icecube/pisa/pull/873

• Improved parameter handling of Map.plot() and fixed various issues by @bleaktwig in https://github.com/icecube/pisa/pull/874

• Update daemon_flux.py by @jpyanez in https://github.com/icecube/pisa/pull/879

• Catch exception and log error message in vbwkde unit tests by @marialiubarska in https://github.com/icecube/pisa/pull/882

• Three little changes by @JanWeldert in https://github.com/icecube/pisa/pull/891

• generalized_llh_params service: assign 0th and only element to beta & trad_alpha instead of length-1 array by @thehrh in https://github.com/icecube/pisa/pull/912

• Fix inconsistent densities as a result of repeated changes of electron fractions in prob3 by @thehrh in https://github.com/icecube/pisa/pull/925

• Move detectors params handling completely in detectors class by @JanWeldert in https://github.com/icecube/pisa/pull/947

Other Changes

• Remove global statements to fix new flake8 f824 error by @thehrh in https://github.com/icecube/pisa/pull/853

• Remove cap and explicit pip install from workflow by @thehrh in https://github.com/icecube/pisa/pull/859

• rerun daemonflux example notebook by @marialiubarska in https://github.com/icecube/pisa/pull/883

• Inconsistent treatment of metrics in pisa.core.map.Map and MapSet by @bleaktwig in https://github.com/icecube/pisa/pull/881

• remove randomness from hypersurface unit test by @thehrh in https://github.com/icecube/pisa/pull/892

• update pylintrc file: generate minimal version from existing configuration by @thehrh in https://github.com/icecube/pisa/pull/889

• Remove old pisa.utils.tests module by @thehrh in https://github.com/icecube/pisa/pull/908

• Pipeline config parser: in absence of prior on parameter, create ufloat with std_dev of NaN, not 0 by @thehrh in https://github.com/icecube/pisa/pull/918

• Update Python version to 3.14 in Dockerfile by @thehrh in https://github.com/icecube/pisa/pull/937

• Run docker-image workflow in response to “published” activity type by @thehrh in https://github.com/icecube/pisa/pull/938

• ftype and format for range by @JanWeldert in https://github.com/icecube/pisa/pull/944

• Remove service data.simple_signal along with associated example pipeline and coverage test script by @thehrh in https://github.com/icecube/pisa/pull/945

• Add concurrency groups for (relevant) workflows to cancel existing run when new one starts and group dependabot actions updates by @thehrh in https://github.com/icecube/pisa/pull/950

• Remove YAPF config file by @thehrh in https://github.com/icecube/pisa/pull/949

• Remove upper python version cap in python_requires keyword to setuptools.setup() by @thehrh in https://github.com/icecube/pisa/pull/951

• Re-synchronise main readme with jupyter notebook generating it and apply some small improvements by @thehrh in https://github.com/icecube/pisa/pull/954

Dependencies

• update actions to latest release versions by @thehrh in https://github.com/icecube/pisa/pull/888

• Add Dependabot configuration (pip + github-actions) by @thehrh in https://github.com/icecube/pisa/pull/895

• Update cython, simplejson, scikit-learn by @thehrh in https://github.com/icecube/pisa/pull/899

• Update numpy, pint, python, scipy, versioneer by @thehrh in https://github.com/icecube/pisa/pull/903

• Remove setuptools cap in build-time dependencies by @thehrh in https://github.com/icecube/pisa/pull/909

• Bump docker/login-action from 4.0.0 to 4.1.0 in /.github/workflows by @dependabot[bot] in https://github.com/icecube/pisa/pull/921

• Bump docker/build-push-action from 7.0.0 to 7.1.0 in /.github/workflows by @dependabot[bot] in https://github.com/icecube/pisa/pull/926

• Compatibility fixes for simplejson v4 by @thehrh in https://github.com/icecube/pisa/pull/928

• Bump docker/metadata-action from 6.0.0 to 6.1.0 in /.github/workflows by @dependabot[bot] in https://github.com/icecube/pisa/pull/942

• Bump docker/build-push-action from 7.1.0 to 7.2.0 in /.github/workflows by @dependabot[bot] in https://github.com/icecube/pisa/pull/941

• Bump docker/login-action from 4.1.0 to 4.2.0 in /.github/workflows by @dependabot[bot] in https://github.com/icecube/pisa/pull/940

New Contributors

• @bleaktwig made their first contribution in https://github.com/icecube/pisa/pull/874

• @jpyanez made their first contribution in https://github.com/icecube/pisa/pull/879

• @dependabot[bot] made their first contribution in https://github.com/icecube/pisa/pull/921

Full Changelog: https://github.com/icecube/pisa/compare/4.2…4.3a1

4.2

Released on 2025-03-18 - GitHub

Last release before necessary dependency and Python version updates.

Included are many bug fixes, cleanups, and documentation improvements, as well as several new physics capabilities, analysis options, and framework enhancements.

What’s Changed

• Fix Etot bug and add comments for clarity. by @LeanderFischer in https://github.com/icecube/pisa/pull/741

• fixed small bug in fit_scipy by @BenSmithers in https://github.com/icecube/pisa/pull/742

• Derived Parameters in CFG files by @BenSmithers in https://github.com/icecube/pisa/pull/729

• Detector class bug fixes by @JanWeldert in https://github.com/icecube/pisa/pull/743

• Update README.md by @LeanderFischer in https://github.com/icecube/pisa/pull/744

• Fix dependencies and README by @LeanderFischer in https://github.com/icecube/pisa/pull/746

• Deprecate argument by @LeanderFischer in https://github.com/icecube/pisa/pull/745

• Add densitiy scale by @JanWeldert in https://github.com/icecube/pisa/pull/747

• Bump python version by @LeanderFischer in https://github.com/icecube/pisa/pull/752

• Implement Neutrino decay in PISA (Prob3) by @anilak41 in https://github.com/icecube/pisa/pull/748

• Fix dependencies and update install instructions by @LeanderFischer in https://github.com/icecube/pisa/pull/753

• Clarify that poissonLLH in likelihood_functions.py does not take into… by @finnmayhew in https://github.com/icecube/pisa/pull/755

• Re-shaped the mod_chi2’s return to match the input shape by @JKrishnamoorthi in https://github.com/icecube/pisa/pull/760

• adding DAEMONFLUX stage by @marialiubarska in https://github.com/icecube/pisa/pull/761

• Updated local installation instruction by @JKrishnamoorthi in https://github.com/icecube/pisa/pull/763

• Addition of LRI potential by @ggarg07 in https://github.com/icecube/pisa/pull/762

• Addition of density as a free parameter for tomography by @sc458930 in https://github.com/icecube/pisa/pull/764

• Take into account covariance matrix for daemonflux parameters by @marialiubarska in https://github.com/icecube/pisa/pull/766

• Update README.md by @LeanderFischer in https://github.com/icecube/pisa/pull/767

• Update INSTALL.md by @LeanderFischer in https://github.com/icecube/pisa/pull/768

• Update doc files and set up docu workflow to deploy sphinx to gh pages. by @LeanderFischer in https://github.com/icecube/pisa/pull/769

• basic example code to get event wise information by @JKrishnamoorthi in https://github.com/icecube/pisa/pull/765

• Update README.md by @LeanderFischer in https://github.com/icecube/pisa/pull/772

• Update fix_error.py description by @finnmayhew in https://github.com/icecube/pisa/pull/776

• Deprecate duplicated prior functions by @JanWeldert in https://github.com/icecube/pisa/pull/773

• Stage and pipeline related documentation touch ups by @thehrh in https://github.com/icecube/pisa/pull/780

• Update README.md by @LeanderFischer in https://github.com/icecube/pisa/pull/781

• adding stage for external osc calc by @philippeller in https://github.com/icecube/pisa/pull/756

• fix plotting 2d arrays (not caught by unit tests) by @thehrh in https://github.com/icecube/pisa/pull/783

• Remove unimplemented analytical NSI matrix calculation from nsi_param… by @finnmayhew in https://github.com/icecube/pisa/pull/786

• Finally fix map.plot, to be actually usable.. by @LeanderFischer in https://github.com/icecube/pisa/pull/787

• Update significantly outdated documentation of global constants by @thehrh in https://github.com/icecube/pisa/pull/789

• Fix doubly defined report_profile method in stage.py + minor touch-ups by @thehrh in https://github.com/icecube/pisa/pull/791

• Make event cutting for EventsPi work also when at least one variable name is conta… by @thehrh in https://github.com/icecube/pisa/pull/792

• Apply obvious outstanding fixes to simple_signal and generalized_llh_params services by @thehrh in https://github.com/icecube/pisa/pull/793

• Apply small fixes to (mostly) docstrings of config_parser module and extend unit test by @thehrh in https://github.com/icecube/pisa/pull/794

• Fix broken links in general conventions guide by @thehrh in https://github.com/icecube/pisa/pull/796

• Revive parametric Aeff stage by @JanWeldert in https://github.com/icecube/pisa/pull/798

• Clean up imports by services and get rid of unused WHERE constant for smart arrays by @thehrh in https://github.com/icecube/pisa/pull/790

• Add link to general PISA conventions in root readme by @thehrh in https://github.com/icecube/pisa/pull/805

• Remove obsolete scripts from pisa_tests directory and update entry points in setup.py by @thehrh in https://github.com/icecube/pisa/pull/812

• Allow for ultrasurfaces fit results file path relative to pisa resources search paths by @thehrh in https://github.com/icecube/pisa/pull/813

• remove fit and minimiser settings in unused and unparsable .cfg format by @thehrh in https://github.com/icecube/pisa/pull/820

• Allow reporting timing data for several pipelines at once (from any Detectors or DistributionMaker instance) … by @thehrh in https://github.com/icecube/pisa/pull/822

• make to_file accept simple file name again by @thehrh in https://github.com/icecube/pisa/pull/824

• Adding a contributing guide by @JanWeldert in https://github.com/icecube/pisa/pull/826

• Service transparency and usability: expected data keys, supported representations, unit tests by @thehrh in https://github.com/icecube/pisa/pull/817

• First version of an MCMC sampler by @JanWeldert in https://github.com/icecube/pisa/pull/829

• Update release.yml by @philippeller in https://github.com/icecube/pisa/pull/837

• Restructure and update installation instructions by @thehrh in https://github.com/icecube/pisa/pull/836

• Update install instructions by @JanWeldert in https://github.com/icecube/pisa/pull/832

• Fix python test environment setup. by @LeanderFischer in https://github.com/icecube/pisa/pull/844

• Enable (in)equality constraints for use with local and global scipy minimizers by @thehrh in https://github.com/icecube/pisa/pull/841

• Update discrete systematic README (Ultrasurface use) by @LeanderFischer in https://github.com/icecube/pisa/pull/846

• Various documentation touch-ups by @thehrh in https://github.com/icecube/pisa/pull/848

• Alternative variable binning approach by @JanWeldert in https://github.com/icecube/pisa/pull/849

• update sphinx build config file version string from 4.1 -> 4.2 by @thehrh in https://github.com/icecube/pisa/pull/850

New Contributors

• @finnmayhew made their first contribution in https://github.com/icecube/pisa/pull/755

• @ggarg07 made their first contribution in https://github.com/icecube/pisa/pull/762

• @sc458930 made their first contribution in https://github.com/icecube/pisa/pull/764

Full Changelog: https://github.com/icecube/pisa/compare/4.1…4.2

4.1.1: First tag triggering docu workflow

Released on 2024-04-26 - GitHub

Tag the current version to trigger the docu creation and deployment.

4.1: Pisa 4 official release

Released on 2023-05-23 - GitHub

First official pisa 4 release.

Pisa 4.0 pre-release

Released on 2021-01-26 - GitHub

First version of pisa 4 to be used for analysis

3.1: Pisa 3 last release

Released on 2021-01-26 - GitHub

This is the last official pisa 3 release before switching over to pisa 4.

3.0b1

Released on 2017-12-13 - GitHub

3.0a1

Released on 2016-09-18 - GitHub

First alpha (pre-)release for PISA Cake (3.0). Still needs testing for LLR and Asimov analyses and postprocessing scripts. See INSTALL.md for how to install and run the included physics tests.