batteryInitialConditions

R2026b

Initial conditions for battery P2D model

Since R2026a

Description

A batteryInitialConditions object contains information about the initial conditions of the battery, including the initial state of charge, electrolyte concentration, and temperature.

Creation

Syntax

ic = batteryInitialConditions(PropertyName=Value)

Description

ic = batteryInitialConditions(PropertyName=Value) creates a batteryInitialConditions object and specifies the properties of the initial conditions. For example, you can specify the initial state of charge (SoC) of the battery, initial electrolyte concentration, and initial temperature.

Properties

StateOfCharge — Initial state of charge (SoC)

number from 0 to 1

Initial state of charge (SoC) of the battery, specified as a number from 0 to 1. This value sets the starting condition for the battery simulation.

Data Types: double

ElectrolyteConcentration — Initial electrolyte concentration

positive number

Initial electrolyte concentration, specified as a positive number. Battery P2D modeling uses SI units of measurements, so the electrolyte concentration must be specified in moles per cubic meter (mol/m³).

Data Types: double

Temperature — Initial temperature

positive number

Initial temperature, specified as a positive number. This property assumes that the battery operates isothermally, so the temperature is constant throughout the simulation. Battery P2D modeling uses SI units of measurements, so the temperature must be specified in kelvin (K).

Data Types: double

InitialSEIThickness — Initial thickness of SEI layer

positive number

Initial thickness of the SEI layer, specified as a positive number.

Data Types: double

Examples

Specify Initial Conditions of Battery

Create an object that specifies the initial electrolyte concentration, state of charge, and temperature of the battery.

ic = batteryInitialConditions(...
    ElectrolyteConcentration=1200, ...
    StateOfCharge=0.5, ...
    Temperature=298.15);

Create a battery pseudo-2D model using this object to specify the InitialConditions property of the model.

model = batteryP2DModel( ...
InitialConditions=ic)

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

model.InitialConditions

ans = 
  batteryInitialConditions with properties:

               StateOfCharge: 0.5000
                 Temperature: 298.1500
    ElectrolyteConcentration: 1200
         InitialSEIThickness: []

Specify Initial Conditions for Battery Model with SEI Aging

Create an object that specifies the initial conditions of the battery, including the initial thickness of the SEI layer..

ic = batteryInitialConditions( ...
ElectrolyteConcentration=1000, ...
StateOfCharge=0.05, ...
Temperature=298.15, ...
InitialSEIThickness=5e-9)

ic = 
  batteryInitialConditions with properties:

               StateOfCharge: 0.0500
                 Temperature: 298.1500
    ElectrolyteConcentration: 1000
         InitialSEIThickness: 5.0000e-09

Version History

Introduced in R2026a

R2026b: Define initial SEI layer thickness for battery aging

Define the initial SEI layer thickness with the InitialSEIThickness property of batteryInitialConditions.