This is the accompanying repository for the Bloomberg Global Coal Countdown (BGCC) website.
Data Sources
The data presented on the BGCC website comes from the following sources:
- Global Energy Monitor's (GEM) Global Coal Plant Tracker (GCPT) and the accompanying GCPT status changes since 2015. GEM's GCPT dataset provides unit-level data and it is the basis for all calculations related to coal-plant capacity, status, technology and age.
- Country-level coal phaseout strategies, country-level expected retirements and global emission pathways from University of Maryland's (UMD) Center for Global Sustainability (CGS). Datasets from UMD are outputs from published research, and are therefore mostly served as is with very few modifications for aesthetic purposes such as smooth interpolation.
- Ember's Global Electricity Review 2021 data. Ember's dataset provides panel data over three dimensions, namely area (such as country and regions), year and variable (such as energy sources). It is used as the basis for all calculations related to energy mixes and trends.
- In the Headlines content is scraped from CoalWire, published by GEM. A CoalWire issue consists of multiple articles, news and analysis pieces, which are individually presented on the BGCC site.
- Research and analysis pieces as curated by Bloomberg Philanthropies.
- Gapminder data, HYDE, and UN Population Division (2019) estimates as presented by Our World in Data's (OWD) world population data since 1800. This dataset is used for per-capita calculations with simple extrapolations for 2020.
- Natural Earth Data's country vectors as presented by Graydon Hoare with our own manual modifications for aesthetic reasons in order to make the interactive map appear more presentable.
- Country commitments to phasing out coal as well as no new coal are based on research from UMD CGS and the Powering Past Coal Alliance (PPCA).
- Expected retirements by 2030 of each country are collected and maintained by PPCA.
The countries’ political affiliations such as EU27+1, G20, G7, OECD and PPCA are taken as of July 2021. We have decided to include the United Kingdom into the EU27+1 list in order to maintain comparability with other EU figures that have been reported in the past.
Dashboard Data
The resulting datasets are available for download as part of a release attached to the repository - see Releases.
The following JSONs correspond to a page on the BGCC website:
coal_capacity_landscape.jsoncoal_power_generation.jsoncountry_main.jsonhomepage.jsonnewsfeed.json
The following JSONs are utility lookup datasets:
country_coal_status.jsoncountry_iso_lookup.jsoniso_country_lookup.jsonwebsite_texts.json
The mapbox.json data is uploaded one feature at a time to Mapbox using the Mapbox API. The country_bounding_boxes.json is used to center the map view on the selected country.
Schema and Validation
Each JSON file is accompanied by a Pydantic model, which is used as a schema documentation and runtime validation. The Pydantic models can be found in schema/models.py. The source code references two other files, namely schema/validation.py and schema/enum_key_value_pairs.py, which contain custom validators and valid country names and the corresponding ISO 3166-1 alpha-2 country codes.
In the docker directory, we make available a Dockerfile and a requirements.txt to build an ephemeral Docker container, which we used to generate the data at the time writing.
License
As the datasets are built upon the GEM's GCPT dataset, the BGCC datasets are also licensed under the CC BY-SA 4.0 license. Therefore, it is allowed to copy and redistribute, as well as to build upon the datasets for any purpose including for commercial purposes. If you do build upon the datasets, you must distribute it under the same license.
19 Jun 3, 2021
7 Dec 14, 2022
1 May 1, 2022
3 Nov 8, 2022
2 Oct 24, 2021
2 Oct 31, 2021
1 Nov 1, 2021
5 Mar 26, 2022
2 Nov 11, 2021
0 Aug 04, 2022
3 Jan 18, 2022
52 Jan 03, 2023
125 Dec 21, 2022
38 Jan 06, 2023
1 Apr 25, 2022
2 Dec 13, 2021
13 May 10, 2022
2 May 02, 2022
2 Apr 15, 2022
8 Oct 14, 2022
11 Dec 10, 2022
11 May 15, 2022
1 Dec 26, 2021
2 Mar 09, 2022
18 Aug 03, 2022
19 Apr 24, 2022
8 Apr 04, 2022
3 Jan 04, 2022
3 Jan 27, 2022