https://github.com/electricitymaps/electricitymaps-contrib

A real-time visualisation of the CO2 emissions of electricity consumption
https://github.com/electricitymaps/electricitymaps-contrib

app climate-change data-visualization electricity electricity-consumption electricity-prices hacktoberfest map sustainability

Last synced: 2 days ago
JSON representation

A real-time visualisation of the CO2 emissions of electricity consumption

• Host: GitHub
• URL: https://github.com/electricitymaps/electricitymaps-contrib
• Owner: electricitymaps
• License: agpl-3.0
• Created: 2016-05-21T16:36:17.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-29T08:11:02.000Z (about 1 month ago)
• Last Synced: 2024-10-29T09:27:26.494Z (about 1 month ago)
• Topics: app, climate-change, data-visualization, electricity, electricity-consumption, electricity-prices, hacktoberfest, map, sustainability
• Language: Python
• Homepage: https://app.electricitymaps.com
• Size: 150 MB
• Stars: 3,565
• Watchers: 76
• Forks: 942
• Open Issues: 294
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-starred - electricitymaps/electricitymaps-contrib - A real-time visualisation of the CO2 emissions of electricity consumption (hacktoberfest)

README

        


  

    

  





  Electricity Maps





A real time and historical visualisation of the Greenhouse Gas Intensity (in terms of CO2 equivalent) of electricity production and consumption around the world.


  app.electricitymaps.com »





  

  

    

  

    

    

  

    

  

    



![image](web/public/images/electricitymap_social_image.png#gh-light-mode-only)

![image](web/public/images/electricitymap_social_image_dark.png#gh-dark-mode-only)

## Introduction

This project aims to provide a free, open-source, and transparent visualisation of the carbon intensity of electricity consumption around the world.

We fetch the raw production data from public, free, and official sources. They include official government and transmission system operators' data. We then run [our flow-tracing algorithm](https://www.electricitymaps.com/blog/flow-tracing) to calculate the actual carbon intensity of a country's electricity consumption.

_Try it out at [app.electricitymaps.com](https://app.electricitymaps.com), or download the app on [Google Play](https://play.google.com/store/apps/details?id=com.tmrow.electricitymap&utm_source=github) or [App store](https://itunes.apple.com/us/app/electricity-map/id1224594248&utm_source=github)._

## Contributing

The Electricity Maps app is a community project and we welcome contributions from anyone!

We are always looking for help to build parsers for new countries, fix broken parsers, improve the frontend app, improve accuracy of data sources, discuss new potential data sources, update region capacities, and much more.

Read our [contribution guidelines](/CONTRIBUTING.md) to get started.

## Community & Support

Use these channels to be part of the community, ask for help while using Electricity Maps, or just learn more about what's going on:

- [Slack](https://slack.electricitymaps.com): This is the main channel to join the community. You can ask for help, showcase your work, and stay up to date with everything happening.

- [GitHub Issues](https://github.com/electricitymaps/electricitymaps-contrib/issues): Raise any issues you encounter with the data or bugs you find while using the app.

- [GitHub Discussions](https://github.com/electricitymaps/electricitymaps-contrib/discussions): Join discussions and share new ideas for features.

- [GitHub Wiki](https://github.com/electricitymaps/electricitymaps-contrib/wiki): Learn more about methodology, guides for how to set up development environment, etc.

- [FAQ](https://app.electricitymaps.com/FAQ): Get your questions answered in our FAQ.

- [Our Commercial Website](https://electricitymaps.com/): Learn more about how you or your company can use the data too.

- [Our Blog](https://electricitymaps.com/blog/): Read about the green transition and how Electricity Maps is helping to accelerate it.

- [Twitter](https://twitter.com/electricitymaps): Follow for latest news

- [LinkedIn](https://www.linkedin.com/company/electricitymaps): Follow for latest news

## License

This repository is licensed under GNU-AGPLv3 since v1.5.0, find our license [here](https://github.com/electricitymaps/electricitymaps-contrib/blob/master/LICENSE.md). Contributions prior to commit [cb9664f](https://github.com/electricitymaps/electricitymaps-contrib/commit/cb9664f43f0597bedf13e832047c3fc10e67ba4e) were licensed under [MIT license](https://github.com/electricitymaps/electricitymaps-contrib/blob/master/LICENSE_MIT.txt)

## Frequently asked questions

_We also have a lot more questions answered on [app.electricitymaps.com/faq](https://app.electricitymaps.com/faq)!_

**Where does the data come from?**

The data comes from many different sources. You can check them out [here](https://github.com/electricityMaps/electricitymaps-contrib/blob/master/DATA_SOURCES.md)

**Why do you calculate the carbon intensity of _consumption_?**

In short, citizens should not be responsible for the emissions associated with all the products they export, but only for what they consume.

Consumption-based accounting (CBA) is a very important aspect of climate policy and allows assigning responsibility to consumers instead of producers.

Furthermore, this method is robust to governments relocating dirty production to neighboring countries in order to green their image while still importing from it.

You can read more in our blog post [here](https://electricitymaps.com/blog/flow-tracing/).

**Why don't you show emissions per capita?**

A country that has few inhabitants but a lot of factories will appear high on CO2/capita.

This means you can "trick" the numbers by moving your factory abroad and import the produced _good_ instead of the electricity itself.

That country now has a low CO2/capita number because we only count CO2 for electricity (not for imported/exported goods).

The CO2/capita metric, by involving the size of the population, and by not integrating all CO2 emission sources, is thus an incomplete metric.

CO2 intensity on the other hand only describes where is the best place to put that factory (and when it is best to use electricity), enabling proper decisions.

**CO2 emission factors look high — what do they cover exactly?**

The carbon intensity of each type of power plant takes into account emissions arising from the whole life cycle of the plant (construction, fuel production, operational emissions and decommissioning). Read more on the [Emissions Factor Wiki page](https://github.com/electricitymaps/electricitymaps-contrib/wiki/Emission-factors).

**How can I get access to historical data or the live API?**

All this and more can be found **[here](https://electricitymaps.com/)**.

You can also visit our **[data portal](https://www.electricitymaps.com/data-portal)** to download historical datasets.