boost-histogram 1.7.1
The Boost::Histogram Python wrapper.
Requires Python: >=3.10
Keywords: boost-histogram, histogram

<img alt="boost-histogram logo" width="402" src="https://raw.githubusercontent.com/scikit-hep/boost-histogram/develop/docs/_images/BoostHistogramPythonLogo.png"/>

# boost-histogram for Python

[![Actions Status][actions-badge]][actions-link]
[![Documentation Status][rtd-badge]][rtd-link]

[![PyPI version][pypi-version]][pypi-link]
[![Conda-Forge][conda-badge]][conda-link]
[![PyPI platforms][pypi-platforms]][pypi-link]
[![DOI](https://zenodo.org/badge/148885351.svg)](https://zenodo.org/badge/latestdoi/148885351)

[![GitHub Discussion][github-discussions-badge]][github-discussions-link]
[![Gitter][gitter-badge]][gitter-link]
[![Scikit-HEP][sk-badge]](https://scikit-hep.org/)
[![SPEC 4 — Using and Creating Nightly Wheels][spec4-badge]][spec4-link]

Python bindings for [Boost::Histogram][] ([source][Boost::Histogram source]), a C++14 library. This is one of the [fastest libraries][] for
histogramming, while still providing the power of a full histogram object. See
[what's new](./docs/CHANGELOG.md).

Other members of the boost-histogram family include:

- [Hist][]: The first-party analyst-friendly histogram library that extends
  boost-histogram with named axes, many new shortcuts including UHI+, plotting
  shortcuts, and more.
- [UHI][]: Specification for Histogram library interop, especially for plotting.
- [mplhep][]: Plotting extension for matplotlib with support for UHI histograms.
- [histoprint][]: Histogram display library for the command line with support for UHI.
- [dask-histogram][]: Dask support for boost-histogram.

[uhi]: https://uhi.readthedocs.io
[dask-histogram]: https://dask-histogram.readthedocs.io/en/stable/
[mplhep]: https://mplhep.readthedocs.io/en/latest/
[histoprint]: https://github.com/scikit-hep/histoprint

## Usage

![Slideshow of features. See expandable text below if the image is not readable.](https://github.com/scikit-hep/boost-histogram/raw/develop/docs/_images/banner.gif)

<details><summary>Text intro (click to expand)</summary>

```python
import boost_histogram as bh

# Compose axis however you like; this is a 2D histogram
hist = bh.Histogram(
    bh.axis.Regular(2, 0, 1),
    bh.axis.Regular(4, 0.0, 1.0),
)

# Filling can be done with arrays, one per dimension
hist.fill(
    [0.3, 0.5, 0.2],
    [0.1, 0.4, 0.9],
)

# NumPy array view into histogram counts, no overflow bins
values = hist.values()

# Make a new histogram with just the second axis, summing over the first, and
# rebinning the second into larger bins:
h2 = hist[::sum, :: bh.rebin(2)]
```

</details>

We support the [uhi][] [PlottableHistogram][] protocol, so boost-histogram/[Hist][]
histograms can be plotted via any compatible library, such as [mplhep][].

[uhi]: https://github.com/scikit-hep/uhi
[PlottableHistogram]: https://uhi.readthedocs.io/en/latest/plotting.html
[mplhep]: https://github.com/scikit-hep/mplhep

## Cheatsheet

<details><summary>Simplified list of features (click to expand)</summary>

- Many axis types (all support `metadata=...`)
  - `bh.axis.Regular(n, start, stop, ...)`: Make a regular axis. Options listed below.
    - `overflow=False`: Turn off overflow bin
    - `underflow=False`: Turn off underflow bin
    - `growth=True`: Turn on growing axis, bins added when out-of-range items added
    - `circular=True`: Turn on wrapping, so that out-of-range values wrap around into the axis
    - `transform=bh.axis.transform.Log`: Log spacing
    - `transform=bh.axis.transform.Sqrt`: Square root spacing
    - `transform=bh.axis.transform.Pow(v)`: Power spacing
    - See also the flexible [Function transform](https://boost-histogram.readthedocs.io/en/latest/usage/transforms.html)
  - `bh.axis.Integer(start, stop, *, underflow=True, overflow=True, growth=False, circular=False)`: Special high-speed version of `regular` for evenly spaced bins of width 1
  - `bh.axis.Variable([start, edge1, edge2, ..., stop], *, underflow=True, overflow=True, circular=False)`: Uneven bin spacing
  - `bh.axis.IntCategory([...], *, growth=False)`: Integer categories
  - `bh.axis.StrCategory([...], *, growth=False)`: String categories
  - `bh.axis.Boolean()`: A True/False axis
- Axis features:
  - `.index(value)`: The index at a point (or points) on the axis
  - `.value(index)`: The value for a fractional bin (or bins) in the axis
  - `.bin(i)`: The bin edges (continuous axis) or a bin value (discrete axis)
  - `.centers`: The N bin centers (if continuous)
  - `.edges`: The N+1 bin edges (if continuous)
  - `.extent`: The number of bins (including under/overflow)
  - `.metadata`: Anything a user wants to store
  - `.traits`: The options set on the axis
  - `.size`: The number of bins (not including under/overflow)
  - `.widths`: The N bin widths
- Many storage types
  - `bh.storage.Double()`: Doubles for weighted values (default)
  - `bh.storage.Int64()`: 64-bit unsigned integers
  - `bh.storage.Unlimited()`: Starts small, but can go up to unlimited precision ints or doubles.
  - `bh.storage.AtomicInt64()`: Threadsafe filling, experimental. Does not support growing axis in threads.
  - `bh.storage.Weight()`: Stores a weight and sum of weights squared.
  - `bh.storage.Mean()`: Accepts a sample and computes the mean of the samples (profile).
  - `bh.storage.WeightedMean()`: Accepts a sample and a weight. It computes the weighted mean of the samples.
- Accumulators
  - `bh.accumulator.Sum`: High accuracy sum (Neumaier) - used by the sum method when summing a numerical histogram
  - `bh.accumulator.WeightedSum`: Tracks a weighted sum and variance
  - `bh.accumulator.Mean`: Running count, mean, and variance (Welfords's incremental algorithm)
  - `bh.accumulator.WeightedMean`: Tracks a weighted sum, mean, and variance (West's incremental algorithm)
- Histogram operations
  - `h.ndim`: The number of dimensions
  - `h.size or len(h)`: The number of bins
  - `+`: Add two histograms (storages must match types currently)
  - `*=`: Multiply by a scaler (not all storages) (`hist * scalar` and `scalar * hist` supported too)
  - `/=`: Divide by a scaler (not all storages) (`hist / scalar` supported too)
  - `.kind`: Either `bh.Kind.COUNT` or `bh.Kind.MEAN`, depending on storage
  - `.storage_type`: Fetch the histogram storage type
  - `.sum(flow=False)`: The total count of all bins
  - `.project(ax1, ax2, ...)`: Project down to listed axis (numbers). Can also reorder axes.
  - `.to_numpy(flow=False, view=False)`: Convert to a NumPy style tuple (with or without under/overflow bins)
  - `.view(flow=False)`: Get a view on the bin contents (with or without under/overflow bins)
  - `.values(flow=False)`: Get a view on the values (counts or means, depending on storage)
  - `.variances(flow=False)`: Get the variances if available
  - `.counts(flow=False)`: Get the effective counts for all storage types
  - `.reset()`: Set counters to 0 (growing axis remain the same size)
  - `.empty(flow=False)`: Check to see if the histogram is empty (can check flow bins too if asked)
  - `.copy(deep=False)`: Make a copy of a histogram
  - `.axes`: Get the axes as a tuple-like (all properties of axes are available too)
    - `.axes[0]`: Get the 0th axis
    - `.axes.edges`: The lower values as a broadcasting-ready array
    - `.axes.centers`: The centers of the bins broadcasting-ready array
    - `.axes.widths`: The bin widths as a broadcasting-ready array
    - `.axes.metadata`: A tuple of the axes metadata
    - `.axes.size`: A tuple of the axes sizes (size without flow)
    - `.axes.extent`: A tuple of the axes extents (size with flow)
    - `.axes.bin(*args)`: Returns the bin edges as a tuple of pairs (continuous axis) or values (describe)
    - `.axes.index(*args)`: Returns the bin index at a value for each axis
    - `.axes.value(*args)`: Returns the bin value at an index for each axis
- Indexing - Supports [UHI Indexing](https://uhi.readthedocs.io/en/latest/indexing.html)
  - Bin content access / setting
    - `v = h[b]`: Access bin content by index number
    - `v = h[{0:b}]`: All actions can be represented by `axis:item` dictionary instead of by position (mostly useful for slicing)
  - Slicing to get histogram or set array of values
    - `h2 = h[a:b]`: Access a slice of a histogram, cut portions go to flow bins if present
    - `h2 = h[:, ...]`: Using `:` and `...` supported just like NumPy
    - `h2 = h[::sum]`: Third item in slice is the "action"
    - `h[...] = array`: Set the bin contents, either include or omit flow bins
  - Special accessors
    - `bh.loc(v)`: Supply value in axis coordinates instead of bin number
    - `bh.underflow`: The underflow bin (use empty beginning on slice for slicing instead)
    - `bh.overflow`: The overflow bin (use empty end on slice for slicing instead)
  - Special actions (third item in slice)
    - `sum`: Remove axes via projection; if limits are given, use those
    - `bh.rebin(n)`: Rebin an axis
- NumPy compatibility
  - `bh.numpy` provides faster [drop in replacements](https://boost-histogram.readthedocs.io/en/latest/usage/numpy.html) for NumPy histogram functions
  - Histograms follow the buffer interface, and provide `.view()`
  - Histograms can be converted to NumPy style output tuple with `.to_numpy()`
- Details
  - All objects support copy/deepcopy/pickle
  - Fully statically typed, tested with MyPy.

</details>

## Installation

You can install this library from [PyPI](https://pypi.org/project/boost-histogram/) with pip:

```bash
python3 -m pip install boost-histogram
```

All the normal best-practices for Python apply; Pip should not be very old (Pip
9 is very old), you should be in a virtual environment, etc. Python 3.10+ is
required; for older versions of Python (3.5 and 2.7), `0.13` will be installed
instead, which is API equivalent to 1.0, but will not be gaining new features.
1.3.x was the last series to support Python 3.6. 1.4.x was the last series to
support Python 3.7. 1.5.x was the last series to support Python 3.8. 1.6.x was
the last to support Python 3.9.

#### Binaries available:

The easiest way to get boost-histogram is to use a binary wheel, which happens
when you run the above command on a supported platform. Wheels are produced using
[cibuildwheel](https://cibuildwheel.readthedocs.io/en/stable/); all common
platforms have wheels provided in boost-histogram:

| System    | Arch   | Python versions                            | PyPy versions |
| --------- | ------ | ------------------------------------------ | ------------- |
| manylinux | 64-bit | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t | 3.11          |
| manylinux | ARM64  | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t | 3.11          |
| musllinux | 64-bit | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t |               |
| macOS     | 64-bit | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t | 3.11          |
| macOS     | Arm64  | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t | 3.11          |
| Windows   | 32-bit | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t |               |
| Windows   | 64-bit | 3.10, 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t | 3.11          |
| Windows   | ARM64  | 3.11, 3.12, 3.13, 3.13t, 3.14, 3.14t       |               |

PowerPC, IBM-Z, and RISC-V wheels are not provided but are available on request.

If you are on a Linux system that is not part of the "many" in manylinux or musl in musllinux, such as ClearLinux, building from source is usually fine, since the compilers on those systems are often quite new. It will just take longer to install when it is using the sdist instead of a wheel. All dependencies are header-only and included.

#### Conda-Forge

The boost-histogram package is available on [conda-forge](https://github.com/conda-forge/boost-histogram-feedstock), as well. All supported variants are available.

```bash
conda install -c conda-forge boost-histogram
```

#### Source builds

For a source build, for example from an "SDist" package, the only requirements are a C++14 compatible compiler. The compiler requirements are dictated by Boost.Histogram's C++ requirements: gcc >= 5.5, clang >= 3.8, or msvc >= 14.1.

Boost is not required or needed (this only depends on included header-only dependencies). You can install directly from GitHub if you would like.

```bash
python -m pip install git+https://github.com/scikit-hep/boost-histogram.git@develop
```

## Developing

See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on how to set up a development environment.

## Contributors

We would like to acknowledge the contributors that made this project possible ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="http://iscinumpy.gitlab.io"><img src="https://avatars1.githubusercontent.com/u/4616906?v=4?s=100" width="100px;" alt="Henry Schreiner"/><br /><sub><b>Henry Schreiner</b></sub></a><br /><a href="#maintenance-henryiii" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/boost-histogram/commits?author=henryiii" title="Code">💻</a> <a href="https://github.com/scikit-hep/boost-histogram/commits?author=henryiii" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/HDembinski"><img src="https://avatars0.githubusercontent.com/u/2631586?v=4?s=100" width="100px;" alt="Hans Dembinski"/><br /><sub><b>Hans Dembinski</b></sub></a><br /><a href="#maintenance-HDembinski" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/boost-histogram/commits?author=HDembinski" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://lovelybuggies.github.io"><img src="https://avatars3.githubusercontent.com/u/29083689?v=4?s=100" width="100px;" alt="N!no"/><br /><sub><b>N!no</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=LovelyBuggies" title="Tests">⚠️</a> <a href="https://github.com/scikit-hep/boost-histogram/commits?author=LovelyBuggies" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jpivarski"><img src="https://avatars0.githubusercontent.com/u/1852447?v=4?s=100" width="100px;" alt="Jim Pivarski"/><br /><sub><b>Jim Pivarski</b></sub></a><br /><a href="#ideas-jpivarski" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/nsmith-"><img src="https://avatars3.githubusercontent.com/u/6587412?v=4?s=100" width="100px;" alt="Nicholas Smith"/><br /><sub><b>Nicholas Smith</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Ansmith-" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://www-pnp.physics.ox.ac.uk/~huffman/"><img src="https://avatars3.githubusercontent.com/u/45843291?v=4?s=100" width="100px;" alt="physicscitizen"/><br /><sub><b>physicscitizen</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Aphysicscitizen" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/chanchal-kumar-maji-9230a9145/"><img src="https://avatars1.githubusercontent.com/u/31502077?v=4?s=100" width="100px;" alt="Chanchal Kumar Maji"/><br /><sub><b>Chanchal Kumar Maji</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=ChanchalKumarMaji" title="Documentation">📖</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://ddavis.io/"><img src="https://avatars2.githubusercontent.com/u/3202090?v=4?s=100" width="100px;" alt="Doug Davis"/><br /><sub><b>Doug Davis</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Adouglasdavis" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/pgrimaud"><img src="https://avatars1.githubusercontent.com/u/1866496?v=4?s=100" width="100px;" alt="Pierre Grimaud"/><br /><sub><b>Pierre Grimaud</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=pgrimaud" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/beojan"><img src="https://avatars0.githubusercontent.com/u/3727925?v=4?s=100" width="100px;" alt="Beojan Stanislaus"/><br /><sub><b>Beojan Stanislaus</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Abeojan" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Popinaodude"><img src="https://avatars2.githubusercontent.com/u/20911987?v=4?s=100" width="100px;" alt="Popinaodude"/><br /><sub><b>Popinaodude</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3APopinaodude" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/colizz"><img src="https://avatars2.githubusercontent.com/u/44885400?v=4?s=100" width="100px;" alt="Congqiao Li"/><br /><sub><b>Congqiao Li</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Acolizz" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/alexander-held"><img src="https://avatars0.githubusercontent.com/u/45009355?v=4?s=100" width="100px;" alt="alexander-held"/><br /><sub><b>alexander-held</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Aalexander-held" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/chrisburr"><img src="https://avatars3.githubusercontent.com/u/5220533?v=4?s=100" width="100px;" alt="Chris Burr"/><br /><sub><b>Chris Burr</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=chrisburr" title="Documentation">📖</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://keybase.io/kgizdov"><img src="https://avatars.githubusercontent.com/u/3164953?v=4?s=100" width="100px;" alt="Konstantin Gizdov"/><br /><sub><b>Konstantin Gizdov</b></sub></a><br /><a href="#platform-kgizdov" title="Packaging/porting to new platform">📦</a> <a href="https://github.com/scikit-hep/boost-histogram/issues?q=author%3Akgizdov" title="Bug reports">🐛</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://theoryandpractice.org"><img src="https://avatars.githubusercontent.com/u/4458890?v=4?s=100" width="100px;" alt="Kyle Cranmer"/><br /><sub><b>Kyle Cranmer</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=cranmer" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://amangoel.me"><img src="https://avatars.githubusercontent.com/u/10528392?v=4?s=100" width="100px;" alt="Aman Goel"/><br /><sub><b>Aman Goel</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=amangoel185" title="Documentation">📖</a> <a href="https://github.com/scikit-hep/boost-histogram/commits?author=amangoel185" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://jay-gohil.me"><img src="https://avatars.githubusercontent.com/u/59703162?v=4?s=100" width="100px;" alt="Jay Gohil"/><br /><sub><b>Jay Gohil</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=gohil-jay" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/pfackeldey"><img src="https://avatars.githubusercontent.com/u/18463582?v=4?s=100" width="100px;" alt="Peter Fackeldey"/><br /><sub><b>Peter Fackeldey</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=pfackeldey" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jonas-eschle"><img src="https://avatars.githubusercontent.com/u/17454848?v=4?s=100" width="100px;" alt="Jonas Eschle"/><br /><sub><b>Jonas Eschle</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=jonas-eschle" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://saransh-cpp.github.io/"><img src="https://avatars.githubusercontent.com/u/74055102?v=4?s=100" width="100px;" alt="Saransh Chopra"/><br /><sub><b>Saransh Chopra</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=Saransh-cpp" title="Code">💻</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="http://www.matthewfeickert.com/"><img src="https://avatars.githubusercontent.com/u/5142394?v=4?s=100" width="100px;" alt="Matthew Feickert"/><br /><sub><b>Matthew Feickert</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=matthewfeickert" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://andrzejnovak.github.io/"><img src="https://avatars.githubusercontent.com/u/13226500?v=4?s=100" width="100px;" alt="Andrzej Novak"/><br /><sub><b>Andrzej Novak</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=andrzejnovak" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/veprbl"><img src="https://avatars.githubusercontent.com/u/245573?v=4?s=100" width="100px;" alt="Dmitry Kalinkin"/><br /><sub><b>Dmitry Kalinkin</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=veprbl" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.lieret.net/"><img src="https://avatars.githubusercontent.com/u/13602468?v=4?s=100" width="100px;" alt="Kilian Lieret"/><br /><sub><b>Kilian Lieret</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=klieret" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/riga"><img src="https://avatars.githubusercontent.com/u/1908734?v=4?s=100" width="100px;" alt="Marcel Rieger"/><br /><sub><b>Marcel Rieger</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=riga" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Superharz"><img src="https://avatars.githubusercontent.com/u/11306732?v=4?s=100" width="100px;" alt="Florian Harz"/><br /><sub><b>Florian Harz</b></sub></a><br /><a href="https://github.com/scikit-hep/boost-histogram/commits?author=Superharz" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.

## Talks and other documentation/tutorial sources

The [official documentation is here](https://boost-histogram.readthedocs.io/en/latest/index.html), and includes a [quickstart](https://boost-histogram.readthedocs.io/en/latest/usage/quickstart.html).

- [2019-4-15 IRIS-HEP Topical meeting](https://indico.cern.ch/event/803122/)
- [2019-10-17 PyHEP Histogram session](https://indico.cern.ch/event/833895/contributions/3577833/) - [repo with talks and workbook](https://github.com/henryiii/pres-bhandhist)
- [2019-11-7 CHEP](https://indico.cern.ch/event/773049/contributions/3473265/)
- [2020-07-07 SciPy](https://www.youtube.com/watch?v=ERraTfHkPd0&list=PLYx7XA2nY5GfY4WWJjG5cQZDc7DIUmn6Z&index=4)
- [2020-07-17 PyHEP](https://indico.cern.ch/event/882824/contributions/3931299/)

---

## Acknowledgements

This library was primarily developed by Henry Schreiner and Hans Dembinski.

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.

[actions-badge]: https://github.com/scikit-hep/boost-histogram/workflows/Tests/badge.svg
[actions-link]: https://github.com/scikit-hep/boost-histogram/actions
[conda-badge]: https://img.shields.io/conda/vn/conda-forge/boost-histogram
[conda-link]: https://github.com/conda-forge/boost-histogram-feedstock
[github-discussions-badge]: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
[github-discussions-link]: https://github.com/scikit-hep/boost-histogram/discussions
[gitter-badge]: https://badges.gitter.im/HSF/PyHEP-histogramming.svg
[gitter-link]: https://gitter.im/HSF/PyHEP-histogramming?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
[pypi-link]: https://pypi.org/project/boost-histogram/
[pypi-platforms]: https://img.shields.io/pypi/pyversions/boost-histogram
[pypi-version]: https://badge.fury.io/py/boost-histogram.svg
[rtd-badge]: https://readthedocs.org/projects/boost-histogram/badge/?version=latest
[rtd-link]: https://boost-histogram.readthedocs.io/en/latest/?badge=latest
[sk-badge]: https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg
[Boost::Histogram]: https://www.boost.org/doc/libs/release/libs/histogram/doc/html/index.html
[Boost::Histogram source]: https://github.com/boostorg/histogram
[Hist]: https://github.com/scikit-hep/hist
[fastest libraries]: https://iscinumpy.gitlab.io/post/histogram-speeds-in-python/
[spec4-badge]: https://img.shields.io/badge/SPEC-4-green?labelColor=%23004811&color=%235CA038
[spec4-link]: https://scientific-python.org/specs/spec-0004/