batteryElectrode

Electrode object for battery P2D model

Since R2026a

Description

A batteryElectrode object contains information about the battery anode and cathode, including the thickness, porosity, Bruggeman's coefficient, electrical conductivity, and active material properties.

Creation

Syntax

electrode = batteryElectrode(PropertyName=Value)

Description

electrode = batteryElectrode(PropertyName=Value) creates a batteryElectrode object and specifies the properties of the electrode. For example, you can specify the thickness of the electrode layer, its porosity, and Bruggeman's coefficient.

Properties

Thickness — Thickness of anode or cathode layer

positive number

Thickness of the electrode (anode or cathode) layer in the battery, specified as a positive number. Battery P2D modeling uses SI units of measurements, so the thickness must be specified in meters (m).

Data Types: double

Porosity — Porosity of anode or cathode

positive number

Porosity of the electrode (anode or cathode), specified as a positive number. Porosity is the fraction of the electrode's volume not occupied by solid materials, such as the active material, additives, and binders.

Data Types: double

BruggemanCoefficient — Bruggeman's coefficient

positive number

Bruggeman's coefficient, specified as a positive number. Bruggeman's coefficient relates the porosity of the material to its effective conductivity and diffusivity.

Data Types: double

ElectricalConductivity — Electrical conductivity

positive number

Electrical conductivity, specified as a positive number. Electrical conductivity is the ability of the anode or cathode material to conduct electricity. Because the anode and cathode are porous with additives, this value is not a material property, but an equivalent value.

Battery P2D modeling uses SI units of measurements, so the electrical conductivity must be specified in Siemens per meter (S/m).

Data Types: double

ActiveMaterial — Active material properties

batteryActiveMaterial object

Active material properties, specified as a batteryActiveMaterial object. Active material properties include the particle radius, volume fraction, maximum solid-phase concentration, diffusion coefficient, reaction rate constant, open circuit potential, and stoichiometric limits.

Data Types: double

Examples

Specify Anode and Cathode Properties

Create a model for the battery P2D analysis, and specify the parameters of the electrodes as the Anode and Cathode properties of the model.

Both the anode and cathode materials require the open circuit potential specification, which determines the voltage profile of the battery during charging and discharging. The open circuit potential is a voltage of electrode material as a function of the stoichiometric ratio, which is the ratio of intercalated lithium in the solid to maximum lithium capacity. You can specify this ratio by interpolating the gridded data set.

sNorm = linspace(0.025, 0.975, 39);
ocp_n_vec = [.435;.325;.259;.221;.204; ...
             .194;.179;.166;.155;.145; ...
             .137;.131;.128;.127;.126; ...
             .125;.124;.123;.122;.121; ...
             .118;.117;.112;.109;.105; ...
             .1;.098;.095;.094;.093; ...
             .091;.09;.089;.088;.087; ...
             .086;.085;.084;.083];
ocp_p_vec = [3.598;3.53;3.494;3.474; ...
             3.46;3.455;3.454;3.453; ...
             3.4528;3.4526;3.4524;3.452; ...
             3.4518;3.4516;3.4514;3.4512; ...
             3.451;3.4508;3.4506;3.4503; ...
             3.45;3.4498;3.4495;3.4493; ...
             3.449;3.4488;3.4486;3.4484; ...
             3.4482;3.4479;3.4477;3.4475; ...
             3.4473;3.447;3.4468;3.4466; ...
             3.4464;3.4462;3.4458];

anodeOCP = griddedInterpolant(sNorm,ocp_n_vec,"linear","nearest");
cathodeOCP = griddedInterpolant(sNorm,ocp_p_vec,"linear","nearest");

Create objects that specify active materials for the anode and cathode.

anodeMaterial = batteryActiveMaterial( ...
    ParticleRadius=5E-6, ...
    MaximumSolidConcentration=30555, ...
    VolumeFraction=0.58, ...
    DiffusionCoefficient=3.0E-15, ...
    ReactionRate=8.8E-11, ...
    OpenCircuitPotential=@(st_ratio) anodeOCP(st_ratio), ...
    StoichiometricLimits=[0.0132 0.811]);

cathodeMaterial = batteryActiveMaterial(...
    ParticleRadius=5E-8, ...
    MaximumSolidConcentration=22806, ...
    VolumeFraction=0.374, ...
    DiffusionCoefficient=5.9E-19, ...
    ReactionRate=2.2E-13, ...
    OpenCircuitPotential=@(st_ratio) cathodeOCP(st_ratio), ...
    StoichiometricLimits=[0.035 0.74]);

Next, create objects that specify both electrodes.

anode = batteryElectrode(...
    Thickness=34E-6, ...
    Porosity=0.3874, ...
    BruggemanCoefficient=1.5, ...
    ElectricalConductivity=100, ...
    ActiveMaterial=anodeMaterial);

cathode = batteryElectrode(...
    Thickness=80E-6, ...
    Porosity=0.5725, ...
    BruggemanCoefficient=1.5, ...
    ElectricalConductivity=0.5, ...
    ActiveMaterial=cathodeMaterial);

Create a battery pseudo-2D model using these objects to specify the Anode and Cathode properties of the model.

model = batteryP2DModel( ...
    Anode=anode, ...
    Cathode=cathode)

model = 
  batteryP2DModel with properties:

   Components
                   Anode: [1×1 batteryElectrode]
                 Cathode: [1×1 batteryElectrode]
               Separator: [1×1 batterySeparator]
             Electrolyte: [1×1 batteryElectrolyte]

   Configurations
       InitialConditions: [1×1 batteryInitialConditions]
             CyclingStep: [1×1 batteryCyclingStep]
           SolverOptions: [1×1 batterySolverOptions]

   Constants
         FaradayConstant: 96487
    UniversalGasConstant: 8.3140

Version History

Introduced in R2026a