主要内容

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

batteryCell

制造单个电化学电池电芯

自 R2024a 起

说明

使用 batteryCell 函数构建一个电池对象,该对象代表单个电化学电芯。有关 Cell 对象及其属性的更多信息,请参阅 Cell (object)

cell = batteryCell 创建一个具有默认值的一个电池电芯。该对象与 Battery (Table-Based) 模块相关联。

cell = batteryCell(Geometry) 设置 Geometry 属性以创建具有特定几何形状的单个电池电芯。

示例

cell = batteryCell(Geometry,CellModelOptions) 设置 GeometryCellModelOptions 属性,用于创建具有特定几何形状和条件参数的单个电池电芯。

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

例如,cell = batteryCell(Mass=simscape.Value(1,"kg")) 创建了一个质量为 1 千克的默认电池电芯。

示例

全部折叠

创建一个具有圆柱几何形状的 Cell 对象,并将电池电芯的排列首选堆叠方向设置为 X 轴。

geometry = batteryCylindricalGeometry
cell = batteryCell(geometry,StackingAxis="X")

使电芯的半径加倍。

cell.Geometry.Radius = 2*cell.Geometry.Radius

修改电芯的位置。

cell.Position = [1 1 1]

使用 BatteryChart 对象可视化该电芯。

cellChart = batteryChart(cell)

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

geometry = batteryCylindricalGeometry
cell = batteryCell(geometry)

为电芯选择参数化方案。设置 ParameterizationManufacturerParameterizationPartNumber 属性。

cell.ParameterizationManufacturer = "A123";
cell.ParameterizationPartNumber = "ALM12V7";

使用 applyCellDataFromPart 函数应用参数化数据。

cell = cell.applyCellDataFromPart;

输入参数

全部折叠

与特定电芯格式关联的电芯几何参数集,指定为 CylindricalGeometry 对象、PouchGeometry 对象或 PrismaticGeometry 对象。

用于仿真的电芯组件模型模块的条件参数,指定为 CellModelBlock 对象。默认情况下,电芯组件模型模块为 Battery (Table-Based) 模块。您也可以通过相应地设置 CellModelBlock 对象的 CellModelBlockPath 属性,来使用您自己的电芯组件模型模块。

名称-值参数

全部折叠

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

示例: batteryCell(Mass=simscape.Value(1,"kg"))

注意

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

电池电芯的质量,指定为 simscape.Value 对象,该对象表示具有指定计量单位的标量。该属性的值必须严格为正且小于 100 千克。

若直接使用正标量值设置此属性(而非通过 simscape.Value 对象),该对象会将值转换为 simscape.Value 对象,其物理单位为 kg

自 R2023a 起

电池电芯的容量,以 simscape.Value 对象形式指定,该对象表示单位为安培小时的标量。该属性的值必须严格为正。该值不会被传递到生成的电池模型中。

若直接使用正标量值设置此属性(而非通过 simscape.Value 对象),该对象会将值转换为 simscape.Value 对象,其物理单位为 A*hr

自 R2023a 起

电池电芯的能量,指定为 simscape.Value 对象,该对象表示具有指定计量单位的标量。该属性的值必须严格为正。该值不会被传递到生成的电池模型中。

若直接使用正标量值设置此属性(而非通过 simscape.Value 对象),该对象会将值转换为 simscape.Value 对象,其物理单位为 W*hr

电池电芯的空间位置在三维笛卡尔坐标系中,以实数且有限的向量形式指定。当您将 Cell 对象链接到父级电池对象(例如 ParallelAssembly 对象)时,父级对象会覆盖此位置。

二维笛卡尔坐标系中电池电芯排列的优先堆叠方向,指定为 "X""Y"

下图显示了电池的全球坐标系。

电池电芯的名称,指定为字符串。

版本历史记录

在 R2024a 中推出