sox.system.isothermal_thevenin¶

Module Contents¶

Classes¶

IsothermalThevenin

Isothermal Thevenin battery dynamics model that is used for state estimation.

class sox.system.isothermal_thevenin.IsothermalThevenin(ocv_func: Callable, series_resistance: float, rc_resistors: List[float], rc_capacitors: List[float], capacity: float)¶

Isothermal Thevenin battery dynamics model that is used for state estimation.

Parameters:
  • ocv_func (Callable) – Function that returns the open-circuit voltage as a function of state of charge.

  • series_resistance (float) – Series resistance (Ohm).

  • rc_resistors (list) – List of RC resistor values (Ohm).

  • rc_capacitors (list) – List of RC capacitor values (F).

  • capacity (float) – Cell capacity (Ah).

ocv¶

Function returning the open-circuit voltage as a function of state of charge.

Type:

Callable

docv¶

Function returning the derivative of the open-circuit voltage with respect to state of charge.

Type:

Callable

series_resistance¶

Series resistance (Ohm).

Type:

float

rc_resistors¶

List of RC resistor values (Ohm).

Type:

list

rc_capacitors¶

List of RC capacitor values (F).

Type:

list

capacity¶

Cell capacity (Ah).

Type:

float

static build_ocv_func(ocv_func)¶

Returns the open-circuit voltage as a function of state of charge.

static build_docv_func(ocv_func)¶

Returns the derivative of the open-circuit voltage with respect to state of charge.

F(dt: float)¶

State transition matrix (discrete-time)

B(dt: float)¶

Input matrix (discrete-time)

fx(x, current: float, dt: float)¶

State transition function (discrete-time)

hx(x, current)¶

Measurement function (voltage)

h_jacobian(x)¶

Jacobian of the measurement function (voltage)