mplhep

A set of helpers for matplotlib to more easily produce plots typically needed in HEP as well as style them in way that's compatible with current collaboration requirements (ROOT-like plots for CMS, ATLAS, LHCb, ALICE).

Installation

pip install mplhep

Documentation and Getting Started

A tutorial given at PyHEP 2020 is available as a binder here or you can watch the recording here.

Documentation can be found at scikit-hep.org/mplhep.

Notes

Citation

If you've found this library helpful and are able to, please consider citing it. You can find us on Zenodo as a permalink to the latest version.

BiBTeX:

@software{Novak_mplhep_2020,
  author = {Novak, Andrzej and Schreiner, Henry and Feickert, Matthew and Eschle, Jonas and Fillinger, Tristan and Praz, Cyrille},
  doi = {10.5281/zenodo.3766157},
  license = {MIT},
  month = apr,
  title = {{mplhep}},
  url = {https://github.com/scikit-hep/mplhep},
  year = {2020}
}

APA:

Novak, A., Schreiner, H., Feickert, M., Eschle, J., Fillinger, T., & Praz, C. (2020). mplhep [Computer software]. https://doi.org/10.5281/zenodo.3766157

Use in publications

Updating list of citations and use cases of mplhep in publications:

Simultaneous Jet Energy and Mass Calibrations with Neural Networks, ATLAS Collaboration, 2019
Integration and Performance of New Technologies in the CMS Simulation, Kevin Pedro, 2020 (Fig 5,6)
GeantV: Results from the prototype of concurrent vector particle transport simulation in HEP, Amadio et al, 2020 (Fig 25,26)
Search for the standard model Higgs boson decaying to charm quarks, CMS Collaboration, 2019 (Fig 1)
Search for long-lived particles decaying to eμν, LHCb Collaboration, 2020
Measurement of the mass dependence of the transverse momentum of lepton pairs in Drell-Yan production in proton-proton collisions at √s = 13 TeV, CMS Collaboration, 2022 (Figs 3-)
And many others by now...

Metadata

Release files for mplhep 1.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mplhep 1.3.3
File	Size	Uploaded
mplhep-1.3.3.tar.gz	4.9 MB	Aug 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mplhep 1.3.3
File	Interpreter	ABI	Platform	Reset
mplhep-1.3.3-py3-none-any.whl 93.7 kB Aug 15, 2026	Python 3	none	any	Details

Total release size: 5.0 MB

Release files / mplhep-1.3.3.tar.gz

Download URL	mplhep-1.3.3.tar.gz
Size	4.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`a7d0ec076b0136544f5d3b658948df68990673824d0aeda7bfa8d2fba9f8c34c`
BLAKE2b-256 checksum How to use checksums	`d4134e6c72db7f938d5a00a17809dd82237fa93e47f2ccf29020993b8d454026`
Upload date	Aug 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/scikit-hep/mplhep
Publishing commit: github.com/scikit-hep/mplhep/tree/a2ce0c08bb32ba6958705d62d13678302d77a2a5

Workflow

Publishing configuration: github.com/scikit-hep/mplhep/blob/a2ce0c08bb32ba6958705d62d13678302d77a2a5/.github/workflows/cd.yml
Publishing logs: github.com/scikit-hep/mplhep/actions/runs/31872164290/attempts/1

Artifact

Subject: mplhep-1.3.3.tar.gz
SHA-256 checksum: a7d0ec076b0136544f5d3b658948df68990673824d0aeda7bfa8d2fba9f8c34c Verifying attestations

Release files / mplhep-1.3.3-py3-none-any.whl

Download URL	mplhep-1.3.3-py3-none-any.whl
Size	93.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d2fae11a1f1f57946895cf89800e0ac16c03ed4de4d4a76a4bd2d2ff6052ae7e`
BLAKE2b-256 checksum How to use checksums	`bf4ecf1700cf7caa92f3fc492d35558e5a0b928b8d24bdf7340023a1c4b7e4cf`
Upload date	Aug 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/scikit-hep/mplhep
Publishing commit: github.com/scikit-hep/mplhep/tree/a2ce0c08bb32ba6958705d62d13678302d77a2a5

Workflow

Publishing configuration: github.com/scikit-hep/mplhep/blob/a2ce0c08bb32ba6958705d62d13678302d77a2a5/.github/workflows/cd.yml
Publishing logs: github.com/scikit-hep/mplhep/actions/runs/31872164290/attempts/1

Artifact

Subject: mplhep-1.3.3-py3-none-any.whl
SHA-256 checksum: d2fae11a1f1f57946895cf89800e0ac16c03ed4de4d4a76a4bd2d2ff6052ae7e Verifying attestations