Metadata-Version: 2.1
Name: hist
Version: 2.0.0
Summary: Hist classes and utilities
Home-page: https://github.com/scikit-hep/hist
Author: Henry Schreiner
Author-email: henry.schreiner@cern.ch
Maintainer: The Scikit-HEP admins
Maintainer-email: scikit-hep-admins@googlegroups.com
License: BSD 3-Clause License
Description: # Hist
        
        [![Github Actions badge](https://github.com/scikit-hep/hist/workflows/CI/badge.svg)](https://github.com/scikit-hep/hist/actions)
        [![Join the chat at https://gitter.im/Scikit-HEP/hist](https://badges.gitter.im/HSF/PyHEP-histogramming.svg)](https://gitter.im/HSF/PyHEP-histogramming?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        [![Scikit-HEP][sk-badge]](https://scikit-hep.org/)
        
        Hist is a analyst friendly front-end for
        [boost-histogram](https://github.com/scikit-hep/boost-histogram), designed for
        Python 3.6+.
        
        ## Installation
        
        You can install this library from [PyPI](https://pypi.org/project/hist/) with pip:
        
        ```bash
        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
        
        ```python
        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:
        
        ```bash
        python -m pip install -e .[dev]
        ```
        
        See [CONTRIBUTING.md](./.github/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](https://allcontributors.org/docs/en/emoji-key)):
        
        <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
        <!-- prettier-ignore-start -->
        <!-- markdownlint-disable -->
        <table>
          <tr>
            <td align="center"><a href="http://iscinumpy.gitlab.io"><img src="https://avatars1.githubusercontent.com/u/4616906?v=4" width="100px;" alt=""/><br /><sub><b>Henry Schreiner</b></sub></a><br /><a href="#maintenance-henryiii" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/hist/commits?author=henryiii" title="Code">💻</a> <a href="https://github.com/scikit-hep/hist/commits?author=henryiii" title="Documentation">📖</a></td>
            <td align="center"><a href="https://github.com/lovelybuggies"><img src="https://avatars3.githubusercontent.com/u/29083689?v=4" width="100px;" alt=""/><br /><sub><b>Nino Lau</b></sub></a><br /><a href="#maintenance-lovelybuggies" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/hist/commits?author=lovelybuggies" title="Code">💻</a><a href="https://github.com/scikit-hep/hist/commits?author=lovelybuggies" title="Documentation">📖</a></td>
          </tr>
        </table>
        
        <!-- markdownlint-enable -->
        <!-- prettier-ignore-end -->
        <!-- ALL-CONTRIBUTORS-LIST:END -->
        
        This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
        
        ## Talks
        
        * [2020-07-07 SciPy Proceedings](https://www.youtube.com/watch?v=ERraTfHkPd0&list=PLYx7XA2nY5GfY4WWJjG5cQZDc7DIUmn6Z&index=4)
        * [2020-07-17 PyHEP2020](https://indico.cern.ch/event/882824/contributions/3931299/)
        
        ---
        
        ## 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.
        
        [sk-badge]: https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg
        
Keywords: histogram,boost-histogram
Platform: Any
Classifier: Topic :: Scientific/Engineering
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: plot
Provides-Extra: test
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: all
