hepdata_lib
Library for getting your data into HEPData
- Documentation: https://hepdata-lib.readthedocs.io
This code works with Python 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12 or 3.13.
Installation
It is highly recommended you install hepdata_lib into a virtual environment.
python -m pip install hepdata_lib
Alternatively, install from conda-forge using a conda ecosystem package manager:
conda install --channel conda-forge hepdata-lib
If you are not sure about your Python environment, please also see below how to use hepdata_lib in a Docker or Apptainer container.
The use of Apptainer is recommended when working on typical HEP computing clusters such as CERN LXPLUS.
Getting started
For using hepdata_lib, you don't even need to install it, but can use the binder or SWAN (CERN-only) services using one of the buttons below:
You can also use the Docker image (recommended when working on local machine):
docker run --rm -it -p 8888:8888 -v ${PWD}:/home/hepdata ghcr.io/hepdata/hepdata_lib:latest
And then point your browser to http://localhost:8888 and use the token that is printed out. The output will end up in your current working directory (${PWD}).
If you prefer a shell, instead run:
docker run --rm -it -p 8888:8888 -v ${PWD}:/home/hepdata ghcr.io/hepdata/hepdata_lib:latest bash
If on CERN LXPLUS or anywhere else where there is Apptainer available but not Docker, you can still use the docker image.
If CVMFS (specifically /cvmfs/unpacked.cern.ch/) is available:
export APPTAINER_CACHEDIR="/tmp/$(whoami)/apptainer"
apptainer shell -B /afs -B /eos /cvmfs/unpacked.cern.ch/ghcr.io/hepdata/hepdata_lib:latest
If CVMFS is not available:
export APPTAINER_CACHEDIR="/tmp/$(whoami)/apptainer"
apptainer shell -B /afs -B /eos docker://ghcr.io/hepdata/hepdata_lib:latest bash
Unpacking the image can take a few minutes the first time you use it. Please be patient. Both EOS and AFS should be available and the output will be in your current working directory.
Further examples
There are a few more examples available that can directly be run using the binder links below or using SWAN (CERN-only, please use LCG release LCG_94 or later) and selecting the corresponding notebook manually:
- Reading in text files
- Reading in a CMS combine ntuple
- Reading in ROOT histograms
- Reading a correlation matrix
- Reading TGraph and TGraphError from '.C' files
- Preparing scikit-hep histograms
External dependencies
Make sure that you have ROOT in your $PYTHONPATH and that the convert command is available by adding its location to your $PATH if needed.
A ROOT installation is not strictly required if your input data is not in a ROOT format, for example, if
your input data is provided as text files or scikit-hep/hist histograms. Most of the hepdata_lib
functionality can be used without a ROOT installation, other than the RootFileReader and CFileReader classes,
and other functions of the hepdata_lib.root_utils module.
4 maintainers
Metadata
4 maintainers
Release files for hepdata-lib 0.21.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hepdata_lib-0.21.0.tar.gz | 46.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hepdata_lib-0.21.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 74.0 kB
Release files / hepdata_lib-0.21.0.tar.gz
| Download URL | hepdata_lib-0.21.0.tar.gz |
|---|---|
| Size | 46.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
10910f47f246cfb947def37ecd18d60ca71de0f935ec014e60613a9e64918152
|
|
BLAKE2b-256 checksum How to use checksums |
2370cc9bc6fb9650e9f140f5cf2213cdc74c7431ca3f1e8eaf827a96cebb0de0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 11, 2026.
Transparency logRelease files / hepdata_lib-0.21.0-py3-none-any.whl
| Download URL | hepdata_lib-0.21.0-py3-none-any.whl |
|---|---|
| Size | 27.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8fe094d793b7d28ac475b41e70ee5e643b92f2d617eb002cd37687a781e8d39
|
|
BLAKE2b-256 checksum How to use checksums |
6f6272253b132db7fd355281e12ff5acf1857d81b54222dcab47424e74f7da56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 11, 2026.
Transparency log
