Documentation: https://software.ene.iiasa.ac.at/pyam Questions? Start a discussion on our listserv

The pyam package provides a range of diagnostic tools and functions for analyzing and working with IAMC-format timeseries data.

Features:

• Summary of models, scenarios, variables, and regions included in a snapshot.
• Display of timeseries data as pandas.DataFrame with IAMC-specific filtering options.
• Simple visualization and plotting functions.
• Diagnostic checks for non-reported variables or timeseries data to identify outliers and potential reporting issues.
• Categorization of scenarios according to timeseries data or meta-identifiers for further analysis.

The package can be used with timeseries data that follows the data template convention of the Integrated Assessment Modeling Consortium (IAMC). An illustrative example is shown below; see data.ene.iiasa.ac.at/database for more information.

A comprehensive tutorial for the basic functions is included in tutorial/pyam_first_steps using a partial snapshot of the IPCC AR5 scenario database.

The documentation pages can be built locally. See the instruction in doc/README.

This package was developed and is currently maintained by Matthew Gidden (@gidden) and Daniel Huppmann (@danielhuppmann).

Copyright 2017-2018 IIASA Energy Program

The pyam package is licensed under the Apache License, Version 2.0 (the "License"); see LICENSE and NOTICE for details.

For basic instructions see our website.

To install from source after cloning this repository, simply run

pip install -e .

Development +++++++++++

To setup a development environment,

# pyam can be replaced with any other name
# you don't have to specify your python version if you don't want
conda create --name pip pyam python=X.Y.Z
conda activate pyam  # may be source activate pyam or just activate pyam
pip install -e .[tests,docs,deploy]
# install other required packages (e.g. on a Unix like system)
conda install -c conda-forge $(cat requirements.txt)
# by hand also works e.g.
conda install -c conda-forge cartopy geopandas
# if you want to write notebooks
pip install notebook nbconvert jupyter_contrib_nbextensions

To check everything has installed correctly,

pytest tests

All the tests should pass.