Struct BatteryModel 

pub struct BatteryModel {
    pub capacity_ah: f64,
    pub soc: f64,
    pub r0: f64,
    pub r1: f64,
    pub c1: f64,
    pub u_rc: f64,
}

Battery equivalent-circuit model with internal resistance and one RC pair.

Topology: V_oc − R0 − (R1 ∥ C1) = V_terminal. The RC pair captures diffusion / charge-transfer relaxation dynamics.

Fields

capacity_ah: f64

Nominal capacity [Ah]

soc: f64

State of charge (0 = empty, 1 = full)

r0: f64

Series (ohmic) resistance R₀ [Ω]

r1: f64

RC branch resistance R₁ [Ω]

c1: f64

RC branch capacitance C₁ [F]

u_rc: f64

Voltage across the RC branch (state variable) [V]

Implementations

impl BatteryModel

pub fn new(capacity_ah: f64, r0: f64, r1: f64, c1: f64) -> Self

Create a fully charged battery model.

Arguments

• capacity_ah — capacity [Ah]
• r0 — series resistance [Ω]
• r1 — RC branch resistance [Ω]
• c1 — RC branch capacitance [F]

pub fn open_circuit_voltage(&self) -> f64

Open-circuit voltage from a piecewise-linear SOC-OCV curve.

Uses a simplified linear model: V_oc = 3.0 + 1.2 · SOC (LFP-like).

pub fn terminal_voltage(&self, current_a: f64) -> f64

Terminal voltage under load [V].

V = V_oc − R0 · I − U_rc

pub fn step(&mut self, current_a: f64, dt_s: f64)

Advance simulation by dt_s seconds at current current_a [A].

Updates SOC and RC branch voltage via first-order Euler integration.

pub fn is_depleted(&self) -> bool

Returns true when the cell is considered depleted (SOC < 5 %).

pub fn power(&self, current_a: f64) -> f64

Instantaneous power [W] (positive = discharge).

Trait Implementations

impl Clone for BatteryModel

fn clone(&self) -> BatteryModel

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BatteryModel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.