Parameters

A set of parameters are supported by API to help users provide additional details per project.

Input Parameters

Input Parameters
Parameter	Description
project_name	Name of the project, defaults to `codecarbon`
experiment_id	Id of the experiment
measure_power_secs	Interval (in seconds) to measure hardware power usage, defaults to `15`
tracking_mode	`machine` measure the power consumptions of the entire machine (defaults) `process` try and isolate the tracked processes in isolation
gpu_ids	User-specified known gpu ids to track, defaults to `None`
log_level	Global codecarbon log level : “info” (defaults), “debug”, “warning”, “error”, or “critical”
co2_signal_api_token	API token for co2signal.com (requires sign-up for free beta)
pue	PUE (Power Usage Effectiveness) of the data center where the experiment is being run.

PUE is a multiplication factor provided by the user, so it is up to the user to get it from his cloud provider.

Old data-centers have a PUE up to 2.2, where new green one coud be as low as 1.1.

Output Parameters
Parameter	Description
save_to_file	Boolean variable indicating if the emission artifacts should be logged to a CSV file, defaults to `True`
output_dir	Directory path to which the experiment details are logged defaults to current directory
output_file	Name of output CSV file defaults to `emissions.csv`
on_csv_write	When calling `tracker.flush()` manually choose if - `update` the existing `run_id` row (erasing former data) - `append` add a new row to CSV file (defaults)
save_to_api	Boolean variable indicating if emissions artifacts should be logged to the CodeCarbon API, defaults to `False`
api_endpoint:	Optional URL of CodeCarbon API endpoint for sending emissions data defaults to “https://api.codecarbon.io”
api_key	API key for the CodeCarbon API (mandatory to use this API!)
api_call_interval	Occurence to wait before calling API (defaults to 8): -1 : call API on flush() and at the end 1 : at every measure 2 : at every 2 measure, and so on
save_to_logger	Boolean variable indicating if the emission artifacts should be written to a dedicated logger, defaults to `False`
logging_logger	LoggerOutput object encapsulating a logging.logger or a Google Cloud logger
logger_preamble	String to systematically include in the logger’s messages (defaults to “”)

Input Parameters to OfflineEmissionsTracker
Parameter	Description
country_iso_code	3 letter ISO Code of the country where the experiment is being run. Available countries are listed in global_energy_mix.json
region	Optional Name of the Province/State/City, where the infrastructure is hosted Currently, supported only for US States and Canada for example - California or New York, from the list
cloud_provider	The cloud provider specified for estimating emissions intensity, defaults to `None` See https://github.com/mlco2/codecarbon/blob/master/codecarbon/data/cloud/impact.csv for a list of cloud providers
cloud_region	The region of the cloud data center, defaults to `None` See https://github.com/mlco2/codecarbon/blob/master/codecarbon/data/cloud/impact.csv for a list of cloud regions
country_2letter_iso_code	For use with the CO2Signal emissions API. See http://api.electricitymap.org/v3/zones for a list of codes and their corresponding locations.

Decorator track_emissions in addition to standard arguments, requires the following parameters:

Input Parameters to @track_emissions
Parameter	Description
fn	function to be decorated
offline	Boolean variable indicating if the tracker should be run in offline mode defaults to `False`
country_iso_code	3 letter ISO Code of the country where the experiment is being run. Available countries are listed in global_energy_mix.json
region	Optional Name of the Province/State/City, where the infrastructure is hosted Currently, supported only for US States for example - California or New York, from the list
cloud_provider	The cloud provider specified for estimating emissions intensity, defaults to `None`. See https://github.com/mlco2/codecarbon/blob/master/codecarbon/data/cloud/impact.csv for a list of cloud providers
cloud_region	The region of the cloud data center, defaults to `None`. See https://github.com/mlco2/codecarbon/blob/master/codecarbon/data/cloud/impact.csv for a list of cloud regions