Commonly used codes, categories, terminologies, and nomenclatures used in climate policy analysis in a nice Python package. The documentation can be found at: https://climate-categories.readthedocs.io.
| Name | Title |
| IPCC1996 | IPCC GHG emission categories (1996) |
| IPCC2006 | IPCC GHG emission categories (2006) |
| IPCC2006_PRIMAP | IPCC GHG emission categories (2006) with additional categories |
| CRF1999 | Common Reporting Format GHG emissions categories (1999) |
| CRF2013 | Common Reporting Format GHG emissions categories (2013) |
| CRF2013_2021 | CRF categories extended with country specific categories from 2021 submissions |
| CRF2013_2022 | CRF categories extended with country specific categories from 2022 submissions |
| CRF2013_2023 | CRF categories extended with country specific categories from 2023 submissions |
| BURDI | BUR GHG emission categories (DI query interface) |
| BURDI_class | BUR GHG emission categories (DI query interface) + classifications |
| CRFDI | CRF GHG emission categories (DI query interface) |
| CRFDI_class | CRF GHG emission categories (DI query interface) + classifications |
| GCB | Global Carbon Budget CO2 emission categories |
| RCMIP | RCMIP emissions categories |
| gas | Gases and other climate-forcing substances |
| ISO3 | Countries and other areas from ISO 3166-1, with options for country groups, see below |
| ISO3_GROUPS | ISO3 with EU, UNFCCC and Paris Agreement parties, country groups, and historical countries |
| ISO3_GCAM | ISO3 with EU, UNFCCC and Paris Agreement parties, country groups, historical countries, Kosovo, and regions used by the GCAM integrated assessment model |
| ISO3_PRIMAP2 | ISO3_GROUPS with the countries and territories as used by primap2: Palestine included in Israel, territories included in their sovereign country if its inventory covers them, without unpopulated territories |
| ISO3_PRIMAP1 | ISO3_GROUPS with the countries, territories, and regions of PRIMAP-hist up to v2.x |
| ISO3_PRIMAP1_INPUTS | ISO3_PRIMAP1 with the regions of the IPCC AR5, the RCPs, and EDGAR-HYDE, the areas of CEDS, and the codes of the PRIMAP-hist v2.x input data |
| FAO | FAOSTAT climate change agrifood systems GHG emissions categories |
| CT | Climate Trace categories |
Some categorizations have options, which add or remove categories. For example,
climate_categories.cats["ISO3[EU,UNFCCC]"] or equivalently
climate_categories.ISO3.with_options(["EU", "UNFCCC"]) gives the ISO 3166-1 countries
together with the European Union and the parties to the UNFCCC.
climate_categories.ISO3.available_options lists the options and
climate_categories.ISO3.supported_combinations lists the quality-controlled
combinations of options. Aliases like ISO3_GROUPS name commonly used combinations
of options; note that the options of an alias can be extended in later versions.
You can also apply your own options to any categorization using
Categorization.apply, or share them as a file with a base field naming the
categorization they extend, which climate_categories.load_extension reads and
applies. Several extensions of the same categorization can be loaded together, and later
extensions can require earlier ones.
- IPCC1996 <-> IPCC2006
- FAO <-> IPCC2006_PRIMAP
- CT <-> IPCC2006_PRIMAP
Climate categories is still in development and the API and names of categorizations are still subject to change.
Copyright 2021, Potsdam-Institut für Klimafolgenforschung e.V.
Copyright 2021, Robert Gieseke
Copyright 2023-2025, Climate Resource Pty Ltd
Copyright 2026, Climate Resource S GmbH
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
If you use this library and want to cite it, please cite it as:
Mika Pflüger, Daniel Busch, Annika Günther, Johannes Gütschow, and Robert Gieseke. (2026-09-24). primap-community/climate_categories: climate_categories Version 0.15.0. Zenodo. https://doi.org/10.5281/zenodo.22943797