CO₂Calculator

Python package to calculate work related CO2 emissions from heating and electricity consumption as well as business trips and commuting.

ℹ️ Description

This package is part of Pledge4Future, a project to quantify, monitor and reduce work-related emissions collectively and sustainably.

💻 Installation

co2calculator is currently only available on GitHub. To use the code, clone the repository as usual, for example with:

git clone https://github.com/pledge4future/co2calculator.git

The repository has a submodule (https://github.com/trainline-eu/stations). This has to be pulled with the following command:

git submodule update --init --recursive

This package requires Python 3.9 and the packages listed in requirements.txt

$ pip install -r requirements.txt

⌨ How to Use

Learn how to use co2calculator in our detailed documentation. [...]

The CO₂ Calculator uses the OpenRouteService (ORS) API to obtain distances between the locations provided by the user to calculate CO₂ emissions of business trips. This requires an API key, which is read from an .env file.

Create an ORS API key and save it in your .env file

1. Go to https://openrouteservice.org/dev/#/signup and create an account (or sign up with GitHub).
2. In the Dev dashboard, switch to the tab TOKENS and request a free token.
3. Once you have the key, click on it to copy it to clipboard.
4. Insert the key into sample.env and rename the file to .env.

👫 Contribution guidelines

If you want to contribute to this project, please fork this repository and create a pull request with your suggested changes.

Running the unit tests and applying the pre-commit hooks requires installing the packages listed in requirements-dev.txt.

$ pip install -r requirements-dev.txt

Install pre-commit hooks

To ensure coding style we use pre-commit hooks. Install them locally using

$ pre-commit install

They will be run automatically every time you try to create a commit. black will adapt the code automatically to conform to PEP8 code style. After this has been done you may need to add the file again to the staging area.

Run tests

After you have made changes to the code, run the units tests by executing

$ pytest

📄 References

Emission factors

• Probas
• UBA (2021). "Umweltfreundlich mobil"
• GOV.UK (2020). Greenhouse gas reporting: conversion factors 2020

Conversion factors

• BAFA (2020): Merkblatt zur Ermittlung des Gesamtenergieverbrauchs
• Krajnc, N. (2015): Wood fuels handbook, FAO

Detour coefficients and constants

• Detour constant of 95 km for plane trips:
  • CSN EN 16258 - Methodology for calculation and declaration of energy consumption and GHG emissions of transport services (freight and passengers), European Committee for Standardization, Brussels, November 2012
  • Méthode pour la réalisation des bilans d’émissions de gaz à effet de , Version 4, p. 53
• Detour coefficients for train trips (1.2) and bus trips (1.5):
  • Adapted from GES 1point5, who were advised by Frédéric Héran (economist and urban planner).

🤝 Project partners

• openrouteservice

⚖️ License

See License