• Stars
    star
    267
  • Rank 152,730 (Top 4 %)
  • Language
    Python
  • Created about 4 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Data on energy by Our World in Data

Data on Energy by Our World in Data

Our complete Energy dataset is a collection of key metrics maintained by Our World in Data. It is updated regularly and includes data on energy consumption (primary energy, per capita, and growth rates), energy mix, electricity mix and other relevant metrics.

The complete Our World in Data Energy dataset

🗂️ Download our complete Energy dataset : CSV | XLSX | JSON

The CSV and XLSX files follow a format of 1 row per location and year. The JSON version is split by country, with an array of yearly records.

The variables represent all of our main data related to energy consumption, energy mix, electricity mix as well as other variables of potential interest.

We will continue to publish updated data on energy as it becomes available. Most metrics are published on an annual basis.

A full codebook is made available, with a description and source for each variable in the dataset.

Our source data and code

The dataset is built upon a number of datasets and processing steps:

Additionally, to construct region aggregates and variables per capita and per GDP, we use the following datasets and processing steps:

Changelog

  • On July 7, 2023:
    • Replaced BP's data by the new Energy Institute Statistical Review of World Energy 2023.
    • Updated Ember's yearly electricity data.
    • Updated all datasets accordingly.
  • On June 1, 2023:
    • Updated Ember's yearly electricity data.
    • Renamed countries 'East Timor' and 'Faroe Islands', and added 'Middle East (Ember)'.
    • Population and per capita variables are now calculated using an updated version of our population dataset.
  • On March 1, 2023:
    • Updated Ember's yearly electricity data and fixed some minor issues.
  • On December 30, 2022:
    • Fixed some minor issues with BP's dataset. Regions like "Other North America (BP)" have been removed from the data, since, in the original Statistical Review of World Energy, these regions represented different sets of countries for different variables.
  • On December 16, 2022:
    • The column electricity_share_energy (electricity as a share of primary energy) was added to the dataset.
    • Fixed some minor inconsistencies in electricity data between Ember and BP, by prioritizing data from Ember.
    • Updated Ember's yearly electricity data.
  • On August 9, 2022:
    • All inconsistencies due to different definitions of regions among different datasets (especially Europe) have been fixed.
      • Now all regions follow Our World in Data's definitions.
      • We also include data for regions as defined in the original datasets; for example, Europe (BP) corresponds to Europe as defined by BP.
    • All data processing now occurs outside this repository; the code has been migrated to be part of the etl repository.
    • Variable fossil_cons_per_capita has been renamed fossil_elec_per_capita for consistency, since it corresponds to electricity generation.
    • The codebook has been updated following these changes.
  • On April 8, 2022:
    • Electricity data from Ember was updated (using the Global Electricity Review 2022).
    • Data on greenhouse-gas emissions in electricity generation was added (greenhouse_gas_emissions).
    • Data on emissions intensity is now provided for most countries in the world.
  • On March 25, 2022:
    • Data on net electricity imports and electricity demand was added.
    • BP data was updated (using the Statistical Review of the World Energy 2021).
    • Maddison data on GDP was updated (using the Maddison Project Database 2020).
    • EIA data on primary energy consumption was included in the dataset.
    • Some issues in the dataset were corrected (for example some missing data in production by fossil fuels).
  • On February 14, 2022:
    • Some issues were corrected in the electricity data, and the energy dataset was updated accordingly.
    • The json and xlsx dataset files were removed from GitHub in favor of an external storage service, to keep this repository at a reasonable size.
    • The carbon_intensity_elec column was added back into the energy dataset.
  • On February 3, 2022, we updated the Ember global electricity data, combined with the European Electricity Review from Ember.
    • The carbon_intensity_elec column was removed from the energy dataset (since no updated data was available).
    • Columns for electricity from other renewable sources excluding bioenergy were added (namely other_renewables_elec_per_capita_exc_biofuel, and other_renewables_share_elec_exc_biofuel).
    • Certain countries and regions have been removed from the dataset, because we identified significant inconsistencies in the original data.
  • On March 31, 2021, we updated 2020 electricity mix data.
  • On September 9, 2020, the first version of this dataset was made available.

Data alterations

  • We standardize names of countries and regions. Since the names of countries and regions are different in different data sources, we harmonize all names to the Our World in Data standard entity names.
  • We create aggregate data for regions (e.g. Africa, Europe, etc.). Since regions are defined differently by our sources, we create our own aggregates following Our World in Data region definitions.
    • We also include data for regions as defined in the original datasets; for example, Europe (EI) corresponds to Europe as defined by the Energy Institute.
  • We recalculate primary energy in terawatt-hours. The primary data sources on energy—the Energy Institute Statistical review of world energy, for example—typically report consumption in terms of exajoules. We have recalculated these figures as terawatt-hours using a conversion factor of 277.8.
  • We calculate per capita figures. All of our per capita figures are calculated from our population metric, which is included in the complete dataset.
    • We also calculate energy consumption per gdp, and include the corresponding gdp metric used in the calculation as part of the dataset.
  • We remove inconsistent data. Certain data points have been removed because their original data presented anomalies. They may be included again in further data releases if the anomalies are amended.

License

All visualizations, data, and code produced by Our World in Data are completely open access under the Creative Commons BY license. You have the permission to use, distribute, and reproduce these in any medium, provided the source and authors are credited.

The data produced by third parties and made available by Our World in Data is subject to the license terms from the original third-party authors. We will always indicate the original source of the data in our database, and you should always check the license of any such third-party data before use.

Authors

This data has been collected, aggregated, and documented by Hannah Ritchie, Pablo Rosado, Edouard Mathieu, Max Roser.

Our World in Data makes data and research on the world’s largest problems understandable and accessible. Read more about our mission.

How to cite this data?

If you are using this dataset, please cite both Our World in Data and the underlying data source(s).

Please follow the guidelines in our FAQ on how to cite our work.

More Repositories

1

covid-19-data

Data on COVID-19 (coronavirus) cases, deaths, hospitalizations, tests • All countries • Updated daily by Our World in Data
Python
5,654
star
2

owid-grapher

A platform for creating interactive data visualizations
TypeScript
1,208
star
3

owid-datasets

OWID Dataset Collection
655
star
4

co2-data

Data on CO2 and greenhouse gas emissions by Our World in Data
Python
609
star
5

notebooks

Our World In Data jupyter notebooks
HTML
74
star
6

etl

A compute graph for loading and transforming OWID's data
Python
71
star
7

owid-catalog-py

A Pythonic API for working with OWID's data catalog.
Python
29
star
8

sdg-tracker.org

Sustainable Development Goals tracker website
TypeScript
25
star
9

poverty-data

Data on poverty by Our World in Data
Python
17
star
10

importers

Bulk import scripts for ingesting large external datasets into OWID's master dataset.
Python
16
star
11

data-api

API for accessing data from our data catalog.
Jupyter Notebook
15
star
12

owid-importer

A collection of Python bulk import scripts for various data sources
Python
15
star
13

slides

reveal.js template and slides for Our World in Data
HTML
10
star
14

owid-datasette

An experiment of publishing articles and variable metadata as a datasette instance
Python
10
star
15

monkeypox

Analyzing the data produced by the World Health Organization on the 2022 mpox outbreak
Python
10
star
16

owid-grapher-py

Python
10
star
17

owid-content

Python
9
star
18

walden

A prototype catalog of data sources that OWID's datasets are built from.
Python
8
star
19

owid-wordpress

ourworldindata.org headless Wordpress (with development environment)
PHP
7
star
20

owid-datautils-py

Data util library by the Data Team at @owid
Python
6
star
21

africaindata.org

Slides about African development on custom domain
CSS
5
star
22

owid-grapher-svgs

4
star
23

cartograms

JavaScript
4
star
24

.github

4
star
25

owid.github.io

HTML
4
star
26

owid-wordpress-admin

Our World in Data wordpress admin plugin
JavaScript
3
star
27

owid-jupyter-demo

Jupyter Notebook
3
star
28

global-change-data-lab.org

Homepage for the Global Change Data Lab
HTML
2
star
29

orae-major-conflicts

OCR of historical conflicts report
JavaScript
2
star
30

actions

2
star
31

owid-theme

Wordpress theme for Our World in Data
TypeScript
2
star
32

owid-repack-py

Repack Pandas data frames into more compact types
Python
1
star
33

importer-bp-statistical-review

Python
1
star
34

owid-feedback

OWID feedback form, powered by Netlify Functions & Mailgun
TypeScript
1
star