电池构建器
说明
使用电池构建器 App 通过交互式创建、修改和可视化 MATLAB 电池对象，来生成 Simscape™ 电池模型。您可以使用这些 MATLAB 对象来定义自己的电池设计规范，在三维图中可视化电池，在仿真过程中自定义建模分辨率，并生成包含自定义电池模块的 Simulink 库。您可以使用此模块辅助虚拟电池设计与验证，利用 Simulink® 开发电池控制算法，探索设计敏感性，并设计热管理策略。
使用电池构建器 App，您可以：
从您的工作区或 MAT 文件中导入现有的电池对象。
创建新的
Cell、ParallelAssembly、Module、ModuleAssembly和Pack对象。每个电池对象都有其自身的属性及参数。有关电池对象属性的信息，请参阅Cell、ParallelAssembly、Module、ModuleAssembly和Pack文档页面。生成电池对象的三维图，编辑绘图选项，并将图导出为文件。
检查电池对象的层级结构，并可视化其所有子组件。
编辑电池对象的属性，例如几何数据和热边界条件。
将您在 App 中创建的对象导出到工作区、MAT 文件或 STL 文件。
从对象创建一个 Simscape 电池模型。
打开 电池构建器 App
MATLAB® 工具条：在 App 选项卡的 Simscape 下，点击电池构建器图标。
MATLAB 命令提示符：输入
batteryBuilder。
示例
要从工作区或 MAT 文件导入电池对象，请在工具条的电池构建器选项卡下，点击导入区域中的导入按钮。然后点击从工作区导入或从 MAT 文件导入。
注意
当您导入一个对象时，App 也会自动导入其所有子组件电池对象。
要创建新的电池对象，请在工具条的电池构建器选项卡下，点击创建区域中的电芯、并联组件、模组、模组组件或 Pack 按钮。此操作将创建具有默认属性值的对应电池对象。
App 左侧的电池浏览器面板现已包含新对象。您可以选中该对象，在所选电池选项卡中查看其可视化效果，通过电池层次结构面板检查其层级结构及子对象，并在应用程序右侧的属性面板中编辑其属性。
要可视化电池对象，请在电池构建器选项卡下的电池浏览器面板中，选择您要可视化的对象。所选电池选项卡现可显示该对象的 3D 图形。
在电池图选项卡下，您可以编辑图形的多个属性，例如坐标轴标签、坐标轴方向、图形标题以及灯光设置。您还可以检查所选电池对象的当前仿真策略和模型分辨率。要在图中可视化仿真策略，请在工具条的仿真策略部分选中可见框。
要编辑电池对象，请在 App 左侧的电池浏览器面板中选中它。App 右侧的属性面板现已显示该对象的所有可编辑属性。
要应用任何更改，您必须通过点击应用来刷新该对象。
每个电池对象都有其自身的属性及参数。有关电池对象属性的信息，请参阅 Cell、ParallelAssembly、Module、ModuleAssembly 和 Pack 文档页面。
注意
要显示相关属性的对应单位（包括类型为 Simscape.Value 的属性），请将光标悬停在该属性的编辑字段上。
该 App 的属性面板包含 ParallelAssembly、Module、ModuleAssembly 和 Pack 对象的属性，这些属性被划分为六个部分。
只读属性 - 关于电池总质量、体积、能量和容量的数据。您无法修改这些属性。
标识符 - 对象的名称。修改此属性可更改对象在 App 左侧电池浏览器面板中显示的名称。
几何形状 - 关于对象的几何形状信息，例如在图中的位置以及电池的堆叠轴。
属性 - 对象的结构信息，包括父对象创建所依据的子组件对象、这些子对象的堆叠方式以及对象之间的间隙。
模型选项 - 用于配置对象的建模信息，例如启用非电芯电阻或平衡策略的选项。
热模型选项 - 定义对象热边界条件的信息。
创建 ParallelAssembly、Module、ModuleAssembly 或 Pack 对象时，必须同时指定其并联和/或串联的定义子组件，并进行缩放以生成更大的电池系统模型。
例如，电池模组由多个并联组件串联组成。创建 Module 对象时，必须将构成父模组的关联 ParallelAssembly 子组件对象赋值给该 Module 对象。
要将子组件分配给其父组件，请先在电池浏览器面板中选择要分配子组件的父组件。然后，在 App 右侧的属性面板中，进入属性部分，搜索名称与您要分配的子组件相同的属性，并点击选择。
在新窗口中，选中所有子组件并点击添加。
您可以通过点击窗口右侧的相应按钮，对添加的组件进行复制、删除或移动操作。
添加子组件后，请点击确定。此操作将子组件的副本赋值给父组件。您可以在 App 左下角的电池层次结构面板中可视化电池对象的层级结构。
注意
当您将子组件分配给父组件时，父组件会在内部创建一个实例，该实例与电池浏览器面板中的原始子组件没有任何关联。若在电池浏览器面板中修改了原始子组件，且希望将这些更改应用到父组件，则必须重新分配该组件。
您可以在 App 的电池层次结构面板中可视化特定电池对象的所有子组件。在电池层次结构面板中选择一个子组件，即可在 App 右侧的所选电池面板中显示该对象的 3D 图，并在属性面板中显示其属性。
您无法修改在电池层次结构面板中选定的子组件对象的任何属性。要修改对象，请先在电池浏览器面板中选中它们。
电池构建器 App 允许您通过复制、删除或恢复电池对象来管理工作。
要复制电池对象，请先在应用程序左侧的电池浏览器面板中选中该对象。然后，在工具条的电池构建器选项卡下，点击浏览器区域中的复制。此操作将在电池浏览器中创建所选对象的完全相同副本。此重复对象未与原始对象的任何父对象建立关联。
或者，在应用程序左侧的电池层次结构面板中，右键点击要复制的对象，然后点击复制到浏览器。
要删除电池对象，请先在应用程序左侧的电池浏览器面板中选中该对象。然后，在工具条的电池构建器选项卡下，点击浏览器区域中的删除。此操作将该对象从电池浏览器中删除，但不会解除该对象与其任何父对象的关联关系。
若您在电池浏览器中删除的对象是现有父对象的子组件，则可恢复该对象。要恢复一个已被删除但仍在另一个父对象内部关联的电池对象，请先在应用程序左侧的电池浏览器面板中选择仍包含此已删除子组件的父对象。然后，在电池层次结构面板中，右键点击要恢复的对象，并点击复制到浏览器。
要将电池对象导出到工作区、MAT 文件或 STL 文件，请先在应用程序左侧的电池浏览器面板中选中该对象。然后，在工具条的电池构建器选项卡下，点击导出区域中的导出。最后，点击导出到工作区、导出为 MAT 文件或 Export to STL file。您无法将冷却板导出为 STL 文件。
当您为电池对象创建库模型时，电池构建器 App 也会自动将指定的电池对象导出为 MAT 文件。
注意
在 App 中编辑的电池对象不会自动保存到工作区中。若关闭 App，您将丢失当前会话及创建的对象。
要将电池对象的电池图导出为文件（例如 FIG、JPG 或 PNG 文件），请先在电池浏览器面板中选中该电池对象。然后，在电池图选项卡下工具条的导出部分中，点击导出图。
要从 ParallelAssembly、Module、ModuleAssembly 或 Pack 对象创建库模型，请在工具条的库部分下，点击电池构建器选项卡中的创建库。
在新窗口中，请指定要保存库的文件夹、库名称、是否使用数字值或变量名作为掩码参数和掩码初始目标，以及是否显示命令行输出。有关这些字段的更多信息，请参阅 buildBattery 文档页面。
点击创建库按钮，即可在指定文件夹中同时生成电池对象的库模型和 MAT 文件。
打开此模型，即可访问电池对象（作为 Simscape 模块），您可以在早期开发阶段、软件和硬件开发、系统集成和需求评估、冷却系统设计、控制策略开发、硬件在环等许多应用中，将其作为架构评估的起点。
相关示例
版本历史记录
在 R2023a 中推出
