Return a valid access token, refreshing or failing with a clear message.

Computes emissions for cloud infra :param energy: Mean power consumption of the process (kWh) :param cloud: Region of compute

Fetches the CPU Power Details by fetching values from a logged csv file in _log_values function

Convert a models.Run to a schemas.Run :emission: An Run in SQLAlchemy format. :returns: An Run in pyDantic BaseModel format.

Normalize GPU IDs from config/user input into a list of ids consumable by hardware resolution code. Supports: - comma-separated stri

Revoke an access token at the OIDC provider (RFC 7009). Best-effort — logs and swallows errors so logout always succeeds.

This method sets the access token to be used for the API. Args: token (str): access token to be used for the API

Get list of directories to scan for RAPL files.

Helper function to get all GPU metrics at once, to minimize the number of calls to amdsmi and reduce the risk of hitting not initialized error

Returns memory info in bytes

Simulate a fresh import of codecarbon.core.gpu_amd where importing amdsmi raises *error_to_raise*. Returns the freshly imported modu

Common function to verify the possible tokens and return the correct one if found Args: db_project_tokens (List[SqlModelProjectTo

Send emissions data to push gateway

* Helper function to download a file

Hook for backend-specific warnings when a GPU is explicitly selected. Backends that need to emit warnings for selected devices should overrid

Returns Emissions Across Regions in a country. Data is cached on first access per country. :param country_iso_code: ISO code

Returns CPU power Data. Data is pre-loaded at module import for performance.

Returns True if the system has an nvidia-smi interface.

Convert a models.Project to a schemas.Project :project: An Project in SQLAlchemy format. :returns: An Project in pyDantic BaseModel f

Sql To Pydantic Mapper :returns: An User in pyDantic BaseModel format. :rtype: schemas.User

Read energy in microjoules

Fully resolve a path: resolve env vars ($HOME etc.) -> expand user (~) -> make absolute Args: path (Union[str, Path]): Path to a

Starts tracking the experiment. Currently, Nvidia GPUs are supported. :return: None

Check if energy file is readable and is a main domain.

Create the experiment for project_id

Fetch OpenID Connect discovery document.

:return: Metadata containing cloud info

Returns the list of processes ids having a compute context on the device with the memory used

Get the Ids of the GPUs that we will monitor :return: list of ids

Returns the name of the GPU device

Returns the list of processes ids having a graphics context on the device with the memory used

Returns max power usage in Watts

Returns power usage in Watts

Returns degrees in the Celsius scale. Returns temperature in millidegrees Celsius.

Reads the value in the file at the path

Set up CPU tracking in load mode using psutil.

Set up fallback CPU tracking using TDP estimation.

Resolves the path to a path then backs it up, adding the extension provided. Warning : this function will rename the file in place, it's the

Clean up an environment variable key: remove starting CODECARBON_ and to lower case. eg: "CODECARBON_PROJECT_NAME" -> "project_name"

Compute the energy used since last call.

Returns Energy Mix Across Regions in a country. Data is cached on first access per country. :param country_iso_code: ISO cod

Fetches the CPU Power Details by fetching values from a logged csv file in _log_values function

List all organizations

Returns True if the GPU details are available.

Check if all values of a key are equal to the specified value.

Checks if Intel Power Gadget is available on the system. Returns: bool: `True` if Intel Power Gadget is available, `False` otherwise