Skip to content

Electrolytes

Liquid electrolyte materials used to fill electrode assemblies. The electrolyte fills the pore volume of the assembly plus an overfill percentage.

electrolyte = ocd.Electrolyte(
    name="1M LiPF6 in EC:DMC (1:1)",
    density=1.2, specific_cost=15.0, color="#00FF00",
)

Electrolytes

Electrolyte material definitions for battery cells.

Classes

Electrolyte

Electrolyte(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)

Bases: _VolumedMaterialMixin, _Material

Liquid electrolyte material used to fill battery cells.

The electrolyte fills the pore volume of the electrode assembly and separator. Volume and mass ranges are set dynamically based on the pore volume of the assembly via _set_ranges_from_pore_volume.

Initialize an electrolyte material.

Parameters

name : str Name of the electrolyte (e.g., "1M LiPF6 in EC:DMC (1:1)"). density : float Density of the electrolyte in g/cm³. specific_cost : float Specific cost of the electrolyte in $/kg. color : str, optional Hex color string for visualization (default: "#2c2c2c"). volume : float or None, optional Initial volume in cm³. mass : float or None, optional Initial mass in g.

Attributes
volume_range property
volume_range: Tuple[float, float]

Get the allowable electrolyte volume range in cm³.

mass_range property
mass_range: Tuple[float, float]

Get the allowable electrolyte mass range in g.