batteryCellModelBlock
说明
使用 batteryCellModelBlock 函数来构造 Cell 对象的 CellModelOptions 属性。该属性包含您在 CellModelBlockPath 属性中指定的模块的条件参数。有关 CellModelBlock 对象及其属性的详细信息，请参阅 CellModelBlock (object)。
默认情况下，CellModelBlockPath 属性使用 Battery Equivalent Circuit 模块，但您也可以使用 Battery (Table-Based) 模块，或者指定自己的自定义模块。有关详细信息，请参阅 CellModelBlockPath 属性。
注意
生成的电池模块始终使用您在电池对象的 CellModelBlockPath 属性中指定的电池电芯模块参数的默认值，无论您对其进行了何种修改。您可以修改的电芯模块参数仅限于 BlockParameters 属性中列出的条件参数。
cellModelOpt = batteryCellModelBlock 为 Cell 对象设置默认模型选项。若要针对您的应用程序修改这些选项，请使用点表示法。如需查看选项的完整列表，请参阅 cellModelBlock 对象的 Properties。
cellModelOpt = batteryCellModelBlock( 将 CellModelBlockPath)Cell 对象的组件模型模块的库路径设置为 Simscape 电池电芯模块。默认情况下，CellModelBlockPath 属性使用 Battery Equivalent Circuit 模块，但您也可以使用 Battery (Table-Based) 模块，或者指定自己的自定义模块。
示例
输入参数
指向 Simscape 电池电芯模块的库路径，以字符串形式指定。默认的组件模型模块是 Battery Equivalent Circuit 模块。
您也可以使用 Battery (Table-Based) 或指定自己的自定义模块，只要该自定义模块满足以下所有要求即可：
该自定义模块必须提供恰好两个名为 n 和 p 的电量保存端口。
所有变量必须是标量型。
自定义模块中不能包含名为 power_dissipated 的变量或中间变量。
您可以将自定义模块连接到任意数量的热节点。该软件将所有节点并行连接起来。
如果您指定了自己的自定义模块，则 BlockParameters 结构的字段取决于您在自定义模块中指定的参数。若要针对您的应用程序修改这些选项，请使用点表示法。
有关如何基于自定义电池组件构建电池模型的更多信息，请参阅 基于自定义电芯组件构建电池模型 示例。 (自 R2026a 起)
Input and Output Ports of Custom Blocks
使用自定义模块作为电芯模型模块生成的电池模块，会暴露该自定义模块相同的输入端口 (自 R2026a 起)和输出端口 (自 R2024b 起)。输入和输出按水平方向连接，对于由并行组装和模组生成的模块，它们是物理信号；对于由模组组件和封装生成的模块，它们是 Simulink® 信号。
注意
生成的电池模块不会暴露无类型的输入。有关组件输入的更多信息，请参阅 inputs。
例如，创建一个带有电压 输出端口的自定义模块：
% ... outputs voltageCell; %voltage end equations voltageCell == [ParallelAssembly1(:).voltageCell]'; end % ...
Cell、ParallelAssembly、Module 和 ModuleAssembly 对象，并利用 buildBattery 函数生成 ModuleAssembly 单元块。随后，生成的 ModuleAssembly 模块公开了电压端口：
