Base classes for battery models
Base classes for batteries
Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).
Name | Description |
---|---|
BaseCellStack | Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance |
BaseCellWithSensors | Partial cell with sensors |
BaseStackWithSensors | Partial stack with sensors |
BaseStackData | Parameters for stacks including degradation |
Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance
The battery is modeled by open-circuit voltage (OCV) dependent on state of charge (SOC), a self-discharge component and an inner resistance.
Parameters are collected in parameter record cellData.
All losses are dissipated to the optional heatPort
.
For details, see concept and parameterization.
SOC > SOCmax and SOC < SOCmin triggers an error.
Extends from Modelica.Electrical.Batteries.Icons.BatteryIcon (Icon for cells and stacks), Modelica.Electrical.Analog.Interfaces.TwoPin (Component with two electrical pins), Modelica.Electrical.Analog.Interfaces.PartialConditionalHeatPort (Partial model to include a conditional HeatPort in order to dissipate losses, used for graphical modeling, i.e., for building models by drag-and-drop).
Name | Description |
---|---|
Ns | Number of serial connected cells |
Np | Number of parallel connected cells |
cellData | Cell parameters |
useHeatPort | =true, if HeatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
Custom Parameters | |
displaySOC | SOC for display |
Initialization | |
SOC | State of charge |
Advanced | |
SOCtolerance | Tolerance to detect depleted of overcharged battery |
Name | Description |
---|---|
p | Positive electrical pin |
n | Negative electrical pin |
heatPort | Optional port to which dissipated losses are transported in form of heat |
Partial cell with sensors
This is a single cell[Np=1, Ns=1] with measurement.
Extends from Modelica.Electrical.Batteries.Icons.BatteryIcon (Icon for cells and stacks), Modelica.Electrical.Analog.Interfaces.TwoPin (Component with two electrical pins), Modelica.Electrical.Analog.Interfaces.PartialConditionalHeatPort (Partial model to include a conditional HeatPort in order to dissipate losses, used for graphical modeling, i.e., for building models by drag-and-drop).
Name | Description |
---|---|
cellData | Cell parameters |
SOC0 | Initial SOC |
useHeatPort | =true, if HeatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
cell | Cell |
Custom Parameters | |
displaySOC | SOC for display |
Advanced | |
SOCtolerance | SOC tolerance for detection of depleted or overcharged cell |
Name | Description |
---|---|
p | Positive electrical pin |
n | Negative electrical pin |
heatPort | Optional port to which dissipated losses are transported in form of heat |
cellBus | Cell bus |
Partial stack with sensors
This is a stack of Ns
x Np
cell[Np=1, Ns=1] with measurement, arranged in a matrix.
Extends from Modelica.Electrical.Batteries.Icons.BatteryIcon (Icon for cells and stacks), Modelica.Electrical.Analog.Interfaces.TwoPin (Component with two electrical pins).
Name | Description |
---|---|
stackData | |
useAllParallelConnections | = true, if all parallel connections are used |
SOC0[stackData.Ns, stackData.Np] | Initial SOC |
useHeatPort | =true, if HeatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
cell[stackData.Ns, stackData.Np] | Matrix of cells |
Custom Parameters | |
displaySOC | SOC for display |
Advanced | |
SOCtolerance | SOC tolerance for detection of depleted or overcharged cell |
Name | Description |
---|---|
p | Positive electrical pin |
n | Negative electrical pin |
stackBus | Stack bus |
batteryBus | Battery bus (average / sum over all cells) |
heatPort[stackData.Ns, stackData.Np] | Optional port to which dissipated losses are transported in form of heat |
Parameters for stacks including degradation
This record contains the base cell data definition of original and degraded cell data.
Extends from Modelica.Electrical.Batteries.Icons.BaseStackRecord (Indicates base stack data).
Name | Description |
---|---|
Ns | Number of series connected cells |
Np | Number of parallel connected cells |
kDegraded[:, 2] | Indices of degraded cells [series index, parallel index] |
cellDataOriginal | Original cell data |
cellDataDegraded | Degraded cell data |
Result | |
cellData[Ns, Np] | Matrix of cell data |