batteryInitialConditions

Initial conditions for battery P2D model

Since R2026a

expand all in page

    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.

    example

    Properties

    expand all

    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

    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/m3).

    Data Types: double

    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

    Examples

    collapse all

    Open Live Script

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


    model.InitialConditions
    ans = 
  batteryInitialConditions with properties:

               StateOfCharge: 0.5000
                 Temperature: 298.1500
    ElectrolyteConcentration: 1200

    Version History

    Introduced in R2026a

    See Also

    Objects

    Functions

    Topics