The pyam package
================

.. figure:: https://raw.githubusercontent.com/IAMconsortium/pyam/main/docs/logos/pyam-header.png
   :width: 640px

This page collects tutorials and presentations related to the open-source Python package
**pyam** for scenario analysis & visualization.

`Read the docs <https://pyam-iamc.readthedocs.io>`_ to learn more about the package.


Intro video about the pyam package
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. raw:: html

	<iframe width="560" height="315" src="https://www.youtube.com/embed/7P6hXiVqalQ"
		title="YouTube video player" frameborder="0" allow="accelerometer; autoplay;
		clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen>
	</iframe><br />

This video is part of the `IAMC Youtube channel`_.

.. _`IAMC Youtube channel` : https://www.youtube.com/c/IAMCIntegratedAssessmentModelingConsortium

NAVIGATE-ENGAGE Summer School on Integrated Assessment Modeling (July 4, 2023)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

`Daniel Huppmann <https://www.iiasa.ac.at/staff/daniel-huppmann>`_ presented an overview
and live demo of the **pyam** package at the
`NAVIGATE-ENGAGE Summer School on Integrated Assessment Modeling`_ (July 2023).

 - Presentation slides: https://doi.org/10.5281/zenodo.8112529
 - Tutorial notebook: https://github.com/danielhuppmann/ENGAGE-pyam-tutorial (release 2.0)

.. _`NAVIGATE-ENGAGE Summer School on Integrated Assessment Modeling` : https://www.engage-climate.org/navigate-engage-summer-school-2023/

European Climate and Energy Modelling Platform 2022 (October 6, 2022)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This “Skills Workshop” at the `European Climate and Energy Modelling Platform 2022`_ conference (ECEMP) covered how
to use the pyam package for simple scenario analysis, data visualization and computation
of derived indicators. In addition, it was shown how to load scenario data directly from
an IIASA Scenario Explorer instance (e.g., the scenario ensemble supporting the IPCC AR6
WG3 report) into a Python computing environment for processing and analysis.

.. raw:: html

	<iframe width="560" height="315" src="https://www.youtube.com/embed/74Eyn39IVpo"
		title="YouTube video player" frameborder="0" allow="accelerometer; autoplay;
		clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen>
	</iframe><br />

**Related material:**

 - Presentation slides: https://zenodo.org/record/7150257 and
 - Tutorial notebook: https://github.com/phackstock/ECEMP-pyam-tutorial

.. _`European Climate and Energy Modelling Platform 2022` : https://ecemp2022.b2match.io/

ENGAGE Capacity Building Workshop (February 1, 2022)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

At a capacity-building workshop on good modeling practices
organized by the `Horizon 2020 project ENGAGE`_ on February 1, 2022,
`Daniel Huppmann <https://www.iiasa.ac.at/staff/daniel-huppmann>`_ and
`Philip Hackstock <https://iiasa.ac.at/staff/philip-hackstock>`_
presented an overview and live demo of the **pyam** package.

 - Presentation slides: https://pure.iiasa.ac.at/id/eprint/17783
 - Tutorial notebook: https://github.com/danielhuppmann/ENGAGE-pyam-tutorial (release 1.0)

.. _`Horizon 2020 project ENGAGE` : https://www.engage-climate.org/capacity-building-workshop-1-february-2022/

Presentation at the *Strommarkttreffen* (July 14, 2021)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

At an online meeting of the Strommarkttreffen_ on July 14, 2021,
Daniel Huppmann presented an overview and live demo of the **pyam** package.

 - Presentation slides (german/english): https://pure.iiasa.ac.at/id/eprint/17319
 - Tutorial notebook (english): https://github.com/danielhuppmann/strommarkttreffen-pyam

.. _Strommarkttreffen : https://www.strommarkttreffen.org/online/