pybop.models.lithium_ion.base_model#

Classes#

BaseGroupedModel

A base model for PyBOP's grouped-parameter lithium-ion battery models.

Module Contents#

class pybop.models.lithium_ion.base_model.BaseGroupedModel(name='Base Model', **model_kwargs)[source]#

Bases: pybamm.lithium_ion.BaseModel

A base model for PyBOP’s grouped-parameter lithium-ion battery models.

Parameters:

  • name (str, optional) – The name of the model.

  • **model_kwargs (optional) –

    Valid PyBaMM model option keys and their values, for example: options : dict, optional

    A dictionary of options to customise the behaviour of the PyBaMM model.

    buildbool, optional

    If True, the model is built upon creation (default: False).

build_model()[source]#

Build model variables and equations Credit: PyBaMM

static set_initial_state(initial_value, parameter_values, direction=None, param=None, inplace=True, options=None, inputs=None, tol=1e-06)[source]#

Set the value of the initial state of charge.

Parameters:

  • initial_value (float) – Target initial value. If float, 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) – Parameters and their corresponding values.

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

  • inplace (bool, optional) – If True, replace the parameters values in place. Otherwise, return a new set of parameter values. Default is True.

  • options (dict-like, optional) – A dictionary of options to be passed to the model, see pybamm.BatteryModelOptions.

  • inputs (dict, optional) – A dictionary of input parameters to pass to the model when solving.

  • tol (float, optional) – The tolerance for the solver used to compute the initial stoichiometries. A lower value results in higher precision but may increase computation time. Default is 1e-6.