mtnlion.models.lithium_plating module

Isothermal model extended with lithium plating

class mtnlion.models.lithium_plating.LithiumPlating(Ns)[source]

Bases: mtnlion.models.isothermal.Isothermal

Lithium plating often occurs when the manufacturer-specified upper voltage on the cell is not observed, which can cause a cell to become inoperable within a few overcharge events.

class Overpotential[source]

Bases: mtnlion.formula.Formula

Voltage difference between a reduction potential and the potential of the redox event.

form(arguments, domain)[source]

This method must be overloaded to define the form of the Formula.

Parameters

  • arguments – All arguments defined by overriding one or more of Formula.Variables, Formula.Formulas, Formula.Parameters, Formula.Lambdas, and Formula.TimeDiscretization

  • domain – The current domain in which the function is being evaluated

Returns

FFL form

class SideReactionExchangeCurrentDensity[source]

Bases: mtnlion.formula.Formula

The current in the absence of net electrolysis and at zero overpotential in the side reaction.

form(arguments, domain)[source]

This method must be overloaded to define the form of the Formula.

Parameters

  • arguments – All arguments defined by overriding one or more of Formula.Variables, Formula.Formulas, Formula.Parameters, Formula.Lambdas, and Formula.TimeDiscretization

  • domain – The current domain in which the function is being evaluated

Returns

FFL form

class SideReactionFlux[source]

Bases: mtnlion.formula.Formula

Describes how the electrical current on an electrode depends on the electrode potential due to the side reaction.

form(arguments, domain)[source]

Flux through the boundary of the solid.

class SideReactionOverpotential[source]

Bases: mtnlion.formula.Formula

Voltage difference between a reduction potential and the potential of the redox event in the side reaction.

form(arguments, domain)[source]

This method must be overloaded to define the form of the Formula.

Parameters

  • arguments – All arguments defined by overriding one or more of Formula.Variables, Formula.Formulas, Formula.Parameters, Formula.Lambdas, and Formula.TimeDiscretization

  • domain – The current domain in which the function is being evaluated

Returns

FFL form