batteryP2DModel

R2026b

P2D model for battery analysis

Since R2026a

Description

A batteryP2DModel object contains information about a pseudo-2D (P2D) model, including the properties of the anode, cathode, separator, electrolyte, initial conditions, and cycling step.

Creation

Syntax

model = batteryP2DModel

model = batteryP2DModel(PropertyName=Value)

Description

model = batteryP2DModel creates a battery pseudo-2D model with default properties.

model = batteryP2DModel(PropertyName=Value) sets properties for the model using one or more name-value arguments. For example, you can specify the anode and cathode properties.

Properties

Components

Anode — Anode properties

batteryElectrode object

Anode properties, specified as a batteryElectrode object. Anode properties include thickness, porosity, Bruggeman's coefficient, electric conductivity, material properties, and parameters for the Solid Electrolyte Interphase (SEI) growth mechanism defining the battery calender aging.

Cathode — Cathode properties

batteryElectrode object

Cathode properties, specified as a batteryElectrode object. Cathode properties include thickness, porosity, Bruggeman's coefficient, electric conductivity, and material properties.

Separator — Separator properties

batterySeparator object

Separator properties, specified as a batterySeparator object. Separator properties include thickness, porosity, and Bruggeman's coefficient.

Electrolyte — Electrolyte properties

batteryElectrolyte object

Electrolyte properties, specified as a batteryElectrolyte object. Electrolyte properties include diffusion coefficient, transference number, and ionic conductivity.

Configurations

InitialConditions — Initial conditions

batteryInitialConditions object

Initial conditions, specified as a batteryInitialConditions object. Initial conditions include the initial state of charge (SoC), electrolyte concentration, and temperature.

CyclingStep — Cycling step

batteryCyclingStep object | vector of batteryCyclingStep objects

Cycling step, specified as a batteryCyclingStep object or vector of batteryCyclingStep objects. A batteryCyclingStep object includes the normalized current and hold voltage values, maximum simulation time, cutoff normalized current, maximum and minimum voltage limits, and the time step. Use a vector of such objects to specify a sequence of processes, such as charging, discharging, resting, and charging with constant voltage, in any combination and order.

SolverOptions — Solver options

batterySolverOptions object

Solver options, specified as a batterySolverOptions object. Solver options include mesh and ODE solver settings.

Constants

FaradayConstant — Faraday constant

96487 C/mol (default) | positive number

Faraday constant, specified as a positive number, stored as a positive number. The Faraday constant represents the charge of one mole of electrons, and is used in electrochemical calculations to relate the charge and moles of electrons.

Data Types: double

UniversalGasConstant — Universal gas constant

8.314 J/(mol·K) (default) | positive number

Universal gas constant, specified as a positive number. The universal gas constant is used in thermodynamic calculations involving temperature and energy.

Data Types: double

Object Functions

solve

Solve structural, heat transfer, electromagnetic, or P2D battery simulation problem

Examples

Battery Pseudo-2D Model

Create a model for the battery P2D analysis.

model = batteryP2DModel

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: 96485
    UniversalGasConstant: 8.3140

You can specify the parameters of the anode, cathode, separator, electrolyte, initial conditions, cycling step, and so on by setting the properties of the model. For example, specify the properties of the electrolyte and the separator.

electrolyte = batteryElectrolyte(...
    DiffusionCoefficient=2E-10, ...
    TransferenceNumber=0.363, ...
    IonicConductivity=0.29);

separator = batterySeparator(...
    Thickness=25E-6, ...
    Porosity=0.45, ...
    BruggemanCoefficient=1.5);

model.Electrolyte = electrolyte;
model.Separator = separator;
model.Electrolyte

ans = 
  batteryElectrolyte with properties:

    DiffusionCoefficient: 2.0000e-10
      TransferenceNumber: 0.3630
       IonicConductivity: 0.2900

model.Separator

ans = 
  batterySeparator with properties:

               Thickness: 2.5000e-05
                Porosity: 0.4500
    BruggemanCoefficient: 1.5000

Alternatively, you can specify battery parameters when creating the model.

model2 = batteryP2DModel( ...
    Electrolyte=electrolyte, ...
    Separator=separator);

model2.Electrolyte

ans = 
  batteryElectrolyte with properties:

    DiffusionCoefficient: 2.0000e-10
      TransferenceNumber: 0.3630
       IonicConductivity: 0.2900

model2.Separator

ans = 
  batterySeparator with properties:

               Thickness: 2.5000e-05
                Porosity: 0.4500
    BruggemanCoefficient: 1.5000

Version History

Introduced in R2026a

R2026b: Specify vector of cycling steps

Specify a sequence of processes, such as charging, discharging, and resting, in any combination and order by assigning a vector of batteryCyclingStep objects to the CyclingStep property.