Note Click here for the training website!

This training module introduces matplotlib and creates plots commonly used in HEP. It also introduces mplhep, a plotting library designed specifically for HEP plots.

We welcome all contributions to improve the lesson! Maintainers will do their best to help you if you have any questions, concerns, or experience any difficulties along the way.

We'd like to ask you to familiarize yourself with our Contribution Guide and have a look at the more detailed guidelines on proper formatting, ways to render the lesson locally, and even how to write new episodes.

Quick summary of how to get a local preview: Install jekyll and then run

bundle install
bundle update
bundle exec jekyll serve

Unless we change framework versions, only the last command needs to be typed after the first time.

Before committing anything, we also ask you to install the pre-commit hooks of this repository:

pip3 install pre-commit
pre-commit install

Please see the current list of issues for ideas for contributing to this repository. For making your contribution, we use the GitHub flow, which is nicely explained in the chapter Contributing to a Project in Pro Git by Scott Chacon. Look for the tag . This indicates that the maintainers will welcome a pull request fixing this issue.

Thanks goes to these wonderful people (emoji key) who contributed to the content of the lesson:

Meirin Oan Evans 🖋	amorenobr 🖋	Guillermo A. Fidalgo-Rodríguez 🖋	Marchela04 🖋	ekauffma 🖋	Aman Desai 🖋	Kilian Lieret 🖋
Wouter Deconinck 🖋	Michel H. Villanueva 🖋	PaxtonDevs 🖋	Vaibhav-Chopra-GT 🖋

Even more people contributed to the framework, but they are too many to list!

To cite this lesson, please consult with CITATION