batteryModule
语法
说明
使用 batteryModule 函数创建一个电池模组对象，该对象代表若干个在电气上串联连接的电池并联组件。有关 Module 对象及其属性的详细信息，请参阅 Module (object)。
module = batteryModule 会创建一个并联总成，该总成由具有默认属性值的电池并联组件组成。
module = batteryModule( 将 ParallelAssembly)ParallelAssembly 属性设置为创建一个由一个电池并联组件组成的电池模组。
module = batteryModule( 将 ParallelAssembly,NumSeriesAssemblies)ParallelAssembly 和 NumSeriesAssemblies 属性设置为相应值，以创建一个电池模组，该模组的并联组件数量等于 NumSeriesAssemblies 属性的值。
module = batteryModule(___, 使用一个或多个名称-值参量指定 Name=Value)module 属性。在上述任何语法中的所有参量之后指定名称-值参量。有关属性列表，请参阅 Module 对象的 Properties 部分。
例如，创建一个模组，其中四个默认并联组件沿 y 轴堆叠，并联组件之间的间隙为 0.05 米。
module = batteryModule(... batteryParallelAssembly, ... 4, ... StackingAxis="Y",... InterParallelAssemblyGap=simscape.Value(0.05,"m"));
示例
创建一个具有软包几何形状的 Cell 对象。
cell = batteryCell(batteryPouchGeometry)
创建一个具有默认拓扑结构的三个电芯的 ParallelAssembly 对象。
pSet = batteryParallelAssembly(cell,3)
使用该 ParallelAssembly 对象创建一个由 10 个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,10)
使用 BatteryChart 对象可视化该模组。
moduleChart = batteryChart(module);
创建一个 Cell 对象，并使用它来创建一个 ParallelAssembly 对象。
cell = batteryCell(batteryCylindricalGeometry)
pSet = batteryParallelAssembly(cell,6,Rows=3,Topology="Square")使用此 ParallelAssembly 对象创建一个由 6 个并联组件串联的 Module 对象。
module = batteryModule(pSet,6,InterParallelAssemblyGap=simscape.Value(0.005,"m"))将该模组离散为三个单独的电气模型。第二个模型由四个原始模组的并联组件组成。
module.SeriesGrouping = [1 4 1]
要验证建模分辨率，请使用 BatteryChart 对象可视化模组，然后点击图右上角的“显示/隐藏仿真策略”按钮。
moduleChart = batteryChart(module);
输入参数
名称-值参数
将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
示例: batteryModule(ModelResolution="Detailed")
注意
此处列出的属性只是其中的一部分。有关完整列表，请参阅 Module 对象的 Properties 部分。
仿真中的模型分辨率或保真度，指定为：
"Lumped" - 选择此值可获得最低保真度。该模组仅使用一个电气模型。要获得最短的编译时间和运行时间，请使用该值。
"Detailed" - 选择此值可获得最高保真度。该模组为每个电池电芯使用一个电气模型和一个热模型。
"Grouped" - 选择此值以使用基于
SeriesGrouping和ParallelGrouping属性的自定义仿真策略。
沿串联连接的模组建模策略，指定为正整数的行向量。
该向量的长度指定所需的单独电气模型数量。每个条目指定指定电气模型中包含多少个并联组件。例如，如果模组由四个并联组件（NumSeriesAssemblies = 4）组成，并将此属性设置为 [2 1 1]，则对象将模组离散为三个单独的电气模型。第一个模型由两个原始的并联组件组成。
此向量中的条目之和必须等于 NumSeriesAssemblies 属性的值。
依赖关系
要启用此属性，请将 ModelResolution 属性设置为 "Grouped"。
SeriesGrouping 属性中定义的每个并联组件的建模策略，指定为正整数的向量。该向量的长度必须与 SeriesGrouping 属性的值的长度相等。
该向量的每个条目指定了用于输入 SeriesGrouping 属性的单独电气模型的数量。条目的值必须为 1 或 NumParallelCells 属性的值。
例如，假设您的模组包含以下元素：
四个并联组件 (
NumSeriesAssemblies=4)每个并联组件有 48 个圆柱形电芯（
NumParallelCells=48）三个单独的电气模型，其中第一个模型包括两个原始并联组件（
SeriesGrouping=[2 1 1]）
如果将此属性设置为 [1 1 48]，则对象将模组离散为 50 个单独的电气模型，其中第四个并联组件的每个电芯都有一个电气模型。
如果 SeriesGrouping 属性的相应条目的值大于 1，则此属性中的条目值必须为 1。
依赖关系
要启用此属性，请将 ModelResolution 属性设置为 "Grouped"。
模组内并联组件之间的最短距离，指定为正标量或 simscape.Value 对象，该对象表示一个以长度为单位的标量。该属性的值必须小于 0.1 米。
如果直接使用正标量值设置此属性，而不是使用 simscape.Value 对象，则对象将值转换为以米为物理单位的 simscape.Value 对象。
版本历史记录
在 R2024a 中推出
