correctionlib
A generic correction library
Decision gist · record as of 2026-08-14
Yes. Correctionlib is actively maintained, has no known vulnerabilities, and is production-stable (Development Status 5). It is purpose-built for high-energy physics workflows and widely adopted in that domain. Install it if you work with HEP data or need a standardized, versioned correction-factor framework; the medium install friction is typical for compiled scientific packages and poses no practical barrier.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Compiled wheels are provided for common platforms; installation on unsupported architectures may require building from source.
- Medium install friction due to compiled wheels for multiple platforms and Python versions (3.9–3.14).
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you include the license notice.
last release 2026-06-16 (59 days) · last repo commit 2026-08-01 · 18 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 786,529 downloads/mo, #5,064 on PyPI
Alternatives
Verify before relying
pip install correctionlib
import correctionlib
from correctionlib.schemav2 import Correction, CorrectionSet
# Load a correction from JSON
corrections = correctionlib.CorrectionSet.from_file('corrections.json')
correction = corrections['my_correction']
result = correction.evaluate(1.5, 'category_a')- Whether the C++ evaluator is exposed as a standalone library or only through Python bindings.
- Performance characteristics and typical evaluation latency for large correction graphs.
- Whether numpy vectorization is fully implemented or remains a future feature.
What it is and what it does
Correctionlib is a library for defining, storing, and evaluating correction factors—mathematical functions that adjust or transform scalar inputs to produce scalar outputs. It is widely used in high-energy physics to encode calibration factors, efficiency corrections, and other data-driven adjustments in a standardized, versioned JSON format. The library provides both a C++ evaluator and Python bindings, allowing corrections to be defined once and reused across analysis pipelines.
The package supports multiple function types: multi-dimensional binned lookups, binned lookups with formula-based outputs, categorical maps, input transforms, and compositions of these primitives. Formulas are parsed using a formal grammar and support a subset of ROOT's TFormula syntax. Corrections are validated against JSON schemas, and the library maintains backward compatibility across minor versions while allowing forward-incompatible additions (such as new node types in v2.9.0). It depends on numpy, pydantic, rich, and packaging.
Use it for
- Store and evaluate physics calibration factors (e.g., lepton efficiency corrections) in a standardized JSON format shared across a collaboration.
- Apply multi-dimensional binned corrections to particle physics data during analysis, with formula-based outputs for complex transformations.
- Migrate correction data between schema versions using forward-porting tools to maintain compatibility across analysis code.
- Validate correction objects during construction using pydantic type checking before serializing to JSON.
- Compose simple correction nodes (binning, formulas, categorical maps) into complex correction graphs for detector response modeling.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Correctionlib is actively maintained, has no known vulnerabilities, and is production-stable (Development Status 5). It is purpose-built for high-energy physics workflows and widely adopted in that domain. Install it if you work with HEP data or need a standardized, versioned correction-factor framework; the medium install friction is typical for compiled scientific packages and poses no practical barrier.
Install
correctionlib on PyPI
Before you install
Medium install friction due to compiled wheels for multiple platforms and Python versions (3.9–3.14). Active maintenance with a recent release (59 days ago) and no known vulnerabilities.
Requires Python 3.9 or later. Compiled wheels are provided for common platforms; installation on unsupported architectures may require building from source.
License in practice
BSD-3-Clause is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you include the license notice.
Quickstart
pip install correctionlib
import correctionlib
from correctionlib.schemav2 import Correction, CorrectionSet
# Load a correction from JSON
corrections = correctionlib.CorrectionSet.from_file('corrections.json')
correction = corrections['my_correction']
result = correction.evaluate(1.5, 'category_a')Verify before relying
- Whether the C++ evaluator is exposed as a standalone library or only through Python bindings.
- Performance characteristics and typical evaluation latency for large correction graphs.
- Whether numpy vectorization is fully implemented or remains a future feature.
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 4 packagesnumpypydanticrichpackaging |
| Maintenance | Actively maintained 59 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 786,529 / month, #5,064 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Science/ResearchLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: Scientific/Engineering |
Evidence: correctionlib-2.9.0-cp310-cp310-macosx_11_0_arm64.whl; correctionlib-2.9.0-cp310-cp310-macosx_11_0_universal2.whl; correctionlib-2.9.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl; correctionlib-2.9.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; correctionlib-2.9.0-cp310-cp310-musllinux_1_2_aarch64.whl; correctionlib-2.9.0-cp310-cp310-musllinux_1_2_x86_64.whl; correctionlib-2.9.0-cp310-cp310-win_amd64.whl; correctionlib-2.9.0-cp311-cp311-macosx_11_0_arm64.whl; correctionlib-2.9.0-cp311-cp311-macosx_11_0_universal2.whl; correctionlib-2.9.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl; correctionlib-2.9.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; correctionlib-2.9.0-cp311-cp311-musllinux_1_2_aarch64.whl; correctionlib-2.9.0-cp311-cp311-musllinux_1_2_x86_64.whl; correctionlib-2.9.0-cp311-cp311-win_amd64.whl; correctionlib-2.9.0-cp311-cp311-win_arm64.whl; correctionlib-2.9.0-cp312-cp312-macosx_11_0_arm64.whl; correctionlib-2.9.0-cp312-cp312-macosx_11_0_universal2.whl; correctionlib-2.9.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl; correctionlib-2.9.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; correctionlib-2.9.0-cp312-cp312-musllinux_1_2_aarch64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “correction factors evaluation”
- correctionlibProvides a JSON-based format and evaluator for correction…
- BorutaBoruta performs all-relevant feature selection by identifying all…
- mgwrCalibrates multiscale and traditional geographically weighted…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scientific/Engineering packages
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
pandas provides fast, flexible data structures (Series and DataFrame) for loading, cleaning, transforming, and analyzing labeled or relational data in Python.
scipy provides numerical algorithms for mathematics, science, and engineering—including optimization, integration, linear algebra, Fourier transforms, signal and image processing, and ODE solvers—built on numpy arrays.
scikit-learn provides a comprehensive Python library for supervised and unsupervised machine learning, including classification, regression, clustering, dimensionality reduction, and model evaluation tools built on NumPy and SciPy.
Install it if you need to train, evaluate, or deploy supervised or unsupervised learning models.
dill extends Python's pickle module to serialize and deserialize a much wider range of Python objects, including functions, lambdas, classes, and interpreter sessions, to byte streams for storage or network transmission.
Multiprocess is an enhanced fork of Python's standard multiprocessing library that uses dill for better serialization, allowing you to spawn processes with a threading-like API and share complex objects between them.
Install it if you use multiprocessing and encounter pickle serialization limits with lambdas or complex objects.
See also coffea · fastjet · uproot · PyMatching · hepunits · boost-histogram · formulaic · plotbin · mplhep · typos