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

buildBattery

R2025b

从电池对象构建自定义库模块

自 R2022b 起

全页折叠

语法

buildBattery(battery,Name=Value)

描述

buildBattery(battery,Name=Value) 从电池对象 battery 生成一个或多个自定义 Simscape™ 库文件以及一个 MAT 文件。您可以从 ParallelAssembly、Module、ModuleAssembly 和 Pack 对象构建自定义的 Simscape 库文件。

注意

当为 ParallelAssembly 和 Module 对象生成库文件时，buildBattery 函数首先生成对应的 Simscape SSC 文件，随后调用 ssc_build 函数生成库文件。

由 ModuleAssembly 和 Pack 对象生成的模块是 Simulink® 子系统，该子系统包含并联组件和 Module 模块。

示例

示例

全部折叠

通过依次创建 Cell、ParallelAssembly、Module 和 ModuleAssembly 对象，生成一个 Pack 对象。

import simscape.battery.builder.*;
batteryCell = Cell(Geometry=CylindricalGeometry);
pSet = ParallelAssembly(Cell=batteryCell,NumParallelCells=48,Topology="Hexagonal",Rows=4);
module = Module(ParallelAssembly=pSet,NumSeriesAssemblies=4);
moduleAssembly = ModuleAssembly(Module=repmat(module,1,2));
pack = Pack(ModuleAssembly=repmat(moduleAssembly,1,4),BalancingStrategy="Passive");

pack = 

  Pack with properties:

    ModuleAssembly: [1×4 simscape.battery.builder.ModuleAssembly]

使用 buildBattery 函数从 Pack 对象构建库文件。向函数提供名称-值参量，为库命名并指定输出文件夹。

buildBattery(pack,LibraryName="myBatteries",Directory="C:\Work\BatteryFolder")

Generating Simulink library 'myBatteries_lib' in the current directory 'C:\Work\BatteryFolder' ...

该图展示了函数完成库文件生成后文件夹中的内容：

打开生成的库文件 myBatteries_lib SLX，即可访问 ParallelAssembly 和 Module 对象，将其作为 Simscape 模块使用。

打开生成的库 myBatteries SLX 文件，以访问 ModuleAssembly 和 Pack 对象作为 Simscape 子系统。

输入参数

全部折叠

用于生成自定义 Simscape 库模块的电池对象，指定为 ParallelAssembly、Module、ModuleAssembly 或 Pack 对象。

注意

当您创建一个电池对象时，buildBattery 函数也会同时创建其所有子组件。例如，若构建一个 Pack 对象，该函数将为构成该包的 ModuleAssembly、Module 和 ParallelAssembly 对象生成自定义的 Simscape 库模块。

示例: buildBattery(batteryPack) 从名为 batteryPack 的 Pack 电池对象构建一个模块库。

名称-值参数

全部折叠

示例: buildBattery(batteryPack,LibraryName="myBatteries",Directory="C:\Work\batteryLibFolder")

由电池对象生成的模块库和 MAT 文件的名称，指定为字符向量或字符串标量。从 ParallelAssembly 或 Module 对象生成的库文件名称带有后缀 _lib。

示例: buildBattery(batteryPack,LibraryName="myBatteries") 构建两个名为 myBatteries 和 myBatteries_lib 的库，并从名为 Pack 的电池对象 batteryPack 中生成名为 myBatteries 的 MAT 文件。

指定要存储生成的模块库和 MAT 文件的文件夹名称及位置，该值应为字符向量或字符串标量。

示例: buildBattery(batteryPack,Directory="C:\Work\batteryLibFolder") 从名为 batteryPack 的 Pack 电池对象构建库，该对象位于 C:\Work\batteryLibFolder 文件夹中。

在 Battery 属性中定义的每种模组和并联组件中，有选项使用默认值或变量名称作为参数。

若将此参量设置为 "VariableNamesByType"，该函数将生成包含所有仿真所需运行时参数的脚本。这些参数随后被用于生成的库中所有同类型电池对象的实例中。当您需要同时修改所有电池对象类型的实例参数时，请使用此选项。

若需对生成的库中每个模组或并联组件的实例分别进行参数化设置，请将此参量设为 "VariableNamesByInstance"。然后该函数生成一个脚本，其中包含同一类型电池对象的每个实例的一组参数。例如，如果 ModuleAssembly 模块包含五个相同类型的 Module 模块，则该函数将为生成的库中的五个模组实例生成五组不同的参数。 (自 R2023b 起)

在 Battery 属性中定义的每种模组和并联组件中，可选择使用默认值或变量名称作为初始目标的选项。若将此参量设为 "VariableNamesByInstance"，该函数将生成包含所有仿真所需初始条件的脚本。

在构建库时控制此函数命令行输出的选项，可设置为'off'、'on'，或数值型/逻辑型参数 1 (true) 或 0 (false)。'On' 的值等效于 true，而 'off' 的值等效于 false。因此，您可以将此属性的值用作逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

版本历史记录

在 R2022b 中推出

全部展开

另请参阅

App

对象

Simscape 模块

主题