hist 2.0.0

Hist classes and utilities

Hist

Hist is a analyst friendly front-end for boost-histogram, designed for Python 3.6+.

Installation

You can install this library from PyPI with pip:

python3 -m pip install "hist[plot]"

If you do not need the plotting features, you can skip the [plot] extra:

Features

Hist currently provides everything boost-histogram provides, and the following enhancements:

• Hist augments axes with names:

  • name= is a unique label describing each axis.
  • label= is an optional string that is used in plotting (defaults to name if not provided).
  • Indexing, projection, and more support named axes.
  • Experimental NamedHist is a Hist that disables most forms of positional access.

• The Hist class augments bh.Histogram with reduced typing construction:

  • Optional import-free construction system
  • flow=False is a fast way to turn off flow

• Hist implements UHI+; an extension to the UHI system designed for import-free interactivity:

  • Uses j suffix to switch to data coordinates in access or slices
  • Uses j suffix on slices to rebin
  • Strings can be used directly to index into string category axes

• Quick plotting routines encourage exploration:

  • .plot() provides 1D and 2D plots
  • .plot2d_full() shows 1D projects around a 2D plot
  • .plot_pull(...) performs a pull plot

• Notebook ready: Hist has gorgeous in-notebook representation.

  • No dependencies required

Usage

from hist import Hist

# Quick construction, no other imports needed:
h = (
  Hist.new
  .Reg(10, 0 ,1, name="x", label="x-axis")
  .Variable(range(10), name="y", label="y-axis")
  .Int64()
)

# Filling by names is allowed:
hist.fill(y=[1, 4, 6], x=[3, 5, 2])

# Names can be used to manipulate the histogram:
h.project("x")
h[{"y": 0.5j + 3, "x": 5j}]

# You can access data coordinates or rebin with a `j` suffix:
h[.3j:, ::2j] # x from .3 to the end, y is rebinned by 2

# Elegant plotting functions:
h.plot()
h.plot2d_full()
h.plot_pull(Callable)

Development

From a git checkout, run:

python -m pip install -e .[dev]

See CONTRIBUTING.md for information on setting up a development environment.

Contributors

We would like to acknowledge the contributors that made this project possible (emoji key):

Henry Schreiner 🚧 💻 📖

Nino Lau 🚧 💻📖

This project follows the all-contributors specification.

Talks

• 2020-07-07 SciPy Proceedings
• 2020-07-17 PyHEP2020

---

Acknowledgements

This library was primarily developed by Henry Schreiner and Nino Lau.

Support for this work was provided by the National Science Foundation cooperative agreement OAC-1836650 (IRIS-HEP) and OAC-1450377 (DIANA/HEP). Any opinions, findings, conclusions or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the National Science Foundation.