Modelica.Electrical.Batteries.BaseClasses

Base classes for battery models

Information

Base classes for batteries

Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).

Package Content

Name Description
Modelica.Electrical.Batteries.BaseClasses.BaseCellStack BaseCellStack Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance
Modelica.Electrical.Batteries.BaseClasses.BaseCellWithSensors BaseCellWithSensors Partial cell with sensors
Modelica.Electrical.Batteries.BaseClasses.BaseStackWithSensors BaseStackWithSensors Partial stack with sensors
Modelica.Electrical.Batteries.BaseClasses.BaseStackData BaseStackData Parameters for stacks including degradation

Modelica.Electrical.Batteries.BaseClasses.BaseCellStack Modelica.Electrical.Batteries.BaseClasses.BaseCellStack

Battery with open-circuit voltage dependent on state of charge, self-discharge and inner resistance

Information

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.

Note

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

Parameters

NameDescription
NsNumber of serial connected cells
NpNumber of parallel connected cells
cellDataCell parameters
useHeatPort=true, if HeatPort is enabled
TFixed device temperature if useHeatPort = false [K]
Custom Parameters
displaySOCSOC for display
Initialization
SOCState of charge
Advanced
SOCtoleranceTolerance to detect depleted of overcharged battery

Connectors

NameDescription
pPositive electrical pin
nNegative electrical pin
heatPortOptional port to which dissipated losses are transported in form of heat

Modelica.Electrical.Batteries.BaseClasses.BaseCellWithSensors Modelica.Electrical.Batteries.BaseClasses.BaseCellWithSensors

Partial cell with sensors

Information

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

Parameters

NameDescription
cellDataCell parameters
SOC0Initial SOC
useHeatPort=true, if HeatPort is enabled
TFixed device temperature if useHeatPort = false [K]
cellCell
Custom Parameters
displaySOCSOC for display
Advanced
SOCtoleranceSOC tolerance for detection of depleted or overcharged cell

Connectors

NameDescription
pPositive electrical pin
nNegative electrical pin
heatPortOptional port to which dissipated losses are transported in form of heat
cellBusCell bus

Modelica.Electrical.Batteries.BaseClasses.BaseStackWithSensors Modelica.Electrical.Batteries.BaseClasses.BaseStackWithSensors

Partial stack with sensors

Information

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

Parameters

NameDescription
stackData 
useAllParallelConnections= true, if all parallel connections are used
SOC0[stackData.Ns, stackData.Np]Initial SOC
useHeatPort=true, if HeatPort is enabled
TFixed device temperature if useHeatPort = false [K]
cell[stackData.Ns, stackData.Np]Matrix of cells
Custom Parameters
displaySOCSOC for display
Advanced
SOCtoleranceSOC tolerance for detection of depleted or overcharged cell

Connectors

NameDescription
pPositive electrical pin
nNegative electrical pin
stackBusStack bus
batteryBusBattery 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.BaseStackData Modelica.Electrical.Batteries.BaseClasses.BaseStackData

Parameters for stacks including degradation

Information

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

Parameters

NameDescription
NsNumber of series connected cells
NpNumber of parallel connected cells
kDegraded[:, 2]Indices of degraded cells [series index, parallel index]
cellDataOriginalOriginal cell data
cellDataDegradedDegraded cell data
Result
cellData[Ns, Np]Matrix of cell data
Automatically generated Thu Oct 1 16:07:40 2020.