OperationalCarbonScenario
Sustainability scenarios · Implementation: mlsysim/engine/scenario_definitions/sustainability.py.
Construct this scenario with keyword inputs. The fields below show the types and defaults declared by this class.
Operational carbon = energy x PUE x grid intensity.
Give the IT energy directly (it_energy) or as devices drawing device_power for duration. pue is 1 when the energy is already counted at the facility boundary. comparison is an optional emissions anchor (mass per unit) to express the result in.
Notes
Equation: Facility kWh equal IT kWh times PUE; operational carbon is facility energy times supplied grid intensity.
Assumptions: Direct IT energy takes precedence over count*power*duration, and PUE is one for an already facility-level energy input.
Excludes: Embodied emissions, time-varying grid intensity, and verification that the input energy boundary is correct.
References
Derivation: the scenario composes mlsysim.physics.quantities.carbon_from_energy. Their contracts supply the underlying equations; property equations show the remaining unit conversions and accounting.
Examples
>>> from mlsysim import Scenarios
>>> scenario = Scenarios.Gpt3TrainingCarbon
>>> value = scenario.it_energy_total
>>> str(value.units)
'kWh'Attributes
| Name | Description |
|---|---|
| carbon | Operational emissions in metric tonnes from facility energy times grid intensity. |
| comparison | |
| comparisons | Dimensionless equivalent count of the optional emissions comparison anchor. |
| device_power | |
| devices | |
| duration | |
| energy | Facility energy in kWh after multiplying IT energy by PUE. |
| intensity | |
| it_energy | |
| it_energy_total | IT energy in kWh, using the direct input or device count times power times duration. |
| pue |
intensity
Type: Quantity.
Declared default: required.
pue
Type: float.
Declared default: 1.0.
it_energy
Type: Optional[Quantity].
Declared default: None.
devices
Type: Optional[float].
Declared default: None.
device_power
Type: Optional[Quantity].
Declared default: None.
duration
Type: Optional[Quantity].
Declared default: None.
comparison
Type: Optional[Quantity].
Declared default: None.
it_energy_total
engine.scenario_types.OperationalCarbonScenario.it_energy_total
IT energy in kWh, using the direct input or device count times power times duration.
Equation: (devices * device_power * duration).to('kWh'); otherwise it_energy.to('kWh').
energy
engine.scenario_types.OperationalCarbonScenario.energy
Facility energy in kWh after multiplying IT energy by PUE.
Equation: (it_energy_total * pue).to('kWh').
carbon
engine.scenario_types.OperationalCarbonScenario.carbon
Operational emissions in metric tonnes from facility energy times grid intensity.
Equation: carbon_from_energy(energy, intensity).to('metric_ton').
comparisons
engine.scenario_types.OperationalCarbonScenario.comparisons
Dimensionless equivalent count of the optional emissions comparison anchor.
Equation: (carbon / comparison).to('').magnitude.