hepunits
Units and constants in the HEP system of units
Decision gist · record as of 2026-08-14
Yes. The package has zero security vulnerabilities, low install friction, active maintenance, and is designed for a specific and well-defined use case in particle physics. If you work in HEP or use software that follows CLHEP conventions, this is the standard way to handle units and constants in Python. Even if you only occasionally need HEP unit conversions, the permissive license and lack of dependencies make it a safe, lightweight addition.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with no runtime dependencies.
- Active maintenance with a release within the last 59 days.
- Supports Python 3.9 through 3.14, indicating current compatibility.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause is a permissive license allowing commercial and private use with minimal restrictions, making this package safe to incorporate into most projects.
last release 2026-06-16 (59 days) · last repo commit 2026-08-11 · 31 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 119,221 downloads/mo, #12,081 on PyPI
Alternatives
Verify before relying
pip install hepunits
from hepunits.constants import c_light
from hepunits.units import picosecond, micrometer
tau = 1.5 * picosecond
distance = c_light * tau
print(distance / micrometer) # converts to micrometers- Whether Pint integration is required for typical use or remains optional for most workflows
- Performance characteristics when working with large datasets or frequent unit conversions
What it is and what it does
hepunits is a Python library that defines the standard units and physical constants used in high-energy physics, based on the CLHEP system rather than SI units. The core difference is that HEP uses millimeters for length, nanoseconds for time, and MeV for energy as its base units, reflecting conventions used in major physics software like GEANT4 and Gaudi. The package provides two main modules: constants (physical constants and commonly used values) and units (length, time, energy, and other dimensional quantities).
You use it by multiplying numerical values by unit objects to create dimensioned quantities, then dividing by units to extract values in a desired unit system. For example, defining a 1 GeV mass window as `1 * GeV` and retrieving an energy resolution in GeV as `energy_resolution() / GeV`. The package also optionally integrates with Pint for interoperability with a more general-purpose units library, though this is not required for basic use.
Use it for
- Define and work with particle lifetimes and decay distances in particle physics simulations and analysis code
- Perform energy and momentum calculations in high-energy physics experiments using standard HEP conventions
- Convert between HEP units and SI or other unit systems when interfacing with external libraries or publishing results
- Store dimensioned quantities consistently in data structures while keeping internal representation in HEP units
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package has zero security vulnerabilities, low install friction, active maintenance, and is designed for a specific and well-defined use case in particle physics. If you work in HEP or use software that follows CLHEP conventions, this is the standard way to handle units and constants in Python. Even if you only occasionally need HEP unit conversions, the permissive license and lack of dependencies make it a safe, lightweight addition.
Install
hepunits on PyPI
Before you install
Low install friction with no runtime dependencies. Active maintenance with a release within the last 59 days. Supports Python 3.9 through 3.14, indicating current compatibility.
License in practice
BSD-3-Clause is a permissive license allowing commercial and private use with minimal restrictions, making this package safe to incorporate into most projects.
Quickstart
pip install hepunits
from hepunits.constants import c_light
from hepunits.units import picosecond, micrometer
tau = 1.5 * picosecond
distance = c_light * tau
print(distance / micrometer) # converts to micrometersVerify before relying
- Whether Pint integration is required for typical use or remains optional for most workflows
- Performance characteristics when working with large datasets or frequent unit conversions
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 59 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 119,221 / month, #12,081 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/ResearchOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming 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: hepunits-2.4.6-py3-none-any.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 › “HEP units constants”
- hepunitsProvides units and physical constants in the HEP (High Energy…
- quantitiesQuantities handles arithmetic and unit conversions for physical…
- chemicalsRetrieves and calculates chemical properties and constants for over…
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 particle · Pint · ansys-units · Pint-Pandas · pint-xarray · ucumvert · uproot3-methods · mendeleev · mplhep · uproot