Electrode SOH models

class pybamm.lithium_ion.ElectrodeSOH(name='ElectrodeSOH model', param=None)

Model to calculate electrode-specific SOH, from [1]. This model is mainly for internal use, to calculate summary variables in a simulation.

\[n_{Li} = \frac{3600}{F}(y_{100}C_p + x_{100}C_n),\]
\[V_{max} = U_p(y_{100}) - U_n(x_{100}),\]
\[V_{min} = U_p(y_{0}) - U_n(x_{0}),\]
\[x_0 = x_{100} - \frac{C}{C_n},\]
\[y_0 = y_{100} + \frac{C}{C_p}.\]

References

Extends: pybamm.BaseModel

property default_solver

Return default solver based on whether model is ODE/DAE or algebraic

class pybamm.lithium_ion.ElectrodeSOHx100(name='ElectrodeSOHx100 model', param=None)

Model to calculate electrode-specific SOH for x_100 and y_100, from [1]. This model is mainly for internal use, to calculate summary variables in a simulation.

\[n_{Li} = \frac{3600}{F}(y_{100}C_p + x_{100}C_n),\]
\[V_{max} = U_p(y_{100}) - U_n(x_{100}),\]

Extends: pybamm.BaseModel

property default_solver

Return default solver based on whether model is ODE/DAE or algebraic

class pybamm.lithium_ion.ElectrodeSOHx0(name='ElectrodeSOHx0 model', param=None)

Model to calculate electrode-specific SOH for x_0 and y_0, from [1]. This model is mainly for internal use, to calculate summary variables in a simulation.

\[V_{min} = U_p(y_{0}) - U_n(x_{0}),\]
\[x_0 = x_{100} - \frac{C}{C_n},\]
\[y_0 = y_{100} + \frac{C}{C_p}.\]

Extends: pybamm.BaseModel

property default_solver

Return default solver based on whether model is ODE/DAE or algebraic

class pybamm.lithium_ion.ElectrodeSOHSolver(parameter_values, param=None)
class pybamm.lithium_ion.ElectrodeSOHHalfCell(working_electrode, name='Electrode-specific SOH model')

Model to calculate electrode-specific SOH for a half-cell, adapted from [2]. This model is mainly for internal use, to calculate summary variables in a simulation.

\[V_{max} = U_w(x_{100}),\]
\[V_{min} = U_w(x_{0}),\]
\[x_0 = x_{100} - \frac{C}{C_w}.\]

Subscript w indicates working electrode and subscript c indicates counter electrode.

References

Extends: pybamm.BaseModel

property default_solver

Return default solver based on whether model is ODE/DAE or algebraic

pybamm.lithium_ion.get_initial_stoichiometries(initial_soc, parameter_values)

Calculate initial stoichiometries to start off the simulation at a particular state of charge, given voltage limits, open-circuit potentials, etc defined by parameter_values

Parameters:
  • initial_soc (float) – Target initial SOC. Must be between 0 and 1.

  • parameter_values (pybamm.ParameterValues) – The parameter values class that will be used for the simulation. Required for calculating appropriate initial stoichiometries.

Returns:

The initial stoichiometries that give the desired initial state of charge

Return type:

x, y