主要内容

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

batteryPack

创建模组组件电池包

自 R2024a 起

说明

使用 batteryPack 函数创建一个电池包对象,该对象表示若干个通过串联或并联方式电连接的 ModuleAssembly 对象。有关 Pack 对象及其属性的详细信息,请参阅 Pack (object)

pack = batteryPack 创建一个具有默认属性值的模组组件的电池包。

pack = batteryPack(ModuleAssembly)ModuleAssembly 属性设置为创建一个由一个模组组件组成的电池包。

示例

pack = batteryPack(___,Name=Value) 使用一个或多个名称-值参量指定 pack 属性。在上述任何语法中的所有参量之后指定名称-值参量。有关属性列表,请参阅 Pack 对象的 Properties 部分。

例如,创建一个包含四个默认模组组件的包,这些模组组件串联连接,沿 x 轴堆叠,模组组件之间的间隙为 0.005 米。

pack = batteryPack(...
    repmat(batteryModuleAssembly,1,4), ...
    StackingAxis="X",...
    InterModuleAssemblyGap=simscape.Value(0.005,"m"));

您可以在 ModuleAssembly 属性中定义模组组件的数量和类型。如果包中包含许多属性值完全相同的模组组件,则可以使用 repmat 函数指定 ModuleAssembly 属性。否则,请指定一个不同模组组件数组。

示例

全部折叠

创建一个具有圆柱形几何形状的 Cell 对象。

cell = batteryCell(batteryCylindricalGeometry)

以默认的拓扑结构创建由三个并联电芯组成的 ParallelAssembly 对象。

pSet = batteryParallelAssembly(cell,3)

使用此 ParallelAssembly 对象创建一个由 10 个并联组件串联的 Module 对象,并将其沿 x 轴堆叠。

module = batteryModule(pSet,10,StackingAxis="X")

使用 Module 对象创建一个由四个相同模组串联组成的 ModuleAssembly 对象。

moduleassembly = batteryModuleAssembly(repmat(module,1,4))

使用 ModuleAssembly 对象创建一个由两个串联的相同模组组件组成的 Pack 对象。

pack = batteryPack(repmat(moduleassembly,1,2))

使用 BatteryChart 对象可视化电池包。

packChart = batteryChart(pack);

要定义电池组的电芯平衡策略,请按照 使用两个串联模组组件创建圆柱形电芯组 中的步骤创建电池组。

设置一个通用的电芯平衡策略。

pack.BalancingStrategy = "Passive"

为了保持包及其所有基础组件的 BalancingStrategy 属性的一致性,设置包平衡策略会自动修改包中每个基础模组组件中的所有 BalancingStrategy 属性。

disp(pack.ModuleAssembly(1).Module(1).BalancingStrategy);
disp(pack.ModuleAssembly(2).Module(1).BalancingStrategy);
Passive
Passive

输入参数

全部折叠

电池包中的电池模组组件集,指定为 ModuleAssembly 对象或 ModuleAssembly 对象数组。Pack 对象根据 CircuitConnection 属性将模组组件串联或并联连接。如果包中包含许多具有相同属性值的模组组件,则可以使用 repmat 函数来指定该属性。否则,请指定一个不同模组组件数组。

注意

此属性不会影响 Pack 对象堆叠模组的方式。只有 StackingAxis 属性定义了堆叠策略。

名称-值参数

全部折叠

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

示例: batteryPack(InterModuleAssemblyGap=simscape.Value(0.05,"m"))

注意

此处列出的属性只是其中的一部分。有关完整列表,请参阅 Pack 对象的 Properties 部分。

电池包内模组组件之间的最短距离,指定为正标量或 simscape.Value 对象,该对象表示一个以长度为单位的正标量。此属性的值必须小于 0.1 m

如果直接使用正标量值设置此属性,而不是使用 simscape.Value 对象,则该对象将值转换为以米为物理单位的 simscape.Value 对象。

电池组的荷电状态均衡策略,指定为 "None""Passive""External"

要指定外部电池平衡策略对其建模,请将此属性设置为 "External"。然后,Pack (Generated Block) 会暴露两个电气节点数组端口,即 +BUS-BUS。对于桌面仿真和硬件在环电池仿真硬件,请将此选项与 Passive Balancing Interface 模块结合使用。

注意

设置该属性会自动将其值传播到该 batteryPack 对象内的所有子组件电池对象。但是,这一更改不会传播到 MATLAB 工作区中的其他电池对象。如果在创建此 batteryPack 对象时未设置此属性,则默认值会自动传播到其所有子组件电池对象。

版本历史记录

在 R2024a 中推出