Electrode State of Health Calculations

class ionworkspipeline.calculations.ElectrodeSOH(options=None)

Calculate minimum and maximum electrode stoichiometries for a full-cell using the electrode-specific SOH algorithm from [1].

Parameters

optionsdict, optional

A dictionary of options to be passed to the calculation. The following options are available:

• known value: str

  The value to use to calculate the minimum and maximum stoichiometries. Options are “cyclable lithium capacity” (default) or “cell capacity”.

References

[1]

Mohtat, P., Lee, S., Siegel, J. B., & Stefanopoulou, A. G. (2019). Towards better estimability of electrode-specific state of health: Decoding the cell expansion. Journal of Power Sources, 427, 101-111.

Extends: ionworkspipeline.calculations.calculation.Calculation

class ionworkspipeline.calculations.ElectrodeSOHHalfCell(electrode, options=None)

Calculate minimum and maximum electrode stoichiometries for a half-cell using the electrode-specific SOH algorithm.

See ElectrodeSOH for more details.

Parameters

electrodestr

The electrode to calculate the initial concentration for, either “positive” or “negative”.

optionsdict, optional

A dictionary of options to be passed to the calculation. The following options are available:

• simulation_kwargs: dict

  Keyword arguments to pass to the simulation (iwp.Simulation). Default is None.

Extends: ionworkspipeline.calculations.calculation.Calculation

class ionworkspipeline.calculations.OpenCircuitLimits

Set open-circuit voltage limits to be the same as voltage cut-off limits.

Extends: ionworkspipeline.calculations.calculation.Calculation

class ionworkspipeline.calculations.MSMRElectrodeSOHHalfCell(electrode)

Calculate minimum and maximum electrode stoichiometries for a half-cell by evaluating the extent of lithiation at the minimum and maximum OCV.

See ElectrodeSOH for more details.

Extends: ionworkspipeline.calculations.calculation.Calculation

class ionworkspipeline.calculations.StoichiometryLimitsFromCapacity

Calculate the minimum and maximum stoichiometries for each electrode in a full-cell based on the electrode total capacity, lower and upper excess capacities.

Extends: ionworkspipeline.calculations.calculation.Calculation

class ionworkspipeline.calculations.StoichiometryAtMinimumSOC(electrode)

Calculate the stoichiometry at the minimum SOC based on the stoichiometry at the maximum SOC, the electrode capacities, and the useable capacity.

Parameters

electrodestr

The electrode to calculate the initial concentration for, either “positive” or “negative”.

Extends: ionworkspipeline.calculations.calculation.Calculation