.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "examples/dataset/visualization/plot_bars.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

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

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

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

.. _sphx_glr_examples_dataset_visualization_plot_bars.py:


Bars
====

.. GENERATED FROM PYTHON SOURCE LINES 26-38

.. code-block:: Python


    from __future__ import annotations

    from numpy import array

    from gemseo import configure_logger
    from gemseo.datasets.dataset import Dataset
    from gemseo.post.dataset.bars import BarPlot

    configure_logger()






.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    <RootLogger root (INFO)>



.. GENERATED FROM PYTHON SOURCE LINES 39-43

Build a dataset
---------------
Let us consider two series of values for the variables *x1*, *x2* and *x3*
which we arrange in rows in a :class:`.Dataset`:

.. GENERATED FROM PYTHON SOURCE LINES 43-50

.. code-block:: Python

    dataset = Dataset()
    dataset.add_variable("x1", array([[0.25, 0.35], [0.75, 0.85]]))
    dataset.add_variable("x2", array([[0.5], [0.5]]))
    dataset.add_variable("x3", array([[0.75], [0.25]]))
    dataset.index = ["series_1", "series_2"]
    dataset






.. raw:: html

    <div class="output_subarea output_html rendered_html output_result">
    <div>
    <style scoped>
        .dataframe tbody tr th:only-of-type {
            vertical-align: middle;
        }

        .dataframe tbody tr th {
            vertical-align: top;
        }

        .dataframe thead tr th {
            text-align: left;
        }
    </style>
    <table border="1" class="dataframe">
      <thead>
        <tr>
          <th>GROUP</th>
          <th colspan="4" halign="left">parameters</th>
        </tr>
        <tr>
          <th>VARIABLE</th>
          <th colspan="2" halign="left">x1</th>
          <th>x2</th>
          <th>x3</th>
        </tr>
        <tr>
          <th>COMPONENT</th>
          <th>0</th>
          <th>1</th>
          <th>0</th>
          <th>0</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th>series_1</th>
          <td>0.25</td>
          <td>0.35</td>
          <td>0.5</td>
          <td>0.75</td>
        </tr>
        <tr>
          <th>series_2</th>
          <td>0.75</td>
          <td>0.85</td>
          <td>0.5</td>
          <td>0.25</td>
        </tr>
      </tbody>
    </table>
    </div>
    </div>
    <br />
    <br />

.. GENERATED FROM PYTHON SOURCE LINES 51-55

Plot the two series on a bar chart
----------------------------------
We can use the :class:`.BarPlot` to display these series,
with one color per series and the values grouped by variable name:

.. GENERATED FROM PYTHON SOURCE LINES 55-58

.. code-block:: Python

    plot = BarPlot(dataset, n_digits=2)
    plot.colormap = "PiYG"
    plot.execute(save=False, show=True)



.. image-sg:: /examples/dataset/visualization/images/sphx_glr_plot_bars_001.png
   :alt: plot bars
   :srcset: /examples/dataset/visualization/images/sphx_glr_plot_bars_001.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    [<Figure size 640x480 with 1 Axes>]




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

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


.. _sphx_glr_download_examples_dataset_visualization_plot_bars.py:

.. only:: html

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

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

      :download:`Download Jupyter notebook: plot_bars.ipynb <plot_bars.ipynb>`

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

      :download:`Download Python source code: plot_bars.py <plot_bars.py>`


.. only:: html

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

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