Battery

The battery asset represents spacecraft energy storage. It stores capacity, state-of-charge limits, charge/discharge limits, voltage limits, efficiency values, and thermal/degradation metadata.

Role in ASTROLAB

Workflow	Battery role
Power analysis	Stores surplus generation and supplies deficits.
Reports	Provides SOC, energy, usable capacity, and limit assumptions.
Future power subsystem modelling	Foundation for degradation, thermal, and bus-voltage behaviour.

Battery Energy Model

flowchart TD
    C["Nominal capacity Wh"] --> SOC["SOC percent"]
    SOC --> E["Stored energy Wh"]
    E --> L["Min/max SOC limits"]
    L --> CH["Charge power limit"]
    L --> DIS["Discharge power limit"]
    CH --> OUT["Power analysis"]
    DIS --> OUT

Main Parameters

Field	Meaning
battery_type_id	Internal type identifier.
battery_type_name	Display name.
chemistry	Battery chemistry label.
nominal_capacity_Wh	Nominal capacity in Wh.
initial_soc_percent	Initial state of charge.
minimum_soc_percent	Minimum allowed SOC.
maximum_soc_percent	Maximum allowed SOC.
charge_efficiency_percent	Charge efficiency.
discharge_efficiency_percent	Discharge efficiency.
max_charge_power_W	Maximum charge power.
max_discharge_power_W	Maximum discharge power.
nominal_voltage_V	Nominal voltage.
minimum_voltage_V	Minimum voltage.
maximum_voltage_V	Maximum voltage.
self_discharge_rate_percent_per_day	Self-discharge metadata.
capacity_degradation_percent_per_year	Degradation metadata.
minimum_temperature_C	Minimum operational temperature.
maximum_temperature_C	Maximum operational temperature.

Useful Derived Quantities

Quantity	Meaning
Nominal energy	nominal_capacity_Wh.
Usable capacity	Capacity between minimum and maximum SOC.
Initial energy	Capacity multiplied by initial SOC.
Minimum energy	Capacity multiplied by minimum SOC.
Maximum energy	Capacity multiplied by maximum SOC.