Base classes for battery models
Base classes for batteries
Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).
| Name | Description |
|---|---|
| Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance | |
| Partial cell with sensors | |
| Partial stack with sensors | |
| Parameters for stacks including degradation |
Modelica.Electrical.Batteries.BaseClasses.BaseCellStackBattery 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 |
Modelica.Electrical.Batteries.BaseClasses.BaseCellWithSensorsPartial 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 |
Modelica.Electrical.Batteries.BaseClasses.BaseStackWithSensorsPartial 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 |
Modelica.Electrical.Batteries.BaseClasses.BaseStackDataParameters 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 |