Kinetics

class pybamm.interface.BaseKinetics(param, domain, reaction, options)

Base submodel for kinetics

Parameters

• param – model parameters

• domain (str) – The domain to implement the model, either: ‘Negative’ or ‘Positive’.

• reaction (str) – The name of the reaction being implemented

• options (dict) – A dictionary of options to be passed to the model. See pybamm.BaseBatteryModel

• **Extends (** pybamm.interface.BaseInterface) –

get_coupled_variables(variables)

A public method that creates and returns the variables in a submodel which require variables in other submodels to be set first. For example, the exchange current density requires the concentration in the electrolyte to be created before it can be created. If a variable can be created independent of other submodels then it should be created in ‘get_fundamental_variables’ instead of this method.

Parameters

variables (dict) – The variables in the whole model.

Returns

The variables created in this submodel which depend on variables in other submodels.

Return type

dict

get_fundamental_variables()

A public method that creates and returns the variables in a submodel which can be created independent of other submodels. For example, the electrolyte concentration variables can be created independent of whether any other variables have been defined in the model. As a rule, if a variable can be created without variables from other submodels, then it should be placed in this method.

Returns

The variables created by the submodel which are independent of variables in other submodels.

Return type

dict

set_algebraic(variables)

A method to set the differential equations which do not contain a time derivative. Note: this method modifies the state of self.algebraic. Unless overwritten by a submodel, the default behaviour of ‘pass’ is used as implemented in pybamm.BaseSubModel.

Parameters

variables (dict) – The variables in the whole model.

set_initial_conditions(variables)

A method to set the initial conditions for the submodel. Note: this method modifies the state of self.initial_conditions. Unless overwritten by a submodel, the default behaviour of ‘pass’ is used a implemented in pybamm.BaseSubModel.

Parameters

variables (dict) – The variables in the whole model.

class pybamm.interface.ButlerVolmer(param, domain, reaction, options)

Base submodel which implements the forward Butler-Volmer equation:

\[j = 2 * j_0(c) * \sinh( (ne / (2 * (1 + \Theta T)) * \eta_r(c))\]

Parameters

• param – model parameters

• domain (str) – The domain to implement the model, either: ‘Negative’ or ‘Positive’.

• reaction (str) – The name of the reaction being implemented

• options (dict) – A dictionary of options to be passed to the model. See pybamm.BaseBatteryModel

• **Extends (** pybamm.interface.kinetics.BaseKinetics) –

class pybamm.interface.NoReaction(param, domain, reaction)

Base submodel for when no reaction occurs

Parameters

• param – model parameters

• domain (str) – The domain to implement the model, either: ‘Negative’ or ‘Positive’.

• reaction (str) – The name of the reaction being implemented

• **Extends (** pybamm.interface.kinetics.BaseKinetics) –

class pybamm.interface.ForwardTafel(param, domain, reaction, options)

Base submodel which implements the forward Tafel equation:

\[j = j_0(c) * \exp((ne / (2 * (1 + \Theta T)) * \eta_r(c))\]

Parameters

• param – model parameters

• domain (str) – The domain to implement the model, either: ‘Negative’ or ‘Positive’.

• reaction (str) – The name of the reaction being implemented

• options (dict) – A dictionary of options to be passed to the model. See pybamm.BaseBatteryModel

• **Extends (** pybamm.interface.kinetics.BaseKinetics) –