Skip to main content

BatteryBudgetScenario

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.

A continuous power_draw against a battery and a required runtime.

Notes

Equation: Use the dimensional products, ratios, or selection rules documented on the calculated properties below.

Assumptions: Power draw is constant and all stored battery energy is usable.

Excludes: Conversion losses, reserve margins, battery aging, and discharge-rate effects are absent.

References

Derivation: the calculated properties below state their defining arithmetic and units. They are scenario accounting or input-selection rules, not independently measured relationships.

Examples

>>> from mlsysim import Scenarios
>>> case = Scenarios.AlwaysOnObjectDetectorPhone
>>> str(case.runtime)
'7.5 h'

Attributes

Name Description
battery_energy
budget_ratio Required energy relative to available battery energy. Equation: required_energy / | | [power_draw](#mlsysim.engine.scenario_types.BatteryBudgetScenario.power_draw) | | | [required_energy](#mlsysim.engine.scenario_types.BatteryBudgetScenario.required_energy) | Stored energy required for the requested constant-power runtime. Equation:power_draw
required_runtime
runtime Ideal runtime from stored energy at constant power draw. Equation: ``battery_energy /

battery_energy

Type: Quantity.

Declared default: required.

power_draw

Type: Quantity.

Declared default: required.

required_runtime

Type: Quantity.

Declared default: required.

runtime

engine.scenario_types.BatteryBudgetScenario.runtime

Ideal runtime from stored energy at constant power draw. Equation: battery_energy / power_draw. Units: hours; conversion losses and battery derating are excluded.

required_energy

engine.scenario_types.BatteryBudgetScenario.required_energy

Stored energy required for the requested constant-power runtime. Equation: power_draw * required_runtime. Units: Wh; no reserve margin is added.

budget_ratio

engine.scenario_types.BatteryBudgetScenario.budget_ratio

Required energy relative to available battery energy. Equation: required_energy / battery_energy. Units: dimensionless; values above one exceed the ideal energy budget.

Back to top