Other Materials¶
Supporting material types used throughout the package: separator membranes, current collector foils, container housings, laminate films, insulation coatings, adhesive tapes, and flex-frame materials.
Material definitions for auxiliary battery cell components.
This module defines material classes for current collectors, insulation,
separators, tapes, containers, flex frames, and laminates. Each class
wraps basic material properties (density, cost, color) and can be loaded
from the built-in database via from_database().
Classes¶
CurrentCollectorMaterial(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, Metal
Metal material used for current collector foils.
Current collector materials are typically aluminum (cathode side) or copper (anode side).
Initialize a current collector material.
Parameters¶
name : str Name of the current collector material (e.g., "Aluminum", "Copper"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material 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.
InsulationMaterial(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Ceramic or polymer insulation coating material applied to electrode edges.
Insulation materials (e.g., Al₂O₃) are applied to uncoated regions of the current collector to prevent short circuits at electrode boundaries.
Initialize an insulation material.
Parameters¶
name : str Name of the insulation material (e.g., "Aluminium Oxide, 99.5%"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material 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.
SeparatorMaterial(name: str, density: float, specific_cost: float, porosity: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Porous separator membrane material.
Separators electrically isolate the anode from the cathode while allowing ion transport through their pore structure. The porosity determines the electrolyte uptake capacity.
Initialize a separator material.
Parameters¶
name : str Name of the separator material (e.g., "Polyethylene"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material in $/kg. porosity : float Porosity of the separator material in % (0–100). 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.
TapeMaterial(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Adhesive tape material used for winding termination on jelly rolls.
Tape wraps secure the outer layers of wound electrode assemblies and provide mechanical stability.
Initialize a tape material.
Parameters¶
name : str Name of the tape material (e.g., "Kapton"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material 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.
PrismaticContainerMaterial(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Metal material used for prismatic and cylindrical cell casings.
Typical materials include aluminum and steel for canisters, lids, and terminal connectors.
Initialize a container material.
Parameters¶
name : str Name of the container material (e.g., "Steel", "Aluminum"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material 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.
FlexFrameMaterial(name: str, density: float, specific_cost: float, color: str = '#B3AA9E', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Polymer material used for flex-frame cell housings.
Flex frames are rigid polymer borders (e.g., PEEK) that hold the electrode stack and are sealed with laminate sheets.
Initialize a flex-frame material.
Parameters¶
name : str Name of the flex-frame material (e.g., "PEEK"). density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material in $/kg. color : str, optional Hex color string for visualization (default: "#B3AA9E"). volume : float or None, optional Initial volume in cm³. mass : float or None, optional Initial mass in g.
LaminateMaterial(name: str, density: float, specific_cost: float, color: str = '#2c2c2c', *, volume=None, mass=None, **kwargs)
Bases: _VolumedMaterialMixin, _Material
Multi-layer laminate film material for pouch cell encapsulation.
Laminate films are used as the outer packaging in pouch cells and flex-frame cells, providing a lightweight hermetic seal.
Initialize a laminate material.
Parameters¶
name : str Name of the laminate material. density : float Density of the material in g/cm³. specific_cost : float Specific cost of the material 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.