batteryModuleAssembly
语法
说明
使用 batteryModuleAssembly 创建一个模组组件对象，该对象代表多个电连接或并联的 Module 对象。有关 ModuleAssembly 对象及其属性的详细信息，请参阅 ModuleAssembly (object)。
moduleassembly = batteryModuleAssembly 创建一个模组组件，该组件包含具有默认属性值的电池模组。
moduleassembly = batteryModuleAssembly(___, 使用一个或多个名称-值参量指定 Name=Value)moduleassembly 属性。在上述任何语法中的所有参量之后指定名称-值参量。有关属性的列表，请参阅 ModuleAssembly 对象的 Properties 部分。
例如，创建一个电池模组组件，其中包含两个默认模组，这些模组串联并沿 y 轴堆叠，每个模组之间的间隙为 0.05 米。
moduleassembly = batteryModuleAssembly(... repmat(batteryModule,1,2), ... StackingAxis="Y",... InterModuleGap=simscape.Value(0.005,"m"));
您可以在 Module 属性中定义模组的数量和类型。如果模组组件包含许多具有相同属性值的模组，则可以使用 repmat 函数来指定 Module 属性。否则，请指定一个不同模组的数组。
示例
创建一个具有软包几何形状的 Cell 对象。
cell = batteryCell(batteryPouchGeometry)
以默认的拓扑结构创建由三个并联电芯组成的 ParallelAssembly 对象。
pSet = batteryParallelAssembly(cell,3)
使用该 ParallelAssembly 对象创建一个由 10 个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,10)
使用此 Module 对象创建一个由四个相同模组串联组成的 ModuleAssembly 对象。
moduleassembly = batteryModuleAssembly(repmat(module,1,4))
使用 BatteryChart 对象可视化模组组件。
moduleAssemblyChart = batteryChart(moduleassembly);
创建一个具有圆柱形几何形状的 Cell 对象，并启用其热效应建模。
battCell = batteryCell(batteryCylindricalGeometry);
battCell.CellModelOptions.BlockParameters.thermal_port = "model";创建一个 ParallelAssembly 对象，该对象采用默认拓扑结构，由 30 个并联电芯组成，分五行排列。
pSet = batteryParallelAssembly(battCell,30,Rows=5);
使用此 ParallelAssembly 对象创建一个由两个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,2);
使用该 Module 对象创建由六个串联的相同模组组成的 ModuleAssembly 对象。
moduleAssembly = batteryModuleAssembly(repmat(module,1,6));
将一个冷却板分配给模组组件的底部，并选择 Parallel Channels 模块作为冷却板模块。
moduleAssembly.CoolingPlate = "Bottom"; moduleAssembly.CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels";
通过调用 buildBattery 函数来构建此 ModuleAssembly 对象。
buildBattery(moduleAssembly,"LibraryName","Permutation1_SingleBottomCoolingPlate",... "MaskParameters","VariableNamesByType","MaskInitialTargets","VariableNamesByInstance");
下图显示了 ModuleAssembly 对象的内部结构：
创建一个具有圆柱形几何形状的 Cell 对象，并启用其热效应建模。
battCell = batteryCell(batteryCylindricalGeometry);
battCell.CellModelOptions.BlockParameters.thermal_port = "model";创建一个 ParallelAssembly 对象，该对象采用默认拓扑结构，由 30 个并联电芯组成，分五行排列。
pSet = batteryParallelAssembly(battCell,30,Rows=5);
使用此 ParallelAssembly 对象创建一个由两个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,2);
使用该 Module 对象创建由六个串联的相同模组组成的 ModuleAssembly 对象。
moduleAssembly = batteryModuleAssembly(repmat(module,1,6));
将冷却板分配给模组组件内的第一个、第三个和第五个模组的底部，并选择 Parallel Channels 模块作为冷却板模块。
moduleAssembly.Module(1).CoolingPlate = "Bottom"; moduleAssembly.Module(1).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels"; moduleAssembly.Module(3).CoolingPlate = "Bottom"; moduleAssembly.Module(3).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels"; moduleAssembly.Module(5).CoolingPlate = "Bottom"; moduleAssembly.Module(5).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels";
通过调用 buildBattery 函数来构建此 ModuleAssembly 对象。
buildBattery(moduleAssembly,"LibraryName","Permutation2_ModuleSpecificBottomCoolingPlate",... "MaskParameters","VariableNamesByType","MaskInitialTargets","VariableNamesByInstance");
下图显示了 ModuleAssembly 对象的内部结构：
创建一个具有圆柱形几何形状的 Cell 对象，并启用其热效应建模。
battCell = batteryCell(batteryCylindricalGeometry);
battCell.CellModelOptions.BlockParameters.thermal_port = "model";创建一个 ParallelAssembly 对象，该对象采用默认拓扑结构，由 30 个并联电芯组成，分五行排列。
pSet = batteryParallelAssembly(battCell,30,Rows=5);
使用此 ParallelAssembly 对象创建一个由两个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,2);
使用该 Module 对象创建由六个串联的相同模组组成的 ModuleAssembly 对象。
moduleAssembly = batteryModuleAssembly(repmat(module,1,6));
将一个冷却板分配给模组组件的顶部，并选择 Parallel Channels 模块作为冷却板模块。
moduleAssembly.CoolingPlate = "Top"; moduleAssembly.CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels";
通过调用 buildBattery 函数来构建此 ModuleAssembly 对象。
buildBattery(moduleAssembly,"LibraryName","Permutation3_SingleTopCoolingPlate",... "MaskParameters","VariableNamesByType","MaskInitialTargets","VariableNamesByInstance");
下图显示了 ModuleAssembly 对象的内部结构：
创建一个具有圆柱形几何形状的 Cell 对象，并启用其热效应建模。
battCell = batteryCell(batteryCylindricalGeometry);
battCell.CellModelOptions.BlockParameters.thermal_port = "model";创建一个 ParallelAssembly 对象，该对象采用默认拓扑结构，由 30 个并联电芯组成，分五行排列。
pSet = batteryParallelAssembly(battCell,30,Rows=5);
使用此 ParallelAssembly 对象创建一个由两个串联的并联组件组成的 Module 对象。
module = batteryModule(pSet,2);
使用该 Module 对象创建由六个串联的相同模组组成的 ModuleAssembly 对象。
moduleAssembly = batteryModuleAssembly(repmat(module,1,6));
将冷却板分配给模组组件内的第一个、第三个和第五个模组的顶部，并选择 Parallel Channels 模块作为冷却板模块。
moduleAssembly.Module(1).CoolingPlate = "Top"; moduleAssembly.Module(1).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels"; moduleAssembly.Module(3).CoolingPlate = "Top"; moduleAssembly.Module(3).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels"; moduleAssembly.Module(5).CoolingPlate = "Top"; moduleAssembly.Module(5).CoolingPlateBlockPath = "batt_lib/Thermal/Parallel Channels";
通过调用 buildBattery 函数来构建此 ModuleAssembly 对象。
buildBattery(moduleAssembly,"LibraryName","Permutation4_ModuleSpecificTopCoolingPlate",... "MaskParameters","VariableNamesByType","MaskInitialTargets","VariableNamesByInstance");
下图显示了 ModuleAssembly 对象的内部结构：
输入参数
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
示例: batteryModuleAssembly(InterModuleGap=simscape.Value(0.05,"m"))
注意
此处列出的属性只是其中的一部分。完整列表，请参阅 ModuleAssembly 对象的 Properties 部分。
模组组件内模组之间的最短距离，指定为正标量或 simscape.Value 对象，该对象表示一个以长度为单位的正标量。该属性的值必须小于 0.1 米。
如果直接使用正标量值设置此属性，而不是使用 simscape.Value 对象，则该对象将值转换为以米为物理单位的 simscape.Value 对象。
模组之间的电气连接类型，指定为 "Series 或 "Parallel"。
模组组件的层数、级数或楼层数，以正整数指定。此属性的值必须小于或等于模组组件中的模组数量。
ModuleAssembly 对象根据组件中的层数和模组数以对称方式堆叠模组。
例如，此图显示了当您将此属性设置为 2 时，ModuleAssembly 对象如何堆叠四个相同的模组。
此图显示了当您仍将此属性设置为 2 时，ModuleAssembly 对象如何堆叠五个相同的模组。
此图显示了当您将此属性设置为 3 时，ModuleAssembly 对象如何堆叠五个相同的模组。
版本历史记录
在 R2024a 中推出
