NNPDF/pineappl: v1.0.0

1.0.0 - 10/06/2025

PineAPPL 1.0 is a major rewrite from the previous version, allowing grids to have an arbitrary number of convolutions in the initial (PDFs with a factorization scale) and in the final (FFs with a fragmentation scale) state. This required a change in the file format that is used to write out grids, but the old file format can still be read with this new version.

Added

• added new method Grid::delete_orders and the corresponding switch --delete-orders in the subcommand write of the CLI
• added the switches --xir and --xif, which allow varying the renormalization and factorization scales with a custom factor in the subcommand convolve
• the CLI now allows the user to mark convolution functions as polarized by adding +p to its LHAPDF name, as a fragmentation function by adding +f and both by adding +pf or +fp
• added switches --fk-table-fac0 and --fk-table-frg0 to pineappl read to read out the squared factorization and fragmentation scales of FK-tables

Changed

• the macro channel! now accepts a channel specification that is of the format factor * (pid, ..) + ...
• Python API: dropped top-level Python interface layer
• Python API: renamed lumi to channel in PyO3 Python interface. This concerns 1) the argument names of convolute_with_one and similar functions; 2) the module pineappl.lumi was moved to pineappl.boc; 3) the class LumiEntry was renamed to Channel
• Python API: .into() needs to be explicitly called on subgrids when calling pineappl.grid.set_subgrid()
• Python API: replaced pineappl.grid.PyPidBasis with pineappl.evolution.PidBasis
• Python API: replaced pineappl.grid.PyOperatorSliceInfo with pineappl.evolution.OperatorSliceInfo
• Python API: drop all Py prefixes, for instance PyEvolveInfo was renamed to EvolveInfo
• by default pineappl plot no longer shows a channel breakdown in the panel with absolute PDF predictions. However, this feature can be enabled with via a new array added at the start of the script
• raised MSRV to 1.80.1
• changed the order of elements in Grid::fill of the parameter ntuple to reflect the ordering of kinematics given to Grid::new
• renamed the following switches of pineappl write: --remap to --set-bins, --remap-norm-ignore to --div-bin-norm-dims and --remap-norm to --mul-bin-norm. These names should reflect the corresponding operations
• renamed the switch --fktable to --fk-table of pineappl read

Removed

• Python API: removed pineappl.grid.Grid.create() and pineappl.fk_table.FkTable.from_grid() methods; use the constructors of the respective class instead
• removed the constructor Grid::with_subgrid_type
• removed Grid::convolve_subgrid and --subgrid-pull from pineappl plot that was using the method. The CLI subgrid-pull plotting routine only ever worked for grids with two convolutions