batteryElectrode

Electrode object for battery P2D model

Since R2026a

expand all in page

    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.

    example

    Properties

    expand all

    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 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

    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

    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

    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

    collapse all

    Open Live Script

    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

    See Also

    Objects

    Topics