Electrode SOH models

class pybamm.lithium_ion.ElectrodeSOHSolver(parameter_values, param=None, known_value='cyclable lithium capacity')

Class used to check if the electrode SOH model is feasible, and solve it if it is.

Parameters:

• parameter_values (pybamm.ParameterValues.Parameters) – The parameters of the simulation

• param (pybamm.LithiumIonParameters, optional) – Specific instance of the symbolic lithium-ion parameter class. If not provided, the default set of symbolic lithium-ion parameters will be used.

• known_value (str, optional) – The known value needed to complete the electrode SOH model. Can be “cyclable lithium capacity” (default) or “cell capacity”.

get_initial_stoichiometries(initial_value)

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_value (float) – Target initial value. If integer, interpreted as SOC, must be between 0 and 1. If string e.g. “4 V”, interpreted as voltage, must be between V_min and V_max.

Returns:

The initial stoichiometries that give the desired initial state of charge

Return type:

x, y

get_min_max_stoichiometries()

Calculate min/max stoichiometries given voltage limits, open-circuit potentials, etc defined by parameter_values

Returns:

The min/max stoichiometries

Return type:

x_0, x_100, y_100, y_0

pybamm.lithium_ion.get_initial_stoichiometries(initial_value, parameter_values, param=None, known_value='cyclable lithium capacity')

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_value (float) – Target initial value. If integer, interpreted as SOC, must be between 0 and 1. If string e.g. “4 V”, interpreted as voltage, must be between V_min and V_max.

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

• param (pybamm.LithiumIonParameters, optional) – The symbolic parameter set to use for the simulation. If not provided, the default parameter set will be used.

Returns:

The initial stoichiometries that give the desired initial state of charge

Return type:

x, y

pybamm.lithium_ion.get_min_max_stoichiometries(parameter_values, param=None, known_value='cyclable lithium capacity')

Calculate min/max stoichiometries given voltage limits, open-circuit potentials, etc defined by parameter_values

Parameters:

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

• param (pybamm.LithiumIonParameters, optional) – The symbolic parameter set to use for the simulation. If not provided, the default parameter set will be used.

Returns:

The min/max stoichiometries

Return type:

x_0, x_100, y_100, y_0