Hist classes and utilities
Project description
Hist
Hist is a analyst friendly front-end for boost-histogram, designed for Python 3.6+. See what's new.
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 tonameif not provided).- Indexing, projection, and more support named axes.
- Experimental
NamedHistis aHistthat disables most forms of positional access.
-
The
Histclass augmentsbh.Histogramwith reduced typing construction:- Optional import-free construction system
flow=Falseis a fast way to turn off flow- Storages can be given by string
storage=can be omitteddata=can initialize a histogram with existing dataHist.from_columnscan be used to initialize with a DataFrame or dict
-
Hist implements UHI+; an extension to the UHI (Unified Histogram Indexing) system designed for import-free interactivity:
- Uses
jsuffix to switch to data coordinates in access or slices - Uses
jsuffix on slices to rebin - Strings can be used directly to index into string category axes
- Uses
-
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.plot_pie()makes a pie 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")
.Var(range(10), name="y", label="y-axis")
.Int64()
)
# Filling by names is allowed:
h.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 🚧 💻 📖 |
 Chris Burr 💻 |
 Eduardo Rodrigues 💻 |
This project follows the all-contributors specification.
Talks
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file hist-2.2.1.tar.gz.
File metadata
- Download URL: hist-2.2.1.tar.gz
- Upload date:
- Size: 414.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7b6ab2032b73c77e0559226610b8913c296f429cb3ac0705fa4db55e6a6004f1 |
|
| MD5 | 045a622d4998afcacb3aecd01d07c32f |
|
| BLAKE2b-256 | 285ea92dea8d200597339c1bc6b6984c5ac6904664d2d6fc1ccf1820238bb454 |
File details
Details for the file hist-2.2.1-py3-none-any.whl.
File metadata
- Download URL: hist-2.2.1-py3-none-any.whl
- Upload date:
- Size: 23.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7a5dfb5f2a7c34c223393ef0a9acf13c642ec26f30ba4ca2f7f35038c4f25a50 |
|
| MD5 | 0082ab12904bfc3cb053cce03275feef |
|
| BLAKE2b-256 | f4a691f13a89839661f2b1745b28e0bb4b25962426d79f713785e4f089d77140 |
