pybop.models.lithium_ion.basic_SP_diffusion#

Classes#

BaseSPDiffusion

Diffusion model for a single, spherical particle representing a half-cell for GITT.

Module Contents#

class pybop.models.lithium_ion.basic_SP_diffusion.BaseSPDiffusion(name='Single Particle Diffusion Model', electrode='negative', **model_kwargs)[source]#

Bases: pybamm.lithium_ion.BaseModel

Diffusion model for a single, spherical particle representing a half-cell for GITT.

This model can be used with PyBOP through the pybop.SPDiffusion class.

Parameters:

name (str, optional) – The name of the model.
electrode (str, optional) – Either “positive” or “negative” depending on the type of electrode.
**model_kwargs (optional) –
Valid PyBaMM model option keys and their values, for example: parameter_set : pybamm.ParameterValues or dict, optional

The parameters for the model. If None, default parameters provided by PyBaMM are used.

geometrydict, optional
The geometry definitions for the model. If None, default geometry from PyBaMM is used.

submesh_typesdict, optional
The types of submeshes to use. If None, default submesh types from PyBaMM are used.

var_ptsdict, optional
The discretization points for each variable in the model. If None, default points from PyBaMM are used.

spatial_methodsdict, optional
The spatial methods used for discretization. If None, default spatial methods from PyBaMM are used.

solverpybamm.Solver, optional
The solver to use for simulating the model. If None, the default solver from PyBaMM is used.

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

optionsdict, optional
A dictionary of options to customise the behaviour of the PyBaMM model.

R0(sto)[source]#: Series resistance [Ohm].

U(sto)[source]#: Dimensional open-circuit potential [V], calculated as U(x) = U_ref(x). Credit: PyBaMM

static apply_parameter_grouping(parameter_set, electrode) → dict[source]#

A function to create an electrode parameter set from a standard PyBaMM parameter set.

Parameters:

parameter_set (Union[dict, pybop.ParameterSet, pybamm.ParameterValues]) – A dict-like object containing the parameter values.
electrode (str) – Either “positive” or “negative” for the type of electrode.

Returns:

A dictionary of the grouped parameters.

Return type:

dict

build_model()[source]#: Build model variables and equations Credit: PyBaMM

tau_d(sto)[source]#: Diffusion time scale [s] for lithium in the particles.

property default_geometry[source]#: Returns a dictionary of the default geometry for the model, which is empty by default.

property default_parameter_values[source]#: Returns the default parameter values for the model (an empty set of parameters by default).

property default_quick_plot_variables[source]#: Returns the default variables for quick plotting (None by default).

property default_spatial_methods[source]#: Returns a dictionary of the default spatial methods for the model, which is empty by default.

property default_submesh_types[source]#: Returns a dictionary of the default submesh types for the model, which is empty by default.

property default_var_pts[source]#: Returns a dictionary of the default variable points for the model, which is empty by default.

variables[source]#: Returns a dictionary mapping strings to expressions representing the model’s useful variables.