Analysis & visualization of integrated-assessment scenarios
pyam: analysis & visualization
of integrated-assessment scenarios
Documentation on Read the Docs
Questions? Start a discussion on our mailing list
Overview and scope
The open-source Python package pyam provides a suite of tools and functions for analyzing and visualizing input data (i.e., assumptions/parametrization) and results (model output) of integrated-assessment scenarios.
- Simple analysis of timeseries data in the IAMC format (more about it here) with an interface similar in feel and style to the widely used pandas.DataFrame
- Advanced visualization and plotting functions (see the gallery)
- Diagnostic checks for scripted validation of scenario data and results
An illustrative example of the timeseries format developed by the
Integrated Assessment Modeling Consortium (IAMC)
is shown below.
The row is taken from the IAMC 1.5°C scenario explorer,
showing a scenario from the CD-LINKS project.
Read the docs
for more information on the IAMC format and the
pyam data model.
|MESSAGE||CD-LINKS 400||World||Primary Energy||EJ/y||462.5||500.7||...|
An introduction to the basic functions is shown in the "first-steps" notebook.
All tutorials are available in rendered format (i.e., with output) as part of the online documentation. The source code of the tutorials notebooks is available in the folder doc/source/tutorials of this repository.
The complete documentation is hosted on Read the Docs.
The documentation pages can be built locally, refer to the instruction in doc/README.
Authors & Contributors
See the complete list of contributors.
Copyright 2017-2021 IIASA and the pyam developer team
For basic instructions, read the docs.
To install from source after cloning this repository, simply run
pip install -e .
To setup a development environment, the simplest route is to make yourself
a conda environment and then follow the
# 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 pyam pip python=X.Y.Z conda activate pyam # may be simply `source activate pyam` or just `activate pyam` # use the make file to create your development environment # (you only require the -B flag the first time, thereafter you can # just run `make virtual-environment` and it will only update if # environment definition files have been updaed) make -B virtual-environment
Instead of conda you could also use a pip virtualenv:
mkdir venv virtualenv venv -p python3 . venv/bin/activate pip install -e .[test,optional-io-formats]
To check everything has installed correctly, run
All the tests should pass.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size pyam_iamc-0.10.0-py2.py3-none-any.whl (75.6 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
Hashes for pyam_iamc-0.10.0-py2.py3-none-any.whl