Carbon emissions calculator
Project description
Valohai Wattson 🔌⚡
About
Wattson is a Python library for estimating cloud compute carbon emissions.
It currently supports estimating emissions for a range of Amazon EC2 instances in a variety of regions.
Usage
You can install this package with pip by running pip install valohai-wattson
.
If you are currently using AWS instances, you can calculate the carbon emissions for your instances using the following code:
from wattson import estiamte_carbon_emissions
training_emissions = estimate_carbon_emissions(
instance_type='c4.2xlarge',
region='us-east-1',
hours=1,
load_percentage=0.5,
)
The returned value will be of the type wattson.EmissionsEstimation
and have the following information:
data_license
: The license of the data used to estimate the emissions.region
: The region the original computation was performed in.instance_type
: The instance type of the original computation.avg_load
: The average CPU load during the original computation (defaults to 50% if not specified).scope_2_co2eq
: The estimated CO2 emissions for the electricity used in the original computation.scope_3_co2eq
: The estimated CO2 emissions for manufacturing of the device used in the original computation, assuming a 4-year usage.compensated
: Were any of the emissions of the original computation compensated using e.g. carbon emissions compensation or renewable energy credits.details
: Any additional details about e.g. the compensation methodology.
Acknowledgements
This project uses the EC2 Carbon Emissions Dataset by Teads Engineering.
Licenses
- The library code is Copyright (c) 2022 Valohai, licensed under the MIT License.
- The Teads Engineering EC2 Carbon Emissions Dataset is licensed under the Creative Commons Attribution 4.0 International License.
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
valohai-wattson-22.5.0.tar.gz
(17.8 kB
view hashes)
Built Distribution
Close
Hashes for valohai_wattson-22.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b6d08f6a2bb0de3c11e303a3cf26dfdc65c48c0dded96585d40ffd4812a5be9e |
|
MD5 | 899935cad314883cfdaa0c3b5990958f |
|
BLAKE2b-256 | e23508f6036890bdbd8e667eabbad1bab4c2817c5694d4d234e0acbe9cb97af1 |