pyam: analysis and visualization of assessment models

Release v0.2.0.

Documentation Status pypi conda license latest

travis appveyor coveralls

joss doi

The pyam Python package provides a range of diagnostic tools and functions for analyzing and visualizing data from your favorite assessment model(s).

The source code for pyam is available on Github.


Some of the pyam features include:
  • Easily filter and manipulate data in the IAMC timeseries format

  • An interface similar in feel and style to pandas.DataFrame

  • Advanced visualization and plotting functions.

  • Diagnostic checks for non-reported variables or timeseries values to analyze and validate scenario data.

  • Categorization of scenarios according to timeseries data or metadata for further analysis.

After installing, check out our tutorials or our plotting gallery to get started.

Have a question? Get in touch!

  • Report bugs, suggest features or view the source code on GitHub.

  • For less well defined questions or ideas, use the mailing list.

Interested in Contributing? Welcome to the team!

The pyam package has been developed with the explicit aim to facilitate open and collaborative analysis of integrated assessment and climate models. We appreciate contributions to the code base and development of new features.

Please use the GitHub Issues feature to raise questions concerning potential bugs or to propose new features, but search and read resolved/closed topics on similar subjects before raising a new issue.

For contributions to the code base, please use GitHub Pull Requests, including a detailed description of the new feature and unit tests to illustrate the intended functionality. Code submitted via pull requests must adhere to the pep8 style formats.

We do not require anyone to sign a Contributor License Agreement, because we believe that when posting ideas or submitting code to an open-source project, it should be obvious and self-evident that any such contributions are made in the spirit of open collaborative development.


pyam is available under the open source Apache License.