管理设计数据

选择如何存储、分区和共享小型工程和复杂模型层次结构的模型设计数据

设计数据是指您用来指定 Simulink^® 模型中的模块参数和信号特征（如数据类型和维度）的一组变量和数据对象。设计数据的存储选项包括 MATLAB^® 基础工作区、模型工作区或数据字典。选择设计数据的位置可能取决于：

建模目的
模型架构
数据类型

要了解模型数据的类型以及如何管理工程的数据存储，请参阅确定在何处存储 Simulink 模型的变量和对象。

要了解如何以编程方式管理数据，请参阅Manage Design Data for Simulink Models Programmatically。

函数

管理数据源

`Simulink.data.connect`	Create `Simulink.data.DataConnection` object for a data source (自 R2024a 起)
`clear`	Remove specified variables from connected data source (自 R2024a 起)
`clearAll`	Remove variables from connected data source (自 R2024a 起)
`create`	Create object in connected data source (自 R2024a 起)
`discardChanges`	Discard data in memory and reload from connected data source (自 R2024a 起)
`exist`	Determine whether variable exists in connected data source (自 R2024a 起)
`get`	Read variables from connected data source (自 R2024a 起)
`getMetadata`	Get metadata for variable or connected data source (自 R2024a 起)
`hasUnsavedChanges`	Determine whether connected data source has unsaved data in memory (自 R2024a 起)
`isConsistent`	Determine whether variable definitions visible to connected data source are consistent (自 R2024a 起)
`rename`	Rename specified variables in connected data source (自 R2024a 起)
`reportInconsistency`	Report inconsistent variable definitions (自 R2024a 起)
`saveChanges`	Save data in memory for connected data source to disk (自 R2024a 起)
`set`	Assign variable in connected data source (自 R2024a 起)
`show`	Open and show contents of connected data source in Model Explorer (自 R2024a 起)
`who`	List variables that are in connected data source (自 R2024a 起)

管理数据字典

`Simulink.data.dictionary.create`	创建新的数据字典并创建 `Simulink.data.Dictionary` 对象
`Simulink.data.dictionary.open`	打开数据字典进行编辑
`Simulink.data.dictionary.getOpenDictionaryPaths`	Return file names and paths of open data dictionaries
`Simulink.dictionary.archdata.create`	Create Simulink data dictionary and Architectural Data object (自 R2023b 起)
`Simulink.dictionary.archdata.open`	Create Architectural Data object representing architectural data of existing Simulink data dictionary (自 R2023b 起)
`Simulink.LibraryDictionary.clear`	Clear library dictionary dependency analysis (自 R2021a 起)
`Simulink.LibraryDictionary.refresh`	Update library dictionary dependencies (自 R2021a 起)
`Simulink.LibraryDictionary.resetLibraryLinks`	Clear cached information on library dictionary links (自 R2022a 起)

管理外部文件适配器

`Simulink.data.adapters.catalog`	List registered file adapters (自 R2022b 起)
`Simulink.data.adapters.registerAdapter`	Register custom file adapter (自 R2022b 起)
`Simulink.data.adapters.unregisterAdapter`	Unregister custom file adapter (自 R2022b 起)

管理变量

`Simulink.findVars`	分析模型中的变量与模块之间的关系
`matlab.io.saveVariablesToScript`	将工作区变量保存到 MATLAB 脚本中
`Simulink.data.evalinGlobal`	Evaluate MATLAB expression in context of Simulink model
`Simulink.data.assigninGlobal`	Modify variable values in context of Simulink model
`Simulink.data.existsInGlobal`	Check existence of variable in context of Simulink model

对象

全部展开

数据源

Simulink.data.DataConnection Data source connection (自 R2024a 起)

模型工作区

Simulink.ModelWorkspace 以编程方式与模型的模型工作区进行交互

数据字典

`Simulink.data.Dictionary`	配置数据字典
`Simulink.data.dictionary.Section`	配置数据字典分区
`Simulink.data.dictionary.Entry`	Configure data dictionary entry
`Simulink.data.dictionary.EnumTypeDefinition`	Store enumerated type definition in data dictionary
`Simulink.dictionary.ArchitecturalData`	Edit architectural data in a Simulink data dictionary programmatically (自 R2023b 起)
`Simulink.dictionary.archdata.DataInterface`	Edit data interface in Simulink data dictionary programmatically (自 R2023b 起)
`Simulink.dictionary.archdata.DataElement`	Data element of data interface (自 R2023b 起)
`Simulink.dictionary.archdata.PhysicalInterface`	Physical interface (自 R2023b 起)
`Simulink.dictionary.archdata.PhysicalElement`	Physical element of a physical interface (自 R2023b 起)
`Simulink.dictionary.archdata.FunctionElement`	Function in client-server interface (自 R2023b 起)
`Simulink.dictionary.archdata.FunctionArgument`	Function argument in function element of client-server interface (自 R2023b 起)
`Simulink.dictionary.archdata.ServiceInterface`	Service interface (自 R2023b 起)
`Simulink.dictionary.archdata.StructType`	Structure data type (自 R2023b 起)
`Simulink.dictionary.archdata.StructElement`	Struct element of a struct type (自 R2023b 起)

外部文件适配器

`Simulink.data.adapters.BaseMatlabFileAdapter`	Base class used to define file adapter for reading custom file formats (自 R2022b 起)
`Simulink.data.DataSourceWorkspace`	Contains data for external data source (自 R2022b 起)
`Simulink.data.adapters.AdapterDataTester`	Test custom external file adapter (自 R2022b 起)

对象和变量

`Simulink.WorkspaceVar`	Store information about workspace variables and blocks that use them
`Simulink.VariableUsage`	Store information about the relationship between variables and blocks in models
`Simulink.CoderInfo`	指定为信号、状态或参数数据生成代码所需的信息

主题

Simulink 模型的数据存储

确定在何处存储 Simulink 模型的变量和对象
Simulink 数据是指您在工作区（例如，基础工作区或数据字典）中创建的对象和变量。选择一种永久存储数据的方式。
Manage Design Data for Simulink Models Programmatically
Connect to a data source, such as a model workspace, base workspace, or data dictionary, then use a common set of functions to manage the data.
创建、编辑和管理工作区变量
工作区变量使您能够在模块和模型之间共享信息，例如参数值和数据类型。使用不同工具和方法来创建和操作工作区变量。
使用模型资源管理器编辑和管理工作区变量
查找模型或模块使用的工作区变量、查找使用某个变量的模块、查找未使用的变量，以及重命名模块在任意位置使用的某个变量。在单独的文件中保存和加载变量。

数据存储在模型工作区中

模型工作区
将模型使用的变量和对象放置在只有该模型可以访问的工作区中。
更改模型工作区数据
当您将数据存储在模型工作区中时，可以选择数据源，例如，模型文件或外部 MAT 文件。要在数据源中修改变量，可以使用不同的过程，具体取决于您选择的数据源类型。
在模型工作区中指定数据源
将模型使用的变量和对象存储在模型文件或单独文件中。（可选）将变量和对象存储为您可修改的代码。

数据存储在字典中

什么是数据字典？
使用数据字典存储模型的外部数据。
Import and Export Dictionary Data
Migrate data between a data dictionary and a MAT-file or MATLAB script file.
View and Revert Changes to Dictionary Data
Use a data dictionary to inspect and manage changes to model data.
Graphically Manage Shared Interfaces, Data Types, and Constants
To share interfaces, data types, and constants across components and compositions modeled in Simulink, use the Architectural Data section of a data dictionary.
迁移模型以使用 Simulink 数据字典
将变量和对象存储在数据字典中。
Partition Dictionary Data Using Referenced Dictionaries
Create referenced dictionaries to store subsets of the data that a model or model hierarchy uses.
Partition Data for Model Reference Hierarchy Using Data Dictionaries
Compose a dictionary hierarchy based on a model reference hierarchy.
Attach Data Dictionary to Custom Libraries
Share data objects with Simulink block library users using attached data dictionary.
Attach Data Dictionary to Subsystem Reference
Use a Simulink data dictionary with child blocks and instances of your subsystem file.
Enumerations in Data Dictionary
Store enumerated type definitions and enumerated data in a data dictionary.
以编程方式将数据存储到字典中
使用脚本和命令提示符创建数据字典并与之进行交互。

外部文件中的数据存储

Create External File Adapter for Loading Variables into Simulink.SimulationInput Object
Define a custom file adapter that can be used by Simulink to load variables from an external file source into a Simulink.SimulationInput object.

对象和变量中的数据存储

数据对象
通过使用外部数据对象，在模块图外部指定参数、信号和状态的属性，包括参数值。
符号解析
您可以控制模型中的模块如何将符号解析为您在工作区中创建的变量和对象。
定义数据类
通过创建您自己的数据对象类，自定义您的模型与数据（信号、参数和状态）之间的交互方式。
Upgrade Level-1 Data Classes
Simulink no longer supports level-1 data classes. You must upgrade data classes that you created using the level-1 data class infrastructure, which was removed in a previous release.