Usage

To download the data from Zenodo, import the package and instantiate the reader, which will download the most recent dataset:

import unfccc_di_api

reader = unfccc_di_api.ZenodoReader()

Downloading data from 'doi:10.5281/zenodo.8159736/parquet-only.zip' to file '/home/docs/.cache/pooch/6cbac6b9311f7f1a769cb6fd88ca56cf-parquet-only.zip'.

Check for which parties data is available:

reader.parties

['AUS',
 'AUT',
 'BEL',
 'BGR',
 'BLR',
 'CAN',
 'CHE',
 'CYP',
 'CZE',
 'DEU',
 'DNK',
 'ESP',
 'EST',
 'EUA',
 'FIN',
 'FRA',
 'GBR',
 'GRC',
 'HRV',
 'HUN',
 'IRL',
 'ISL',
 'ITA',
 'JPN',
 'KAZ',
 'LIE',
 'LTU',
 'LUX',
 'LVA',
 'MCO',
 'MLT',
 'NLD',
 'NOR',
 'NZL',
 'POL',
 'PRT',
 'ROU',
 'RUS',
 'SVK',
 'SVN',
 'SWE',
 'TUR',
 'UKR',
 'USA',
 'AFG',
 'AGO',
 'ALB',
 'AND',
 'ARE',
 'ARG',
 'ARM',
 'ATG',
 'AZE',
 'BDI',
 'BEN',
 'BFA',
 'BGD',
 'BHR',
 'BHS',
 'BIH',
 'BLZ',
 'BOL',
 'BRA',
 'BRB',
 'BRN',
 'BTN',
 'BWA',
 'CAF',
 'CHL',
 'CHN',
 'CIV',
 'CMR',
 'COD',
 'COG',
 'COK',
 'COL',
 'COM',
 'CPV',
 'CRI',
 'CUB',
 'DJI',
 'DMA',
 'DOM',
 'DZA',
 'ECU',
 'EGY',
 'ERI',
 'ETH',
 'FJI',
 'FSM',
 'GAB',
 'GEO',
 'GHA',
 'GIN',
 'GMB',
 'GNB',
 'GNQ',
 'GRD',
 'GTM',
 'GUY',
 'HND',
 'HTI',
 'IDN',
 'IND',
 'IRN',
 'IRQ',
 'ISR',
 'JAM',
 'JOR',
 'KEN',
 'KGZ',
 'KHM',
 'KIR',
 'KNA',
 'KOR',
 'KWT',
 'LAO',
 'LBN',
 'LBR',
 'LBY',
 'LCA',
 'LKA',
 'LSO',
 'MAR',
 'MDA',
 'MDG',
 'MDV',
 'MEX',
 'MHL',
 'MKD',
 'MLI',
 'MMR',
 'MNE',
 'MNG',
 'MOZ',
 'MRT',
 'MUS',
 'MWI',
 'MYS',
 'NAM',
 'NER',
 'NGA',
 'NIC',
 'NIU',
 'NPL',
 'NRU',
 'OMN',
 'PAK',
 'PAN',
 'PER',
 'PHL',
 'PLW',
 'PNG',
 'PRK',
 'PRY',
 'PSE',
 'QAT',
 'RWA',
 'SAU',
 'SDN',
 'SEN',
 'SGP',
 'SLB',
 'SLE',
 'SLV',
 'SMR',
 'SOM',
 'SRB',
 'SSD',
 'STP',
 'SUR',
 'SWZ',
 'SYC',
 'SYR',
 'TCD',
 'TGO',
 'THA',
 'TJK',
 'TKM',
 'TLS',
 'TON',
 'TTO',
 'TUN',
 'TUV',
 'TZA',
 'UGA',
 'URY',
 'UZB',
 'VCT',
 'VEN',
 'VNM',
 'VUT',
 'WSM',
 'YEM',
 'ZAF',
 'ZMB',
 'ZWE']

Access all data for a specific party:

reader.query(party_code="AFG")

	party	category	classification	measure	gas	unit	year	numberValue	stringValue
0	AFG	1. Energy	Total for category	Net emissions/removals	Aggregate GHGs	Gg CO2 equivalent	2005	3776.15946	None
1	AFG	1. Energy	Total for category	Net emissions/removals	Aggregate GHGs	Gg CO2 equivalent	2013	10343.00000	None
2	AFG	1. Energy	Total for category	Net emissions/removals	CH4	Gg	2005	35.06076	None
3	AFG	1. Energy	Total for category	Net emissions/removals	CH4	Gg	2013	4.00000	None
4	AFG	1. Energy	Total for category	Net emissions/removals	CO	Gg	2005	865.20000	None
...	...	...	...	...	...	...	...	...	...
382	AFG	unknown category nr. 10504	Total for category	Total population	No gas	thousands	2017	28224.32300	None
383	AFG	unknown category nr. 10504	Total for category	Total population	No gas	thousands	2018	30075.01800	None
384	AFG	unknown category nr. 10504	Total for category	Total population	No gas	thousands	2019	30725.56000	None
385	AFG	unknown category nr. 10504	Total for category	Total population	No gas	thousands	2020	31390.17100	None
386	AFG	unknown category nr. 10504	Total for category	Total population	No gas	thousands	2021	32069.16000	None

387 rows × 9 columns

You can also request data directly form the UNFCCC DI API if you have a way to get access. Check the API docs section (next section), or the docstrings of UNFCCCApiReader for details.