Struct LithiumPack 

pub struct LithiumPack {
    pub cells_series: u32,
    pub cells_parallel: u32,
    pub cell_internal_resistance_ohm: f64,
    pub cell_capacity_ah: f64,
}

An off-grid lithium pack as an S×P array of prismatic cells, modelled as a first-order equivalent circuit (OCV − I·R sag). Captures the “down to the internal 4-prismatic-cell architecture” requirement: terminal voltage and deliverable power depend on the series/parallel topology, per-cell internal resistance, and SoC under a fluctuating load.

Fields

cells_series: u32

cells_parallel: u32

cell_internal_resistance_ohm: f64

cell_capacity_ah: f64

Implementations

impl LithiumPack

pub fn cell_ocv(&self, soc: f64) -> f64

Open-circuit voltage of ONE cell at a state-of-charge (0..1): a linearised Li-ion curve from ~3.0 V (empty) to ~4.2 V (full).

pub fn pack_ocv(&self, soc: f64) -> f64

Pack open-circuit voltage = series count × cell OCV.

pub fn pack_resistance(&self) -> f64

Pack internal resistance = R_cell × S / P (series adds, parallel divides).

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

Terminal voltage under a load current (A): OCV minus the internal-resistance sag.

pub fn deliverable_power(&self, soc: f64, load_current_a: f64) -> f64

Power (W) actually delivered to the load at a given SoC and current.

pub fn pack_capacity_ah(&self) -> f64

Total pack capacity (Ah) = per-cell capacity × parallel count.

Trait Implementations

impl Clone for LithiumPack

fn clone(&self) -> LithiumPack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LithiumPack

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

Formats the value using the given formatter.

impl Copy for LithiumPack