主要内容

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

modifyCell

修改电芯属性

自 R2023b 起

说明

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

示例

示例

全部折叠

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

创建一个 Pack 对象,并显示构成该电池包的电池电芯的质量。

battery = batteryPack;
disp(battery.ModuleAssembly(1).Module(1).ParallelAssembly.Cell.Mass)
0.1000 : kg

battery 内部所有电池电芯的质量更改为 1 千克。显示更新后的质量。

updatedbattery = modifyCell(battery,Mass=simscape.Value(1,"kg")); 
disp(updatedbattery.ModuleAssembly(1).Module(1).ParallelAssembly.Cell.Mass)
1 : kg

本示例演示了如何使用 modifyCell 函数,仅修改电池包内特定模组和模组组件中电池电芯的质量。

创建一个由两个相同的 ModuleAssembly 对象组成的 Pack 对象。每个 ModuleAssembly 目标由六个相同的 Module 目标组成。

module = batteryModule;
moduleassembly = batteryModuleAssembly(repmat(module,6,1));
battery=batteryPack(repmat(moduleassembly,2,1));

显示第二个模组组件内第五个模组中电池电芯的质量。

disp(battery.ModuleAssembly(2).Module(5).ParallelAssembly.Cell.Mass)
0.1000 : kg

battery 的第二个模组组件内第五个模组的电池电芯质量更改为 10 千克。显示更新后的质量。

updatedbattery = modifyCell(battery,Index=[2,5],Mass=simscape.Value(10,"kg"));
disp(updatedbattery.ModuleAssembly(2).Module(5).ParallelAssembly.Cell.Mass)
10 : kg

输入参数

全部折叠

要修改的 Cell 对象的父电池对象,应指定为 ParallelAssemblyModuleModuleAssemblyPack 对象。

示例: modifyCell(pSet,Mass=1)ParallelAssembly 对象 pSet 内部所有底层 Cell 对象的 Mass 属性值设置为 1 Kg

名称-值参数

全部折叠

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

示例: modifyCell(pSet, Mass=100)

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

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

  • 一个由两个正整数组成的向量,如果 battery 是一个 Pack 对象。该向量的第一个和第二个元素分别定义了包含您要修改的 Cell 对象的模组组件和模组的第一和第二个索引。

如果未指定此参量,modifyCell 函数将修改电池对象 battery 内所有底层电芯的指定属性。

依赖关系

要启用此参量,请将 battery 输入指定为 ModuleAssemblyPack 对象。

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

输出参量

全部折叠

包含已修改电池电芯的父级电池对象,以 ParallelAssemblyModuleModuleAssemblyPack 对象的形式返回。

版本历史记录

在 R2023b 中推出