.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "gallery/plot_pie.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_pie.py>`
        to download the full example code

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

.. _sphx_glr_gallery_plot_pie.py:


========================
Pie chart visualizations
========================

.. GENERATED FROM PYTHON SOURCE LINES 7-10

.. code-block:: Python


    # sphinx_gallery_thumbnail_number = 3








.. 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/latest/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 pie chart of the energy supply
********************************

We generate a pie plot of all components of primary energy supply
for one scenario.

.. GENERATED FROM PYTHON SOURCE LINES 35-48

.. code-block:: Python


    data = df.filter(
        model="AIM/CGE 2.1",
        scenario="CD-LINKS_NPi",
        variable="Primary Energy|*",
        year=2050,
        region="World",
    )

    data.plot.pie()
    plt.tight_layout()
    plt.show()




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





.. GENERATED FROM PYTHON SOURCE LINES 49-53

A pie chart with a legend
*************************

Sometimes a legend is preferable to labels, so we can use that instead.

.. GENERATED FROM PYTHON SOURCE LINES 53-58

.. code-block:: Python


    data.plot.pie(labels=None, legend=True)
    plt.tight_layout()
    plt.show()




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





.. GENERATED FROM PYTHON SOURCE LINES 59-65

A pie chart of regional contributions
*************************************

We don't just have to plot subcategories of variables,
any data or meta indicators from the IamDataFrame can be used.
Here, we show the contribution by region to CO2 emissions.

.. GENERATED FROM PYTHON SOURCE LINES 65-72

.. code-block:: Python


    data = df.filter(
        model="AIM/CGE 2.1", scenario="CD-LINKS_NPi", variable="Emissions|CO2", year=2050
    ).filter(region="World", keep=False)
    data.plot.pie(category="region", cmap="tab20")
    plt.tight_layout()
    plt.show()



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






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

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


.. _sphx_glr_download_gallery_plot_pie.py:

.. only:: html

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

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

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

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

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


.. only:: html

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

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