genno: efficient, transparent calculation on N-D data

genno is a Python package for describing and executing complex calculations on labelled, multi-dimensional data. It aims to make these calculations efficient, transparent, modular, and easily validated as part of scientific research.

genno is built on high-quality Python data packages including dask, xarray, pandas, pint, and sparse; and provides (current or planned) compatibility with packages including plotnine, sdmx1, matplotlib, ixmp, and pyam.

User guide

• Concepts and usage
  • Quantity
  • Key
  • Computer
  • Describe tasks
  • Execute tasks
  • Operators
• Configuration
  • Overview
  • Specific sections
• Caching
  • Basics
  • Cache data loaded from files
  • Integrate and extend
  • Internals and utilities

API reference

• Top-level classes and functions
• Operators
• Quantity classes
• Utilities and compatibility
• Test and documentation utilities

Compatibility

genno provides built-in support for interaction with:

• Plotnine (plotnine), via compat.plotnine.

• Pyam (pyam: analysis and visualization  of integrated-assessment & macro-energy scenarios), via compat.pyam.

• SDMX (sdmx), via compat.sdmx.

Packages that extend genno include:

• ixmp.report

• message_ix.report

• message_ix_models.report

Development

• What’s new
• Releasing

License

Copyright © 2018–2026 genno contributors.

Licensed under the GNU General Public License, version 3.0.

Name

A 玄能 (genno or gennoh) is a type of hammer used in Japanese woodworking. The package name is warning, by reference, to the adage “When you hold a hammer, every problem looks like a nail”: you shouldn’t hit everything with genno, but it is still a useful and versatile tool.

Indices and tables

• Index

• Module Index

• Search Page