climate-categories


Nameclimate-categories JSON
Version 0.10.1 PyPI version JSON
download
home_pagehttps://github.com/pik-primap/climate_categories
SummaryCommonly used codes, categories, terminologies, and nomenclatures used in climate policy analysis as a Python package.
upload_time2024-01-25 16:27:59
maintainer
docs_urlNone
authorMika Pflüger
requires_python>=3.9
licenseApache Software License 2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ==================
Climate categories
==================


.. image:: https://img.shields.io/pypi/v/climate_categories.svg
        :target: https://pypi.python.org/pypi/climate_categories

.. image:: https://readthedocs.org/projects/climate-categories/badge/?version=latest
        :target: https://climate-categories.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4590232.svg
        :target: https://doi.org/10.5281/zenodo.4590232

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.

Included categorizations
------------------------

===============  ==================================================================
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, country groups, and other areas from ISO 3166
ISO3_GCAM        dito, plus regions used by the GCAM integrated assessment model
===============  ==================================================================

Included conversions between categorizations
--------------------------------------------

* IPCC1996 <-> IPCC2006

Status
------
Climate categories is still in development and the API and names of categorizations
are still subject to change.

License
-------
Copyright 2021, Potsdam-Institut für Klimafolgenforschung e.V.

Copyright 2021, Robert Gieseke

Copyright 2023-2024, Climate Resource Pty Ltd

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.

Citation
--------
If you use this library and want to cite it, please cite it as:

Mika Pflüger, Annika Günther, Johannes Gütschow, and Robert Gieseke. (2024-01-25).
pik-primap/climate_categories: climate_categories Version 0.10.1.
Zenodo. https://doi.org/10.5281/zenodo.10569100

=========
Changelog
=========

0.10.1 (2024-01-25)
-------------------
 * ISO3_GCAM: Removed extraneous "v" from version specifications in region codes

0.10.0 (2024-01-25)
-------------------
 * Added ISO3_GCAM categorization which contains regions used in the integrated assessment model GCAM.

0.9.2 (2023-06-22)
------------------
* ISO3: Add all parties to the UNFCCC as direct children of UNFCCC as first set of
  children. That way, it is easy to ergonomically get all parties to the UNFCCC without
  adding up Annex-I and Non-Annex-I parties manually.

0.9.1 (2023-06-15)
------------------
* Add AOSIS country group to ISO3 categorization.

0.9.0 (2023-06-14)
------------------
* Add ISO3 terminology for countries, areas, and country groups including UNFCCC
  signatories and Annex-I and Non-Annex-I groups and the evolution of the EU over time.

0.8.5 (2023-05-23)
------------------
* Re-release again.

0.8.4 (2023-05-23)
------------------
* Re-release to make sure py.typed is included in built package.

0.8.3 (2023-05-23)
------------------
* add py.typed file to announce this library is using type hints.

0.8.2 (2023-05-15)
------------------
* Remove pygments-csv-lexer dependency for docs building.
* Add function to find leaf children of a category, useful for re-calculating top-level
  categories from constituents.

0.8.1 (2023-04-26)
------------------
* regenerate data included in the package to benefit
  from latest fixes in data generation scripts.

0.8.0 (2023-04-26)
------------------
* Add updated CRF2013 terminologies for 2021, 2022, and 2023 submission rounds
* The unfccc DI API recently returns unspecified measure IDs.
  data_generation/CRFDI_class.py was fixed to ignore them.
* Add CRF2013 terminology for data submitted by AnnexI countries to the UNFCCC
* Drop support for Python 3.7 and 3.8, add support for Python 3.11

0.7.1 (2021-11-25)
------------------
* Change conversion metadata format to use comment chars and a YAML header.

0.7.0 (2021-11-25)
------------------
* Use Python files instead of pickle objects for caching

0.6.3 (2021-11-05)
------------------
* Export Category and HierarchicalCategory types.
* Add ConversionRule.is_restricted attribute to easily check if a rule is restricted to
  specific auxiliary categories.

0.6.2 (2021-11-05)
------------------
* Export Conversion and ConversionRule types.

0.6.1 (2021-11-04)
------------------
* Add emissions categorization from the `Reduced Complexity Model Intercomparison Project (RCMIP) <https://www.rcmip.org/>`_. Thanks to Robert Gieseke for the contribution and Zeb Nicholls for input.

0.6.0 (2021-10-22)
------------------
* Automate changelog generation from snippets - avoids resolving merge conflicts
  manually
* Automate github releases.
* Add category "0" (National total) to IPCC1996 and IPCC2006 categorizations. While it
  is not in the official specification, it is widely used and adding it also enables
  automatically assigning a level to all other categories.
* Add categorization CRF1999 used within in the common reporting framework data.
* Refactor rendering of large categorizations using ``show_as_tree()``, adding more
  clarity to alternative child sets. Add usage documentation for ``show_as_tree()``.
  Thanks to Robert Gieseke for feedback.
* Fixes for IPCC2006 categorization (and IPCC2006_PRIMAP):

  - proper title for category 3.B.3.a "Grassland Remaining Grassland"
  - correct corresponding 1996 category for category 1.A.4.c.ii

* Fixes for IPCC1996 categorization:

  - category 4.B.10 has the correct title "Anaerobic Lagoons"
  - correct usage of units in the titles of categories 4.C.3.a and 4.C.3.b

* Add mechanism to describe conversions between categorizations.
* Add conversion between IPCC2006 and IPCC1996.
* Add algorithm to detect over counting in conversions between categorizations.
* Refactor generation of IPCC2006 and IPCC1996 categorizations.
* Add function to find unmapped categories in a conversion.

0.5.4 (2021-10-18)
------------------

* Add Global Carbon Budget categorization.

0.5.3 (2021-10-12)
------------------

* Add gas categorization which includes commonly used climate forcing substances.

0.5.2 (2021-05-18)
------------------

* Add IPCC2006_PRIMAP categorization.
* Add refrigerant sub-classes and additional codes to CRFDI_class.

0.5.1 (2021-05-04)
------------------

* Add BURDI, CRFDI, BURDI_class, and CRFDI_class categorizations and scripts to generate
  them from the UNFCCC DI flexible query API.

0.5.0 (2021-03-23)
------------------

* Switch ``to_yaml()`` output to ruamel.yaml so that valid, correctly typed YAML 1.2
  is written. This should enable easier re-use of the data in other contexts.
* Consistently use title case for titles in IPCC categorizations.

0.4.0 (2021-03-17)
------------------

* Add more unit tests.
* Add consistency tests for IPCC categorizations.
* Update documentation.
* Add data format documentation.

0.3.2 (2021-03-16)
------------------

* Use tbump for simpler versioning.

0.3.1 (2021-03-16)
------------------

* Properly include data files in binary releases.

0.3.0 (2021-03-16)
------------------

* Add IPCC1996 categorization and scripts to generate it from the source pdf.
* Change packaging to declarative style.
* Automate generation of pickled files via Makefile.
* Automate loading of included categorizations.

0.2.2 (2021-03-09)
------------------

* Re-release again to trigger zenodo.

0.2.1 (2021-03-09)
------------------

* Re-release to include correct changelog.

0.2.0 (2021-03-09)
------------------

* Introduce API for multiple codes and multiple children.
* Implement classes and functions.
* Add IPCC2006 categorization and scripts to generate it from the source pdf.

0.1.0 (2021-01-18)
------------------

* First release on PyPI.
* Contains documentation and a stub API for querying, but no working code yet.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pik-primap/climate_categories",
    "name": "climate-categories",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "",
    "author": "Mika Pfl\u00fcger",
    "author_email": "mika.pflueger@climate-resource.com",
    "download_url": "https://files.pythonhosted.org/packages/22/99/67f9ad072623e2b4ba489c832b58f61badae71dbc93472523e375832970d/climate_categories-0.10.1.tar.gz",
    "platform": null,
    "description": "==================\nClimate categories\n==================\n\n\n.. image:: https://img.shields.io/pypi/v/climate_categories.svg\n        :target: https://pypi.python.org/pypi/climate_categories\n\n.. image:: https://readthedocs.org/projects/climate-categories/badge/?version=latest\n        :target: https://climate-categories.readthedocs.io/en/latest/?badge=latest\n        :alt: Documentation Status\n\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4590232.svg\n        :target: https://doi.org/10.5281/zenodo.4590232\n\nCommonly used codes, categories, terminologies, and nomenclatures used in climate\npolicy analysis in a nice Python package.\nThe documentation can be found at: https://climate-categories.readthedocs.io.\n\nIncluded categorizations\n------------------------\n\n===============  ==================================================================\nName             Title\n---------------  ------------------------------------------------------------------\nIPCC1996         IPCC GHG emission categories (1996)\nIPCC2006         IPCC GHG emission categories (2006)\nIPCC2006_PRIMAP  IPCC GHG emission categories (2006) with additional categories\nCRF1999          Common Reporting Format GHG emissions categories (1999)\nCRF2013          Common Reporting Format GHG emissions categories (2013)\nCRF2013_2021     CRF categories extended with country specific categories from\n                 2021 submissions\nCRF2013_2022     CRF categories extended with country specific categories from\n                 2022 submissions\nCRF2013_2023     CRF categories extended with country specific categories from\n                 2023 submissions\nBURDI            BUR GHG emission categories (DI query interface)\nBURDI_class      BUR GHG emission categories (DI query interface) + classifications\nCRFDI            CRF GHG emission categories (DI query interface)\nCRFDI_class      CRF GHG emission categories (DI query interface) + classifications\nGCB              Global Carbon Budget CO2 emission categories\nRCMIP            RCMIP emissions categories\ngas              Gases and other climate-forcing substances\nISO3             Countries, country groups, and other areas from ISO 3166\nISO3_GCAM        dito, plus regions used by the GCAM integrated assessment model\n===============  ==================================================================\n\nIncluded conversions between categorizations\n--------------------------------------------\n\n* IPCC1996 <-> IPCC2006\n\nStatus\n------\nClimate categories is still in development and the API and names of categorizations\nare still subject to change.\n\nLicense\n-------\nCopyright 2021, Potsdam-Institut f\u00fcr Klimafolgenforschung e.V.\n\nCopyright 2021, Robert Gieseke\n\nCopyright 2023-2024, Climate Resource Pty Ltd\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this\nfile except in compliance with the License. You may obtain a copy of the License at\n\nhttps://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\nKIND, either express or implied. See the License for the specific language governing\npermissions and limitations under the License.\n\nCitation\n--------\nIf you use this library and want to cite it, please cite it as:\n\nMika Pfl\u00fcger, Annika G\u00fcnther, Johannes G\u00fctschow, and Robert Gieseke. (2024-01-25).\npik-primap/climate_categories: climate_categories Version 0.10.1.\nZenodo. https://doi.org/10.5281/zenodo.10569100\n\n=========\nChangelog\n=========\n\n0.10.1 (2024-01-25)\n-------------------\n * ISO3_GCAM: Removed extraneous \"v\" from version specifications in region codes\n\n0.10.0 (2024-01-25)\n-------------------\n * Added ISO3_GCAM categorization which contains regions used in the integrated assessment model GCAM.\n\n0.9.2 (2023-06-22)\n------------------\n* ISO3: Add all parties to the UNFCCC as direct children of UNFCCC as first set of\n  children. That way, it is easy to ergonomically get all parties to the UNFCCC without\n  adding up Annex-I and Non-Annex-I parties manually.\n\n0.9.1 (2023-06-15)\n------------------\n* Add AOSIS country group to ISO3 categorization.\n\n0.9.0 (2023-06-14)\n------------------\n* Add ISO3 terminology for countries, areas, and country groups including UNFCCC\n  signatories and Annex-I and Non-Annex-I groups and the evolution of the EU over time.\n\n0.8.5 (2023-05-23)\n------------------\n* Re-release again.\n\n0.8.4 (2023-05-23)\n------------------\n* Re-release to make sure py.typed is included in built package.\n\n0.8.3 (2023-05-23)\n------------------\n* add py.typed file to announce this library is using type hints.\n\n0.8.2 (2023-05-15)\n------------------\n* Remove pygments-csv-lexer dependency for docs building.\n* Add function to find leaf children of a category, useful for re-calculating top-level\n  categories from constituents.\n\n0.8.1 (2023-04-26)\n------------------\n* regenerate data included in the package to benefit\n  from latest fixes in data generation scripts.\n\n0.8.0 (2023-04-26)\n------------------\n* Add updated CRF2013 terminologies for 2021, 2022, and 2023 submission rounds\n* The unfccc DI API recently returns unspecified measure IDs.\n  data_generation/CRFDI_class.py was fixed to ignore them.\n* Add CRF2013 terminology for data submitted by AnnexI countries to the UNFCCC\n* Drop support for Python 3.7 and 3.8, add support for Python 3.11\n\n0.7.1 (2021-11-25)\n------------------\n* Change conversion metadata format to use comment chars and a YAML header.\n\n0.7.0 (2021-11-25)\n------------------\n* Use Python files instead of pickle objects for caching\n\n0.6.3 (2021-11-05)\n------------------\n* Export Category and HierarchicalCategory types.\n* Add ConversionRule.is_restricted attribute to easily check if a rule is restricted to\n  specific auxiliary categories.\n\n0.6.2 (2021-11-05)\n------------------\n* Export Conversion and ConversionRule types.\n\n0.6.1 (2021-11-04)\n------------------\n* Add emissions categorization from the `Reduced Complexity Model Intercomparison Project (RCMIP) <https://www.rcmip.org/>`_. Thanks to Robert Gieseke for the contribution and Zeb Nicholls for input.\n\n0.6.0 (2021-10-22)\n------------------\n* Automate changelog generation from snippets - avoids resolving merge conflicts\n  manually\n* Automate github releases.\n* Add category \"0\" (National total) to IPCC1996 and IPCC2006 categorizations. While it\n  is not in the official specification, it is widely used and adding it also enables\n  automatically assigning a level to all other categories.\n* Add categorization CRF1999 used within in the common reporting framework data.\n* Refactor rendering of large categorizations using ``show_as_tree()``, adding more\n  clarity to alternative child sets. Add usage documentation for ``show_as_tree()``.\n  Thanks to Robert Gieseke for feedback.\n* Fixes for IPCC2006 categorization (and IPCC2006_PRIMAP):\n\n  - proper title for category 3.B.3.a \"Grassland Remaining Grassland\"\n  - correct corresponding 1996 category for category 1.A.4.c.ii\n\n* Fixes for IPCC1996 categorization:\n\n  - category 4.B.10 has the correct title \"Anaerobic Lagoons\"\n  - correct usage of units in the titles of categories 4.C.3.a and 4.C.3.b\n\n* Add mechanism to describe conversions between categorizations.\n* Add conversion between IPCC2006 and IPCC1996.\n* Add algorithm to detect over counting in conversions between categorizations.\n* Refactor generation of IPCC2006 and IPCC1996 categorizations.\n* Add function to find unmapped categories in a conversion.\n\n0.5.4 (2021-10-18)\n------------------\n\n* Add Global Carbon Budget categorization.\n\n0.5.3 (2021-10-12)\n------------------\n\n* Add gas categorization which includes commonly used climate forcing substances.\n\n0.5.2 (2021-05-18)\n------------------\n\n* Add IPCC2006_PRIMAP categorization.\n* Add refrigerant sub-classes and additional codes to CRFDI_class.\n\n0.5.1 (2021-05-04)\n------------------\n\n* Add BURDI, CRFDI, BURDI_class, and CRFDI_class categorizations and scripts to generate\n  them from the UNFCCC DI flexible query API.\n\n0.5.0 (2021-03-23)\n------------------\n\n* Switch ``to_yaml()`` output to ruamel.yaml so that valid, correctly typed YAML 1.2\n  is written. This should enable easier re-use of the data in other contexts.\n* Consistently use title case for titles in IPCC categorizations.\n\n0.4.0 (2021-03-17)\n------------------\n\n* Add more unit tests.\n* Add consistency tests for IPCC categorizations.\n* Update documentation.\n* Add data format documentation.\n\n0.3.2 (2021-03-16)\n------------------\n\n* Use tbump for simpler versioning.\n\n0.3.1 (2021-03-16)\n------------------\n\n* Properly include data files in binary releases.\n\n0.3.0 (2021-03-16)\n------------------\n\n* Add IPCC1996 categorization and scripts to generate it from the source pdf.\n* Change packaging to declarative style.\n* Automate generation of pickled files via Makefile.\n* Automate loading of included categorizations.\n\n0.2.2 (2021-03-09)\n------------------\n\n* Re-release again to trigger zenodo.\n\n0.2.1 (2021-03-09)\n------------------\n\n* Re-release to include correct changelog.\n\n0.2.0 (2021-03-09)\n------------------\n\n* Introduce API for multiple codes and multiple children.\n* Implement classes and functions.\n* Add IPCC2006 categorization and scripts to generate it from the source pdf.\n\n0.1.0 (2021-01-18)\n------------------\n\n* First release on PyPI.\n* Contains documentation and a stub API for querying, but no working code yet.\n",
    "bugtrack_url": null,
    "license": "Apache Software License 2.0",
    "summary": "Commonly used codes, categories, terminologies, and nomenclatures used in climate policy analysis as a Python package.",
    "version": "0.10.1",
    "project_urls": {
        "Documentation": "https://climate-categories.readthedocs.io/",
        "Homepage": "https://github.com/pik-primap/climate_categories"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4ec26a86cdfffd6161b16f49b7e5553e0d751477ff6178a4799a13a22fe6a145",
                "md5": "39336096a78afc17ceebd9c96c725da0",
                "sha256": "b9d71a84cc566bc7dee2fcd2859c812763506a1195ef1036da97d4ba4156a9e3"
            },
            "downloads": -1,
            "filename": "climate_categories-0.10.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "39336096a78afc17ceebd9c96c725da0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 617861,
            "upload_time": "2024-01-25T16:27:56",
            "upload_time_iso_8601": "2024-01-25T16:27:56.149272Z",
            "url": "https://files.pythonhosted.org/packages/4e/c2/6a86cdfffd6161b16f49b7e5553e0d751477ff6178a4799a13a22fe6a145/climate_categories-0.10.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "229967f9ad072623e2b4ba489c832b58f61badae71dbc93472523e375832970d",
                "md5": "db96af304e70318eb7101d009cf3c2df",
                "sha256": "ef25fbd80f47bff7d850dc478121421a2e28c955a2b1552fa15394d7561f9f88"
            },
            "downloads": -1,
            "filename": "climate_categories-0.10.1.tar.gz",
            "has_sig": false,
            "md5_digest": "db96af304e70318eb7101d009cf3c2df",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 660494,
            "upload_time": "2024-01-25T16:27:59",
            "upload_time_iso_8601": "2024-01-25T16:27:59.006638Z",
            "url": "https://files.pythonhosted.org/packages/22/99/67f9ad072623e2b4ba489c832b58f61badae71dbc93472523e375832970d/climate_categories-0.10.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-25 16:27:59",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pik-primap",
    "github_project": "climate_categories",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "climate-categories"
}
        
Elapsed time: 0.18811s