BattMo.jl

Appearance

Input terminology ​

This section describes the key terminology related to input parameters in BattMo. The input parameters influence both the physical behavior of the battery model and the numerical methods used for solving equations. These parameters are categorized based on their role in describing experimental conditions and numerical settings which divides them into two main groups:

  • Parameters

  • Settings

Parameters ​

Parameters represent the controllable variables in real-world experiments.

They can be categorized based on their purpose:

  • Cell parameters: Define the characteristics of a battery cell. Instantiated with type CellParameters.

  • Cycling protocol parameters: Specify how the cell is operated during a simulation (experiment). Instantiated with type CyclingProtocol.

Cell Parameters ​

These parameters characterize the intrinsic properties of a battery cell, such as:

json
{"NegativeElectrode": {
    "ElectrodeCoating": {
      "BruggemanCoefficient": 1.5,
      "EffectiveDensity": 1900.0,
      "Thickness": 1.0e-4,
      "Width": 1.0e-2,
      "Length": 2.0e-2,
      "Area": 0.0002,
      "SurfaceCoefficientOfHeatTransfer": 1000
    }}}

All parameter values should be given in SI units. Examples of cell parameter sets can be found here.

Cycling Parameters ​

These parameters define the operational conditions of the battery during a simulation, such as:

json
    {
  "Protocol": "CCDischarge",
  "InitialStateOfCharge": 0.99,
  "DRate": 1.0,
  "LowerVoltageLimit": 2.5,
  "UpperVoltageLimit": 4.1,
  "InitialControl": "discharging",
  "AmbientTemperature": 298.15,
  "InitialTemperature": 298.15
}

Examples of cycling protocol sets can be found here.

Settings ​

Settings are used to configure numerical assumptions for solving equations and finding numerical solutions.

They can be categorized based on their purpose:

Model Settings ​

Define numerical assumptions related to the battery model, such as diffusion methods or simplifications used in the simulation:

json
{
    "ModelFramework": "P2D",
    "TransportInSolid": "FullDiffusion",
    "CurrentCollectors": false,
    "RampUp": "Sinusoidal",
    "SEIModel": "Bolay"
}

Examples of model settings can be found here.

Simulation Settings ​

Define numerical assumptions specific to the simulation process, including time-stepping schemes and discretization precision:

json
{
    "GridResolution": {
        "PositiveElectrodeCoating": 10,
        "PositiveElectrodeActiveMaterial": 10,
        "NegativeElectrodeCoating": 10,
        "NegativeElectrodeActiveMaterial": 10,
        "Separator": 10
    },
    "Grid": [],
    "TimeStepDuration": 50,
    "RampUpTime": 10,
    "RampUpSteps": 5
}

Examples of simulation settings can be found here.