batteryElectrolyte

Electrolyte object for battery P2D model

Since R2026a

expand all in page

    Description

    A batteryElectrolyte object contains information about the properties of the battery electrolyte, including the diffusion coefficient, transference number, and ionic conductivity.

    Creation

    Syntax

    electrolyte = batteryElectrolyte(PropertyName=Value)

    Description

    electrolyte = batteryElectrolyte(PropertyName=Value) creates a batteryElectrolyte object and specifies the properties of the electrolyte. For example, you can specify the diffusion coefficient, transference number, and ionic conductivity of the electrolyte.

    example

    Properties

    expand all

    Rate at which lithium ions diffuse through electrolyte, specified as a positive number or a function handle. A higher diffusion coefficient generally indicates faster ion movement.

    Battery P2D modeling uses SI units of measurements, so the diffusion coefficient must be specified in square meters per second (m2/s).

    Data Types: double | function_handle

    Fraction of the total current carried by lithium ions in the electrolyte, specified as a positive number. A higher transference number indicates more efficient ion transport.

    Data Types: double

    Ionic conductivity, specified as a positive number or a function handle. Battery P2D modeling uses SI units of measurements, so the ionic conductivity must be specified in Siemens per meter (S/m).

    Data Types: double | function_handle

    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

    Topics