batteryP2DModel

P2D model for battery analysis

Since R2026a

expand all in page

    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.

    example

    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.

    example

    Properties

    expand all

    Components

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

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

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

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

    Configurations

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

    Cycling step, specified as a batteryCyclingStep object. Cycling step includes the normalized current and hold voltage values, maximum simulation time, cutoff normalized current, maximum and minimum voltage limits, and the time step.

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

    Constants

    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

    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

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

    Examples

    collapse all

    Open Live Script

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

    See Also

    Objects

    Functions

    Topics