{"id":16744933,"url":"https://github.com/sphericalpm/ghgdata","last_synced_at":"2025-11-01T08:30:27.554Z","repository":{"id":222729901,"uuid":"108664647","full_name":"sphericalpm/ghgdata","owner":"sphericalpm","description":"Greenhouse gas emissions data packaged for easy exploration and charting","archived":false,"fork":false,"pushed_at":"2017-10-31T11:24:51.000Z","size":48,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-13T01:44:23.787Z","etag":null,"topics":["climate","climate-change","climate-data","ghg","ghg-data","open-data","opendata"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sphericalpm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2017-10-28T16:19:28.000Z","updated_at":"2022-11-07T14:42:23.000Z","dependencies_parsed_at":"2024-02-15T22:45:43.985Z","dependency_job_id":null,"html_url":"https://github.com/sphericalpm/ghgdata","commit_stats":null,"previous_names":["sphericalpm/ghgdata"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sphericalpm%2Fghgdata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sphericalpm%2Fghgdata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sphericalpm%2Fghgdata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sphericalpm%2Fghgdata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sphericalpm","download_url":"https://codeload.github.com/sphericalpm/ghgdata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239265811,"owners_count":19610235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["climate","climate-change","climate-data","ghg","ghg-data","open-data","opendata"],"created_at":"2024-10-13T01:44:19.710Z","updated_at":"2025-11-01T08:30:27.506Z","avatar_url":"https://github.com/sphericalpm.png","language":"Python","funding_links":[],"categories":["GHG Emissions"],"sub_categories":["Financial Literacy"],"readme":"# GHG Data\n\n## What is this?\nGHG Data is a dataset compiled out of national greenhouse gas (GHG) inventory submissions by \n[Annex I](http://unfccc.int/parties_and_observers/parties/annex_i/items/2774.php) Parties to \n[UNFCCC](http://unfccc.int). The primary purpose of this dataset is to simplify comparison and charting of GHG\ndata on a single-variable level. \n\n## How do I access GHG Data? \nData is available on Amazon S3, in JSON format, one file per inventory variable. The URL format is \n \nhttp://ghg-data.s3-website.eu-central-1.amazonaws.com/VARIABLE-UID.json\n\nThe uid should be CAPITALIZED. \n\nThe response is JSON in the following format: \n\n```json\n{\"years\":[\"list\",\"of\",\"years\"],\n \"series\":{\n  \"\u003cparty-code\u003e\":[\"list\",\"of\",\"values\"]}\n}\n```\nWhere: \n\n* `\"list\",\"of\",\"years\"` is a list of strings with year names (brows back down and see below in gotchas) sorted alphabetically\n* `party-code` is a three-letter code of the Party. In most cases, but not always, this is an [ISO ALPHA-3](https://www.iso.org/obp/ui/#search) code.\n* `\"list\",\"of\",\"values\"` is a list of record values sorted according to the years in `\"list\",\"of\",\"years\"`\n\n### Where do I get the variable uid? \n\nThis is outside of the scope of this README. The short answer is that all variables are defined in UNFCCC metadata \navailable [here](https://confluence.unfccc.int/download/attachments/17137769/meta_data_6.0.3.xml.zip).\nIf you are a user of UNFCCC CRF Reporter, you may see variable UIDs when you export reporting tables with uids. \nIf you are a user of Spherical's [National Inventory System](http://nis.spherical.pm), you will find uids of variables\non cell info boxes on all data entry and reporting views. If you are neither, making sense of variable uids is not easy.\n[Ask Spherical](mailto:support@spherical.pm), we will help. \n\n### Gotchas\n_\"Life is really simple, but we insist on making it complicated\"_ - Confucius\n\n#### Non-numeric year names\nYears are not numbered but rather named. This is because Parties are free to name their reporting years the way they \nlike, and Hungary used this freedom to name one of their years \"1985-1987\". In addition to that, there is a year that is\nused as baseline for calculating the Party's performance in GHG reduction. This year is named \"Base Year\". Most of the \ntime, you will not be needing these years but you'll need to filter them out on your side.\n \n#### Non-ISO country codes\n\nMost country codes are ISO country codes. A UNFCCC-invented three-letter codes are used where an ISO country code \nis not available for a reporting entity. In particular:  \n\n* Sub-countries reporting separately:\n  * Belgium: `BRU` is Brussels, `WAL` is Wallonia, `FLA` is Flanders\n  * UK: `GBE` is UK excluding overseas territories that are not part of EU\n* Countries reporting under the Convention and under the Kyoto Protocol separately:\n  * Denmark: `DKE` is for the 1st commitment period of the Kyoto Protocol, `DNM` is for the 2nd\n  * France: `FRK` is France's report under the Kyoto Protocol\n  * UK: `GBK` is UK's report under the Kyoto Protocol\n* Non-countries considered Parties to UNFCCC\n  * EU: `EUA` is European Union, `EUC` is European Union's report under the Kyoto Protocol\n\n#### Funny numbers\n\nAll numbers in the inventory are floating point numbers, with \n[all floating number fun to be expected](https://docs.oracle.com/cd/E19957-01/806-3568/ncg_goldberg.html). In addition\nto that, some data may be a result of complex calculations in national or UN software that are not rounded \nproperly to make sense. Do not be surprised to see a country reporting a quarter of a cow and handle it appropriately\nin your solutions.   \n\n#### Nulls\nAccording to the rules, complete GHG inventories shall not have empty records or zeroes. At the same time, there is a \nnumber of situations when a record does not contain a valid numeric value:\n* The variable is non-numeric\n* The Party could not report a number for some reason (the data point is zero, confidential, included in another \nvariable or unavailable)\n* The year is not applicable for the Party\n\nIn these cases the dataset will include `null` for the record. GHG management software usually treats most of such\nrecords as zeroes. \n\n## How fresh is the dataset? \n\nThe dataset is based on the latest 2017 GHG inventory submissions.\n\n## Come on, give me some uids to test my charts!\n\nSure! \n* [F05D8EF0-CD04-4769-81BE-303183271230](http://ghg-data.s3-website.eu-central-1.amazonaws.com/F05D8EF0-CD04-4769-81BE-303183271230.json) - Total direct national emissions in `kt CO2 equivalent`\n* [B3C6CE61-81BF-440C-A5EC-3451AB9205B8](http://ghg-data.s3-website.eu-central-1.amazonaws.com/B3C6CE61-81BF-440C-A5EC-3451AB9205B8.json) - Total Methane emissions in `kt`\n* [1D3FFBBD-28D5-4AD6-A543-9C6CC01B3F3B](http://ghg-data.s3-website.eu-central-1.amazonaws.com/1D3FFBBD-28D5-4AD6-A543-9C6CC01B3F3B.json) - Emissions from agriculture in `kt CO2 equivalent`\n* [A4543811-91B0-4DE7-B239-83F43DF6DF4E](http://ghg-data.s3-website.eu-central-1.amazonaws.com/A4543811-91B0-4DE7-B239-83F43DF6DF4E.json) - Emissions from waste in `kt CO2 equivalent`\n* [A5A0958C-BDF7-43CA-BE3C-EB76B9A24348](http://ghg-data.s3-website.eu-central-1.amazonaws.com/A5A0958C-BDF7-43CA-BE3C-EB76B9A24348.json) - Number of sheep in the country :) in `thousands`\n\nA simple [matplotlib](http://matplotlib.org)-based demo in [chart.py](https://github.com/sphericalpm/ghgdata/blob/master/chart.py) shows the great progress of EU countries in \nreducing Methane emissions: \n\n![Methane Down](https://raw.githubusercontent.com/sphericalpm/ghgdata/master/images/methane_down.png)\n \n\n## Legal status of this data\nAll data is produced by national governments and officially reported to the UN. Data is further dedicated to public \ndomain by UNFCCC. This work, presented by [Spherical](http://www.spherical.pm), is a repackaging of public domain \ndata which Spherical further dedicates to public domain. Important notes: \n* Although data has not been modified, no warranty of any kind is provided as to its accuracy, authenticity or integrity. \n**This is not an official source**. If you require officially sourced data, you will need to source it from the respective\nnational government or [from UNFCCC directly](http://unfccc.int/national_reports/annex_i_ghg_inventories/national_inventories_submissions/items/10116.php).\n* Continuous availability of data is not pledged. The service may be interrupted or discontinued without notice. \n* Programming errors and irregularities in the original dataset may have led to errors in this data. No responsibility\nis assumed for such errors. If you believe that you have found an error, please let us know.\n* We also reserve the right to change the API at any moment and without notice. Such changes will be made primarily to \nenrich data offered and therefore have backward compatibility. If you are using the dataset, you are advised to program \nyour solutions in a way that they are tolerant to the expansion of the schema and changes to data volume.\n\n \n ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsphericalpm%2Fghgdata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsphericalpm%2Fghgdata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsphericalpm%2Fghgdata/lists"}