"Compute CO2 equivalent emissions"
Project description
co2eq
estimates the CO2 emissions associated to air flights.
It is currently focused on a single meeting or a serie of meetings like a conference that happens multiple times a year for example.
CO2 emissions can be estimated according to the flying distance between each attendee and the meeting place (distance mode).
However, CO2 emissions are highly dependent on the number of legs of a given flight itineraries.
The originality of co2eq
is that for each participant, co2eq
derive an effective flight and estimates the CO2 emissions considering each of these legs (flight mode).
co2eq
plots the repartitions of CO2 emissions according to any criteria associated to each attendee.
While the focus is on C02 co2eq
also performs more standard representations of attendance in number of participants (attendee mode).
A detailed description of co2eq
can be found here:
- Daniel Migault CO2eq: "Estimating Meetings' Air Flight CO2 Equivalent Emissions - An Illustrative Example with IETF meetings", Show me the numbers: Workshop on Analyzing IETF Data (AID), 2021. https://www.iab.org/wp-content/IAB-uploads/2021/11/Migault.pdf.
A example of the outputs of co2eq
outputs can be found on the co2eq
web site https://mglt.github.io/co2eq/,
where CO2 emissions have been computed for the IETF meetings and the ICANN.
Installation
Installation of co2eq can be done using pip
pip install co2eq
or directly from github
git clone https://github.com/mglt/co2eq
cd co2eq #
python3 -m build && pip3 install --force-reinstall dist/co2eq-0.0.2.tar.gz
The development of co2eq have lead to the data of the country_info package to be updated. Before this modification being released in the country_info release, the updated version of country_info can be installed as follows:
git clone https://github.com/mglt/countryinfo
cd country_info
python3 setup.py install
To compute the CO2 using GO Climate service, the climate neutral package needs to be installed.
git clone https://github.com/codeboten/climate_neutral
cd climate_neutral
sudo python3 install setup.py
``
If other classes than 'economy' are used, an advanced use of co2eq may also require an updated version of climate neutral
git clone https://github.com/mglt/climate_neutral cd climate_neutral sudo python3 install setup.py
# Configuring and using co2eq
The example directory contains examples on how to use co2eq.
In general, you will need a configuration object commonly designated as `conf`.
It is recommended to generated it by completeing the conf_template.py file which contains the following dictionary:
CONF = {
The directory where air flights, or CO2 emissions for a given air flight
requested to GO Climate are stored after it has been requested.
The main purpose if to prevent co2eq to resolve the same request multiple time
'CACHE_DIR' : "",
co2eq retrieves flight offers to estimate a real flight and uses the AMADEUS API:
https://developers.amadeus.com/get-started/get-started-with-amadeus-apis-334
You need to register and request and an API Key and an API Secret for the
Flight Offers Search service.
'AMADEUS_ID' : "", 'AMADEUS_SECRET' : "",
To compute the CO2 emissions associated a flight a request is sent to GO Climate
Please go through https://api.goclimate.com/docs to get an account.
'GOCLIMATE_SECRET' : "" , 'NOMINATIM_ID' : "",
where logs are stored. We suggest you perform tail -f your_log_file
to monitor what can possibly go wrong.
'log' : './co2eq.log',
Directory where all outputs are stored
'OUTPUT_DIR' : "",
CityDB specific parameters
ISO3166_REPRESENTATIVE_CITY enable to indicate a specific
representative city for that country.
This is usually useful when the capital is not the main
representative city or when no flight can be retrieved from
that country
'ISO3166_REPRESENTATIVE_CITY' : { } }
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file co2eq-0.0.2.tar.gz
.
File metadata
- Download URL: co2eq-0.0.2.tar.gz
- Upload date:
- Size: 380.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.4.2 requests/2.22.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e29bcabf915b934e8116ffd5a7b380bf76b0ea073c8e9d5d865dec4d2072ea35 |
|
MD5 | cb605abad582819f5fe7a2d0950bef9b |
|
BLAKE2b-256 | f3b0d0170a5b1a347b2e46d5177fccb291f7c8d416752a511bec30c41c0e9bd6 |
Provenance
File details
Details for the file co2eq-0.0.2-py3-none-any.whl
.
File metadata
- Download URL: co2eq-0.0.2-py3-none-any.whl
- Upload date:
- Size: 379.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.4.2 requests/2.22.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 78272541cc07502dd066d7c9bf72e3c7f636463c4b9e907e6576400f325221b1 |
|
MD5 | ca49c1f9cd7de01c0ec01d7f542186e9 |
|
BLAKE2b-256 | e5399a910560df1ea14a7548a69cc9c3c823157bda9421ec64dee17327b6a3f2 |