Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Electricity Maps

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

Category: Emissions
Sub Category: Carbon Intensity and Accounting

Keywords

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

Keywords from Contributors

carbon-footprint climate community life-cycle-assessment climate-impact carbon-model varta-storage varta alerting business-intelligence

Last synced: about 22 hours ago
JSON representation

Repository metadata

The open source repository for Electricity Maps data parsers that powers the world's most comprehensive electricity data platform

README.md

image
image

Introduction

This project aims to provide a free, open-source, and transparent way to collect electricity data.

We fetch the raw data from public, free, and official sources. They include official government and transmission system operators' data. This data powers the Electricity Maps platform, which includes our flow-tracing algorithm, estimation models, forecast engine and much more.

View it online app.electricitymaps.com, or download the app on Google Play or the App store.

Contributing

Electricity Maps collection of parsers 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 accuracy of data sources, discuss new potential data sources, update region capacities, and much more.

Read our contribution guidelines 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:

License

This repository is licensed under GNU-AGPLv3 since v1.5.0, find our license here. Contributions prior to commit cb9664f were licensed under MIT license

Frequently asked questions

Where does the data come from?
The data comes from many different sources. But we strive to only use official sources from goverments, TSOs, producers and online OpenData platforms when avaiable.

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.

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 methodology section.

How can I get access to the API?
All this and more can be found here.
You can also visit our data portal to download historical datasets.

Is the map frontend open source?
In the past, the map frontend was open source, but we have since rewritten the app completely and moved it to our own platform in order to expand the available features and provide a consistent user experience across our product offerings.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 6,665
Total Committers: 432
Avg Commits per committer: 15.428
Development Distribution Score (DDS): 0.74

Commits in past year: 505
Committers in past year: 49
Avg Commits per committer in past year: 10.306
Development Distribution Score (DDS) in past year: 0.75

Name Email Commits
Olivier Corradi o****i@g****m 1733
Viktor Andersson 3****9 642
dependabot[bot] 4****] 510
electricitymapsbot e****b@e****m 309
Mads Nedergaard n****s@g****m 243
Tony t****t@e****m 210
Chris 3****h 154
Robin TROESCH 3****m 122
Pierre Segonne 3****e 120
Mathilde Daugy 1****y 119
Silke Bonnen 9****n 111
Alex a****z 84
Felix Qvist f****t@g****m 79
nessie2013 t****1@h****m 71
Filip Barl f****l@g****m 67
tmrow-bot k****t@t****m 58
Maxime Bellec m****c@g****m 56
Kenneth Skovhus s****s 56
Magnus Österlund m****8@g****m 55
Markus Killendahl m****l@t****m 53
Bruno Lajoie b****e@g****m 52
jarek j****k@p****a 52
q-- q****- 49
Raffox97 R****7 45
Cadence Banulis c****s@g****m 45
hectorespert b****g 42
KabelWlan 4****n 42
Phiphou p****u 37
Jakob Buverud j****d@g****m 36
Bastien Bigué b****e@g****m 36
and 402 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 4 days ago

Total issues: 2,883
Total pull requests: 6,660
Average time to close issues: 4 months
Average time to close pull requests: 10 days
Total issue authors: 719
Total pull request authors: 510
Average comments per issue: 4.17
Average comments per pull request: 1.49
Merged pull request: 5,329
Bot issues: 5
Bot pull requests: 1,060

Past year issues: 53
Past year pull requests: 567
Past year average time to close issues: 7 days
Past year average time to close pull requests: 5 days
Past year issue authors: 40
Past year pull request authors: 67
Past year average comments per issue: 2.21
Past year average comments per pull request: 0.73
Past year merged pull request: 323
Past year bot issues: 0
Past year bot pull requests: 166

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/electricitymaps/electricitymaps-contrib

Top Issue Authors

  • corradio (468)
  • tmrow-bot (412)
  • VIKTORVAV99 (113)
  • alixunderplatz (100)
  • q-- (77)
  • brunolajoie (73)
  • electricitymapsbot (62)
  • madsnedergaard (51)
  • phiphou (50)
  • jarek (48)
  • systemcatch (42)
  • Manu1400 (36)
  • fbarl (33)
  • strassburger (29)
  • pierresegonne (26)

Top Pull Request Authors

  • dependabot[bot] (1,061)
  • VIKTORVAV99 (994)
  • tonypls (372)
  • madsnedergaard (295)
  • silkeholmebonnen (193)
  • corradio (186)
  • systemcatch (157)
  • mathilde-daugy (143)
  • pierresegonne (140)
  • unitrium (126)
  • cadeban (112)
  • alixunderplatz (91)
  • FelixDQ (89)
  • nessie2013 (78)
  • Kongkille (74)

Top Issue Labels

  • parser (819)
  • help wanted (704)
  • bug 🐞 (505)
  • frontend 🎨 (488)
  • data (202)
  • needs triage (135)
  • idea 💡 (127)
  • science (79)
  • good first issue (69)
  • data needed (63)
  • parser buildable! (63)
  • question 🤔 (59)
  • mobile app 📱 (56)
  • capacity (39)
  • duplicate (35)
  • research library 📚 (25)
  • historical data :calendar: (23)
  • estimated data (22)
  • techdebt (22)
  • performance 🏎 (21)
  • emission factors (16)
  • translations 🗣 (12)
  • infrastructure (11)
  • fixed-in-refactor 🚀 (11)
  • hacktoberfest (11)
  • external (11)
  • geometry (10)
  • python (10)
  • exchange config (8)
  • BLOCKED (7)

Top Pull Request Labels

  • frontend 🎨 (2,294)
  • dependencies (1,483)
  • parser (1,064)
  • javascript (875)
  • python (787)
  • zone config (647)
  • tests (409)
  • infrastructure (291)
  • translations 🗣 (287)
  • mobile app 📱 (137)
  • exchange config (137)
  • github_actions (103)
  • performance 🏎 (102)
  • techdebt (81)
  • capacity parser (53)
  • capacity (50)
  • change requested (35)
  • Frontend 🎨 (26)
  • hacktoberfest-accepted (22)
  • science (21)
  • Review effort [1-5]: 3 (21)
  • Enhancement (18)
  • BLOCKED (17)
  • emission factors (10)
  • bug 🐞 (10)
  • Bug fix (8)
  • Review effort [1-5]: 2 (7)
  • help wanted (4)
  • Review effort [1-5]: 4 (3)
  • python:uv (3)

Package metadata

proxy.golang.org: github.com/electricitymaps/electricitymaps-contrib

pypi.org: electricitymaps

Official Electricity Maps Python SDK

  • Homepage: https://github.com/electricitymaps/electricitymaps-contrib
  • Documentation: https://docs.electricitymaps.com
  • Licenses: MIT
  • Latest release: 0.0.1 (published 8 months ago)
  • Last Synced: 2026-04-16T09:53:57.487Z (4 days ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 88 Last month
  • Rankings:
    • Forks count: 1.843%
    • Stargazers count: 1.913%
    • Dependent packages count: 8.651%
    • Average: 15.289%
    • Dependent repos count: 48.748%
  • Maintainers (1)

Dependencies

.github/workflows/CI.yml actions
  • actions/checkout v4 composite
  • tj-actions/changed-files v39.0.1 composite
.github/workflows/codeql.yml actions
  • actions/checkout v4 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/init v2 composite
.github/workflows/label.yml actions
  • actions/labeler v4 composite
pyproject.toml pypi
  • click <=8.0 develop
  • flake8 ^3.9.2 develop
  • mock ^2.0.0 develop
  • pylint ^2.13.7 develop
  • pylint-pydantic ^0.1.8 develop
  • pytest ^7.1.2 develop
  • requests-mock ~1.3.0 develop
  • testfixtures ^7.0.0 develop
  • Pillow ^9.1.1
  • PyYAML ^6.0
  • arrow 0.16.0
  • beautifulsoup4 ~4.6.0
  • black 22.12.0
  • demjson3 ^3.0.5
  • freezegun ^0.3.15
  • html5lib ^1.1
  • imageio ^2.18.0
  • isort 5.12.0
  • lxml ^4.9.1
  • mock ^2.0.0
  • odfpy ^1.4.1
  • opencv-python 4.6.0.66
  • openpyxl ^3.1.2
  • pandas ^1.4.4
  • pydantic ^1.9.0
  • pydataxm ^0.3.2
  • pytesseract 0.2.0
  • python >= 3.10, < 3.11
  • ree 2.3.2
  • requests ~2.25.1
  • ruamel-yaml ^0.17.24
  • signalr-client-threads ~0.0.12
  • tqdm ^4.64.0
  • xlrd ^2.0.1
  • xmltodict ^0.13.0
libs/types/pyproject.toml pypi
  • pydantic >=1.10.17,<2
uv.lock pypi
  • aiohappyeyeballs 2.6.1
  • aiohttp 3.13.3
  • aiosignal 1.4.0
  • async-timeout 5.0.1
  • asyncio 4.0.0
  • attrs 25.4.0
  • beautifulsoup4 4.6.3
  • certifi 2026.1.4
  • charset-normalizer 3.4.4
  • click 8.3.1
  • colorama 0.4.6
  • defusedxml 0.7.1
  • demjson3 3.0.6
  • electricitymap-contrib 1.5.5
  • electricitymap-contrib-types 1.0.0
  • et-xmlfile 2.0.0
  • exceptiongroup 1.3.1
  • freezegun 0.3.15
  • frozenlist 1.8.0
  • idna 3.11
  • imageio 2.37.2
  • iniconfig 2.3.0
  • lxml 4.9.4
  • multidict 6.7.0
  • nest-asyncio 1.6.0
  • numpy 1.26.4
  • odfpy 1.4.1
  • opencv-python 4.8.1.78
  • openpyxl 3.1.5
  • packaging 25.0
  • pandas 2.3.3
  • pillow 12.1.0
  • pluggy 1.6.0
  • propcache 0.4.1
  • pycountry 22.3.5
  • pydantic 1.10.26
  • pydataxm 0.3.16
  • pytesseract 0.2.0
  • pytest 7.4.4
  • python-dateutil 2.9.0.post0
  • pytz 2025.2
  • pyyaml 6.0.3
  • requests 2.32.5
  • requests-mock 1.3.0
  • ruamel-yaml 0.17.40
  • ruamel-yaml-clib 0.2.15
  • ruff 0.11.2
  • setuptools 80.9.0
  • signalr-client-threads 0.0.12
  • six 1.17.0
  • sseclient 0.0.27
  • syrupy 4.9.1
  • testfixtures 7.2.2
  • tomli 2.4.0
  • typing-extensions 4.15.0
  • tzdata 2025.3
  • urllib3 2.6.3
  • websocket-client 1.9.0
  • xlrd 2.0.2
  • xmltodict 0.13.0
  • yarl 1.22.0
.github/workflows/validate_local_links_in_md.yml actions
  • actions/checkout v6 composite
.github/workflows/create-release.yml actions
  • actions/checkout v6 composite
  • actions/setup-python v6 composite
  • ad-m/github-push-action v1.0.0 composite
  • google-github-actions/auth v3 composite
  • google-github-actions/setup-gcloud v3 composite
.github/workflows/earthly-contrib.yml actions
  • actions/checkout v6 composite
  • earthly/actions-setup v1 composite

Score: 18.879699054930192