本页采用了机器翻译。点击此处可查看英文原文。

modifyParallelAssembly

修改电池并联组件的属性

自 R2023b 起

全页折叠

语法

updatedBattery = modifyParallelAssembly(battery,Name=Value)

说明

updatedBattery = modifyParallelAssembly(battery,Name=Value) 通过一个或多个名称-值参量，修改电池对象 battery 内部底层 ParallelAssembly 对象的一个或多个属性。要修改单个 ParallelAssembly 对象的属性，请指定 Index 参量。若要修改所有 ParallelAssembly 对象的属性，请勿指定 Index 参量。

示例

示例

全部折叠

本示例演示了如何使用 modifyParallelAssembly 函数快速修改电池包内的电池电芯。

创建一个 Pack 对象，并显示构成该电池包的底层电芯。

battery = batteryPack;
disp(battery.ModuleAssembly(1).Module(1).ParallelAssembly.Cell)
   Cell with properties:

            Geometry: "None"
    CellModelOptions: [1×1 simscape.battery.builder.CellModelBlock]
                Mass: 0.1000 (kg)
            Capacity: 5 (A*hr)
              Energy: 50 (W*hr)

将 battery 内的所有电芯替换为容量为 5 Ah 的圆柱电芯。显示更新后的电芯。

newbatterycell = batteryCell(batteryCylindricalGeometry,Capacity=simscape.Value(5,"Ah"));
updatedbattery = modifyParallelAssembly(battery,"Cell",newbatterycell);
disp(updatedbattery.ModuleAssembly(1).Module(1).ParallelAssembly.Cell)
  Cell with properties:

            Geometry: [1×1 simscape.battery.builder.CylindricalGeometry]
    CellModelOptions: [1×1 simscape.battery.builder.CellModelBlock]
                Mass: 0.1000 (kg)
            Capacity: 5 (Ah)
              Energy: 50 (W*hr)

输入参数

全部折叠

要修改的 ParallelAssembly 目标的父电池目标，指定为 Module、ModuleAssembly 或 Pack 目标。

示例: modifyParallelAssembly(Pack,InterCellGap=0.005) 将 Pack 对象内部所有底层 ParallelAssembly 对象的 InterCellGap 属性值设置为 0.005 m。

名称-值参数

全部折叠

请将参量对指定为 Name1=Value1,...,NameN=ValueN 的形式，其中 Name 是参量名，Value 是相应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

示例: modifyParallelAssembly(Pack,InterCellGap=0.005)

要在父电池对象 battery 中修改的底层 ParallelAssembly 对象的索引，指定为以下值之一：

  • 如果 battery 是一个 ModuleAssembly 对象，则返回一个正整数。

  • 一个由两个正整数组成的向量，其中 battery 是一个 Pack 对象，第一个元素指定父模组组件，第二个元素指定要修改的 ParallelAssembly 对象的父模组组件。例如，如果您有一个名为 Pack 的对象，即 pack，它由两个 ModuleAssembly 对象和四个 Module 对象组成，那么 pack.modifyParallelAssembly(...,Index=[2,3]) 将修改第二个模组组件中的第三个模组。

如果未指定此参量，modifyParallelAssembly 函数将修改电池对象 battery 内所有底层并联组件的指定属性。

依赖关系

要启用此参量，请将 battery 输入指定为 ModuleAssembly 或 Pack 对象。

您可以使用 modifyParallelAssembly 函数，通过名称-值参量来修改父电池对象 battery 内的 ParallelAssembly 对象的所有属性。有关所有受支持的名称-值参量的列表，请参阅 ParallelAssembly 对象的 Properties 部分。

输出参量

全部折叠

包含已修改电池并联组件的父电池对象，以 Module、ModuleAssembly 或 Pack 对象的形式返回。

版本历史记录

在 R2023b 中推出

另请参阅

| | | |

主题