/electricitymap

A real-time visualisation of the GHG footprint of electricity generation

Primary LanguageJavaScriptMIT LicenseMIT

electricitymap

A real-time visualisation of the GHG and CO2 footprint of electricity generation built with d3.js, optimized for Google Chrome. Try it out at https://corradio.github.io/electricitymap/.

image

Consider contributing or submit ideas, feature requests or bugs on the issues page.

Data sources

GreenHouse Gas footprint calcuation and data source

The GreenHouse Gas (GHG) footprint of each country is measured from the perspective of a consumer. It represents the GHG footprint of 1 kWh consumed inside a given country, in the gCO2eq unit (meaning each GHG is converted to its CO2 equivalent in terms of global warming potential).

The GHG footprint of each production mode takes into account the construction of production units and their usual lifetimes as calculated by the 2014 IPCC report (see wikipedia entry and co2eq.js#L1).

Each country has a GHG mass flow that depends on neighboring countries. In order to determine the GHG footprint of each country, the set of coupled GHG mass flow balance equations of each countries must be solved simultaneously. This is done by solving the linear system of equations defining the network of GHG exchanges (see co2eq.js#L49).

Real-time electricity data sources

Production capacity data sources

Real-time weather data sources

Contribute

You can contribute by

  • adding your country by writing a parser
  • update an existing parser with a different API if you know one with more data or closer to real-time
  • optimising the code, correct inaccuracies...

You can also see a list of missing informations displayed as warnings in the developer console, or question marks in the country panel:

image

To get started, clone or fork the repository, and install all requirements:

Make install

You might need to install the GRIB API. On Mac OS, you can simply brew install grib-api.

Provided you have mongodb installed and running, you can run the full system using

Make server

If you have Docker, you can just run docker-compose up instead. Head over to http://localhost:8000/ and you should see the map!

Once you're done doing your changes, submit a pull request to get them integrated.