batteryModule
Syntax
Description
Use the batteryModule function to create a battery module object
that represents a number of battery parallel assemblies connected electrically in series. For
more information about the Module object and its properties, see Module
(object).
module = batteryModule creates a parallel assembly that comprises
battery parallel assemblies with default property values.
module = batteryModule( sets
the ParallelAssembly)ParallelAssembly property to create a battery module that comprises
one parallel assembly.
module = batteryModule(
sets the ParallelAssembly,NumSeriesAssemblies)ParallelAssembly and NumSeriesAssemblies
properties to create a battery module with a number of parallel assemblies equal to the
value of the NumSeriesAssemblies property.
module = batteryModule(___,
specifies the Name=Value)module properties using one or more name-value arguments.
Specify the name-value arguments after all the arguments in any of the previous syntaxes.
For a list of properties, see the Properties
section of the Module object.
For example, create a module with four default parallel assemblies stacked along the y-axis with a gap between the parallel assemblies equal to 0.05 m.
module = batteryModule(... batteryParallelAssembly, ... 4, ... StackingAxis="Y",... InterParallelAssemblyGap=simscape.Value(0.05,"m"));
Examples
Create a Cell object with a pouch geometry.
cell = batteryCell(batteryPouchGeometry)
Create a ParallelAssembly object of three cells with the default
topology.
pSet = batteryParallelAssembly(cell,3)
Use this ParallelAssembly object to create a
Module object of 10 parallel assemblies connected in series.
module = batteryModule(pSet,10)
Visualize the module by using a BatteryChart
object.
moduleChart = batteryChart(module);
Create a Cell object and use it to create a
ParallelAssembly object.
cell = batteryCell(batteryCylindricalGeometry)
pSet = batteryParallelAssembly(cell,6,Rows=3,Topology="Square")Use this ParallelAssembly object to create a
Module object of 6 parallel assemblies connected in series.
module = batteryModule(pSet,6,InterParallelAssemblyGap=simscape.Value(0.005,"m"))Discretize this module in three individual electrical models. The second model comprises four of the original parallel assemblies of the module.
module.SeriesGrouping = [1 4 1]
To verify your modeling resolution, visualize the module by using the
BatteryChart object and click on the "Show/hide simulation strategy"
button on the top-right corner of the plot.
moduleChart = batteryChart(module);
Input Arguments
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN, where Name is
the argument name and Value is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Example: batteryModule(ModelResolution="Detailed")
Note
The properties listed here are only a subset. For a complete list, see the Properties
section of the Module object.
Model resolution or fidelity in the simulation, specified as:
"Lumped"— Choose this value for the lowest fidelity. The module uses only one electrical model. To obtain the fastest compilation time and running time, use this value."Detailed"— Choose this value for the highest fidelity. The module uses one electrical model and one thermal model for each battery cell.
"Grouped"— Choose this value to use a custom simulation strategy based on theSeriesGroupingandParallelGroupingproperties.
Modeling strategy for the module along the series connections, specified as a row vector of positive integers.
The length of this vector specifies the number of individual electrical models required. Each entry specifies how many parallel assemblies are lumped within the specified electrical model. For example, if your module comprises four parallel assemblies (NumSeriesAssemblies = 4) and you set this property to [2 1 1], the object discretizes the module in three individual electrical models. The first model comprises two of the original parallel assemblies.
The sum of the entries in this vector must be equal to the value of the NumSeriesAssemblies property.
Dependencies
To enable this property, set the ModelResolution property to "Grouped".
Modeling strategy for every parallel assembly defined in the SeriesGrouping property, specified as a vector of positive integers. The length of this vector must be equal to the length of the SeriesGrouping property value.
Each entry of this vector specifies the number of individual electrical models for entry of the SeriesGrouping property. The values of the entries must be 1 or the value of the NumParallelCells property.
For example, assume that your module comprises these elements:
Four parallel assemblies (
NumSeriesAssemblies=4)48 cylindrical cells for each parallel assembly (
NumParallelCells=48)Three individual electrical models, in which the first model comprises two of the original parallel assemblies (
SeriesGrouping=[2 1 1])
If you set this property to [1 1 48], the object discretizes the module into 50 individual electrical models, where each cell of the fourth parallel assembly has an electrical model.
The value of an entry in this property must be 1 if the value of the corresponding entry of the SeriesGrouping property is larger than 1.
Dependencies
To enable this property, set the ModelResolution property to "Grouped".
Shortest distance between parallel assemblies inside the module, specified as a positive scalar or a simscape.Value object that represents a positive scalar with a unit of length. The value of this property must be less than 0.1 m.
If you set this property directly with a positive scalar value instead of using a simscape.Value object, the object converts the value to a simscape.Value object with meter as its physical unit.
Version History
Introduced in R2024a
