UNFCCC DI API

Data access to the total greenhouse gas emissions by country reported to the United Nations Framework Convention on Climate Change (UNFCCC).
https://github.com/primap-community/unfccc_di_api

Category: Emissions
Sub Category: Emission Observation and Modeling

Keywords

climate-data unfccc

Keywords from Contributors

energy-system-modelling energy-system climate-change climate-policy accessor

Last synced: about 14 hours ago
JSON representation

Repository metadata

Python wrapper around the Flexible Query API of the UNFCCC.

README.rst

          =============
UNFCCC DI API
=============


.. image:: https://img.shields.io/pypi/v/unfccc_di_api.svg
        :target: https://pypi.python.org/pypi/unfccc_di_api
        :alt: PyPI release

.. image:: https://readthedocs.org/projects/unfccc-di-api/badge/?version=main
        :target: https://unfccc-di-api.readthedocs.io/en/main/
        :alt: Documentation

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


Python wrapper around the `Flexible Query API `_ of
the UNFCCC.


* Free software: Apache Software License 2.0
* Documentation: https://unfccc-di-api.readthedocs.io.

Warning
-------

Due to a recent change in the UNFCCC's API, the UNFCCCApiReader class is
**not functional** any more in standard environments. To continue to access the data,
you have two options:

1. Use the new ZenodoReader. It provides access using the `query` function like the
   UNFCCCApiReader, but only supports querying for a full dataset with all data. It
   relies on our `data package `_, which we
   update regularly; however, the data is naturally not as recent as querying from
   the API directly.
2. Run your functions in an environment which is not blocked by the UNFCCC DI API.
   According to our tests, Azure virtual machines work, as well as github hosted
   runners, with the exception of Mac OS runners.


Features
--------

* High-level API to query all information for a given party.
* Low-level API to selectively query information with the same resolution as in the
  UNFCCC web query tool.

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

Mika Pflüger, Daniel Huppmann & Johannes Gütschow. (2024-01-08).
pik-primap/unfccc_di_api: Version 4.0.4.
Zenodo. https://doi.org/10.5281/zenodo.10471122

Data package
------------
If you just want all the data in CSV and parquet format (suitable for reading with
pandas), look at our `data package `_.

CI status and other links
-------------------------

.. image:: https://results.pre-commit.ci/badge/github/pik-primap/unfccc_di_api/main.svg
   :target: https://results.pre-commit.ci/latest/github/pik-primap/unfccc_di_api/main
   :alt: pre-commit.ci status

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 271
Total Committers: 3
Avg Commits per committer: 90.333
Development Distribution Score (DDS): 0.509

Commits in past year: 51
Committers in past year: 2
Avg Commits per committer in past year: 25.5
Development Distribution Score (DDS) in past year: 0.176

Name Email Commits
Mika Pflüger m****r@p****e 133
pre-commit-ci[bot] 6****] 130
Daniel Huppmann dh@d****t 8

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 5
Total pull requests: 115
Average time to close issues: about 1 month
Average time to close pull requests: 2 days
Total issue authors: 4
Total pull request authors: 2
Average comments per issue: 9.2
Average comments per pull request: 0.56
Merged pull request: 112
Bot issues: 0
Bot pull requests: 106

Past year issues: 1
Past year pull requests: 42
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 2 days
Past year issue authors: 1
Past year pull request authors: 1
Past year average comments per issue: 2.0
Past year average comments per pull request: 0.0
Past year merged pull request: 42
Past year bot issues: 0
Past year bot pull requests: 42

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/primap-community/unfccc_di_api

Top Issue Authors

  • JGuetschow (2)
  • mfastudillo (1)
  • danielhuppmann (1)
  • mikapfl (1)

Top Pull Request Authors

  • pre-commit-ci[bot] (106)
  • mikapfl (9)

Top Issue Labels

  • bug (2)

Top Pull Request Labels


Dependencies

docs/requirements.txt pypi
  • ipykernel *
  • nbsphinx *
.github/workflows/ci.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v2 composite
pyproject.toml pypi
requirements.txt pypi
requirements_dev.txt pypi
setup.py pypi

Score: 3.1780538303479453