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

.. only:: html

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

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

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

.. _sphx_glr_gallery_plot_boxplot.py:


==============
Boxplot charts
==============

.. GENERATED FROM PYTHON SOURCE LINES 7-10

.. code-block:: Python


    # sphinx_gallery_thumbnail_number = 2








.. GENERATED FROM PYTHON SOURCE LINES 11-21

Read in tutorial data and show a summary
****************************************

This gallery uses the scenario data from the first-steps tutorial.

If you haven't cloned the **pyam** GitHub repository to your machine,
you can download the file from
https://github.com/IAMconsortium/pyam/tree/main/docs/tutorials.

Make sure to place the data file in the same folder as this script/notebook.

.. GENERATED FROM PYTHON SOURCE LINES 21-29

.. code-block:: Python


    import matplotlib.pyplot as plt

    import pyam

    df = pyam.IamDataFrame("tutorial_data.csv")
    df





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

 .. code-block:: none

    /home/docs/checkouts/readthedocs.org/user_builds/pyam-iamc/checkouts/stable/pyam/utils.py:318: FutureWarning:

    The previous implementation of stack is deprecated and will be removed in a future version of pandas. See the What's New notes for pandas 2.1.0 for details. Specify future_stack=True to adopt the new implementation and silence this warning.


    <class 'pyam.core.IamDataFrame'>
    Index:
     * model    : AIM/CGE 2.1, GENeSYS-MOD 1.0, ... WITCH-GLOBIOM 4.4 (8)
     * scenario : 1.0, CD-LINKS_INDCi, CD-LINKS_NPi, ... Faster Transition Scenario (8)
    Timeseries data coordinates:
       region   : R5ASIA, R5LAM, R5MAF, R5OECD90+EU, R5REF, R5ROWO, World (7)
       variable : ... (6)
       unit     : EJ/yr, Mt CO2/yr, °C (3)
       year     : 2010, 2020, 2030, 2040, 2050, 2060, 2070, 2080, ... 2100 (10)



.. GENERATED FROM PYTHON SOURCE LINES 30-35

A boxplot of CO emissions
*************************

We generate a simple boxplot of CO2 emissions
across one scenario implemented by a range of models.

.. GENERATED FROM PYTHON SOURCE LINES 35-44

.. code-block:: Python


    data = df.filter(
        scenario="CD-LINKS_NPi2020_1000", variable="Emissions|CO2", region="World"
    )

    data.plot.box(x="year")
    plt.tight_layout()
    plt.show()




.. image-sg:: /gallery/images/sphx_glr_plot_boxplot_001.png
   :alt: plot boxplot
   :srcset: /gallery/images/sphx_glr_plot_boxplot_001.png
   :class: sphx-glr-single-img


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

 .. code-block:: none

    No artists with labels found to put in legend.  Note that artists whose label start with an underscore are ignored when legend() is called with no argument.




.. GENERATED FROM PYTHON SOURCE LINES 45-49

A grouped boxplot
*****************

We can add sub-groupings of the data using the keyword argument `by`.

.. GENERATED FROM PYTHON SOURCE LINES 49-62

.. code-block:: Python


    data = df.filter(
        scenario="CD-LINKS_NPi2020_1000",
        variable="Emissions|CO2",
        year=[2010, 2020, 2030, 2050, 2100],
    ).filter(region="World", keep=False)

    data.plot.box(x="year", by="region", legend=True)

    # We can use matplotlib arguments to make the figure more appealing.
    plt.legend(loc=1)
    plt.tight_layout()
    plt.show()



.. image-sg:: /gallery/images/sphx_glr_plot_boxplot_002.png
   :alt: plot boxplot
   :srcset: /gallery/images/sphx_glr_plot_boxplot_002.png
   :class: sphx-glr-single-img






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

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


.. _sphx_glr_download_gallery_plot_boxplot.py:

.. only:: html

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

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

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

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

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


.. only:: html

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

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