nomenclature - Working with IAMC-format project definitions
Copyright 2021-2023 IIASA
This repository is licensed under the Apache License, Version 2.0 (the "License"); see the LICENSE for details.
Overview
The nomenclature package facilitates validation and processing of scenario data. It allows managing definitions of data structures for model comparison projects and scenario analysis studies using the data format developed by the Integrated Assessment Modeling Consortium (IAMC).
A data structure definition consists of one or several "codelists". A codelist is a list of allowed values (or "codes") for dimensions of IAMC-format data, typically regions and variables. Each code can have additional attributes: for example, a "variable" has to have an expected unit and usually has a description. Read the SDMX Guidelines for more information on the concept of codelists.
The nomenclature package supports three main use cases:
- Management of codelists and mappings for model comparison projects
- Validation of scenario data against the codelists of a specific project
- Processing of scenario results, e.g. aggregation and renaming from "native regions" of a model to "common regions" (i.e., regions that are used for scenario comparison in a project).
The documentation is hosted on Read the Docs.
Integration with the pyam package
The nomenclature package is designed to complement the Python package pyam, an open-source community toolbox for analysis & visualization of scenario data. The pyam package was developed to facilitate working with timeseries scenario data conforming to the format developed by the IAMC. It is used in ongoing assessments by the IPCC and in many model comparison projects at the global and national level, including several Horizon 2020 & Horizon Europe projects.
The validation and processing features of the nomenclature package work with scenario data as a pyam.IamDataFrame object.
Read the pyam Docs for more information!
Getting started
To install the latest release of the package, please use the following command:
pip install nomenclature-iamc
Alternatively, it can also be installed directly from source:
pip install -e git+https://github.com/IAMconsortium/nomenclature#egg=nomenclature-iamc
See the User Guide for the main use cases of this package.
Acknowledgement
This package is based on the work initially done in the Horizon 2020 openENTRANCE project, which aims to develop, use and disseminate an open, transparent and integrated modelling platform for assessing low-carbon transition pathways in Europe.
Refer to the openENTRANCE/openentrance repository for more information.
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nomenclature_iamc-0.31.1.tar.gz.
File metadata
- Download URL: nomenclature_iamc-0.31.1.tar.gz
- Upload date:
- Size: 53.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb4d3c8b9a8c9224f64e284d7be8a94128c4e437ae3f3563848f3fd2896e8be0
|
|
| MD5 |
dcab9561fcaad12c4773d0854fd26421
|
|
| BLAKE2b-256 |
e62c2fc9a331b7a1c609d2cdb53e28507091f2286cb8811c73bf1b4d4a2d86eb
|
Provenance
The following attestation bundles were made for nomenclature_iamc-0.31.1.tar.gz:
Publisher:
publish.yaml on IAMconsortium/nomenclature
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nomenclature_iamc-0.31.1.tar.gz -
Subject digest:
fb4d3c8b9a8c9224f64e284d7be8a94128c4e437ae3f3563848f3fd2896e8be0 - Sigstore transparency entry: 2340392977
- Sigstore integration time:
-
Permalink:
IAMconsortium/nomenclature@ab556eefe57328e01728645760921c4e8613ad61 -
Branch / Tag:
refs/tags/v0.31.1 - Owner: https://github.com/IAMconsortium
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@ab556eefe57328e01728645760921c4e8613ad61 -
Trigger Event:
release
-
Statement type:
File details
Details for the file nomenclature_iamc-0.31.1-py3-none-any.whl.
File metadata
- Download URL: nomenclature_iamc-0.31.1-py3-none-any.whl
- Upload date:
- Size: 63.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea5da64d15606e5a7a73d4af6309fe06a3517bba7673ee46982aa3608b020445
|
|
| MD5 |
d8fa37f9048d13ae9b59b7b4cf0891ae
|
|
| BLAKE2b-256 |
0b6b505fa543c9d04ab06b687b6ab48dcf3d3a393f5a152dada18c2e93236947
|
Provenance
The following attestation bundles were made for nomenclature_iamc-0.31.1-py3-none-any.whl:
Publisher:
publish.yaml on IAMconsortium/nomenclature
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nomenclature_iamc-0.31.1-py3-none-any.whl -
Subject digest:
ea5da64d15606e5a7a73d4af6309fe06a3517bba7673ee46982aa3608b020445 - Sigstore transparency entry: 2340392990
- Sigstore integration time:
-
Permalink:
IAMconsortium/nomenclature@ab556eefe57328e01728645760921c4e8613ad61 -
Branch / Tag:
refs/tags/v0.31.1 - Owner: https://github.com/IAMconsortium
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yaml@ab556eefe57328e01728645760921c4e8613ad61 -
Trigger Event:
release
-
Statement type:
