.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "example_gallery/1d_hist/1d_side_by_side.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_example_gallery_1d_hist_1d_side_by_side.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_example_gallery_1d_hist_1d_side_by_side.py:


Side-by-side categories
=======================

Plot multiple 1D histograms with categories side by side.

.. GENERATED FROM PYTHON SOURCE LINES 7-59



.. image-sg:: /example_gallery/1d_hist/images/sphx_glr_1d_side_by_side_001.svg
   :alt: 1d side by side
   :srcset: /example_gallery/1d_hist/images/sphx_glr_1d_side_by_side_001.svg
   :class: sphx-glr-single-img





.. code-block:: Python


    ###
    import boost_histogram as bh
    import matplotlib.pyplot as plt
    import numpy as np

    from plothist import plot_hist

    rng = np.random.default_rng(8311311)

    # String categories
    categories = ["A", "B", "C"]

    # Axis with the 3 bins
    axis = bh.axis.StrCategory(categories=categories)

    ## Works also with integers
    # categories = [-5, 10, 137]
    # axis = bh.axis.IntCategory(categories=categories)

    # Generate data for 3 histograms
    data = [
        rng.choice(categories, 20),
        rng.choice(categories, 30),
        rng.choice(categories, 40),
    ]

    # Create and fill the histograms
    histos = [bh.Histogram(axis, storage=bh.storage.Weight()) for _ in range(len(data))]
    histos = [histo.fill(data[i]) for i, histo in enumerate(histos)]

    labels = [f"$h_{{{i}}}$" for i in range(len(histos))]

    # Plot the histogram
    fig, ax = plt.subplots()

    # Use a specificity of matplotlib: when a list of histograms is given, it will plot them side by side unless stacked=True or histtype is a "step" type.
    plot_hist(histos, ax=ax, label=labels)

    # Set the x-ticks to the middle of the bins and label them
    ax.set_xlim(0, len(categories))
    ax.set_xticks([i + 0.5 for i in range(len(categories))])
    ax.set_xticklabels(categories)
    ax.minorticks_off()
    # Get nice looking y-axis ticks
    ax.set_ylim(top=int(np.max([np.max(histo.values()) for histo in histos]) * 1.5))

    ax.set_xlabel("Category")
    ax.set_ylabel("Entries")
    ax.legend()

    fig.savefig("1d_side_by_side.svg", bbox_inches="tight")


.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 0.197 seconds)


.. _sphx_glr_download_example_gallery_1d_hist_1d_side_by_side.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: 1d_side_by_side.ipynb <1d_side_by_side.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: 1d_side_by_side.py <1d_side_by_side.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: 1d_side_by_side.zip <1d_side_by_side.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_