Simulink.ModelDataLogs

（已删除）访问使用 ModelDataLogs 格式记录的数据的信号数据日志

不再支持 ModelDataLogs。请改用其他受支持的格式，例如 Dataset。有关详细信息，请参阅版本历史记录。

说明

Simulink.ModelDataLogs 对象包含从使用 ModelDataLogs 格式记录数据的模型中的仿真记录的所有数据。

创建对象

在 R2016a 之前，您可以将模型配置为使用 ModelDataLogs 格式记录数据。对信号记录格式参数设置为 ModelDataLogs 的模型进行仿真会创建一个 Simulink.ModelDataLogs 对象，其中包含所有记录的信号数据。您可以使用信号记录名称参数指定 ModelDataLogs 对象的名称。

属性

全部展开

记录的数据属性

Simulink.ModelDataLogs 对象包含从仿真中记录的信号数据的属性。包含所记录数据的属性的数量、类型和名称取决于模型的结构体和记录配置。

属性名称源	记录的数据源	值
模型名称	顶层模型或模型引用	`Simulink.ModelDataLogs`
子系统名称	Subsystem	`Simulink.SubsysDataLogs`
信号名称	信号	`Simulink.Timeseries`
复路或虚拟总线名称	复路或虚拟总线	`Simulink.TSArray`
总线对象	非虚拟总线	`Simulink.TSArray`

ModelDataLogs 对象中的 ModelDataLogs 和 SubsysDataLogs 对象的层次结构与模型的层次结构匹配。总线的 Simulink.TSArray 对象的层次结构与总线层次结构匹配。

模型属性

`Name` — 模型或 Model 模块名称
字符向量

模型或 Model 模块名称，以字符向量形式返回。对于顶层模型，Name 属性值是模型的名称。对于引用模型，Name 属性值是引用该模型的 Model 模块的名称。

对象函数

`convertToDataset`	(Removed) Convert data logged using `ModelDataLogs` format to `Dataset` format
`unpack`	(Removed) Extract signal data from `ModelDataLogs`, `SubsysDataLogs`, or `TSArray` object into workspace variables
`who`	(Removed) List names of objects inside `ModelDataLogs`, `SubsysDataLogs`, or `TSArray` object
`whos`	(Removed) List name and type of objects inside `ModelDataLogs`, `SubsysDataLogs`, or `TSArray` object

版本历史记录

在 R2006a 之前推出

全部展开

R2025a: 已删除

不再支持以 ModelDataLogs 格式存储的数据，包括存储在 Simulink.ModelDataLogs、Simulink.Timeseries、Simulink.TSArray 和 Simulink.SubsysDataLogs 对象中的数据。

R2024b: 将删除

对 ModelDataLogs 数据的支持受到限制。Simulink.ModelDataLogs 对象将在以后的版本中删除。

R2024b: 不再支持将以 `ModelDataLogs` 格式记录的数据转换为 `Dataset` 格式

convertToDataset 函数已删除，并且 Simulink.SimulationData.Dataset 对象无法再将 ModelDataLogs 格式转换为 Dataset 格式。要将以 ModelDataLogs 格式记录的数据转换为 Dataset 格式，请使用 R2024b 之前的 Simulink 版本。

R2022b: 不再支持加载以 `ModelDataLogs` 格式保存的数据

从 R2022b 开始，您无法再加载以 ModelDataLogs 格式存储的数据，包括在 Simulink.Timeseries、Simulink.TSArray 和 Simulink.SubsysDataLogs 对象中存储的数据。

对于在 R2016a 之前的版本中创建的且使用 ModelDataLogs 格式进行记录的模型仿真脚本，您可以将以 ModelDataLogs 格式存储的数据转换为 Dataset 格式。

将模型从使用 ModelDataLogs 格式转换为使用 Dataset 格式可能需要您修改现有模型，并在回调、函数、脚本或测试中进行编码。下表列出了转换为 Dataset 格式后可能要解决的问题。

转换为 `Dataset` 格式后可能出现的问题	解决方法
现有回调、函数、脚本或测试中使用 `ModelDataLogs` 编程接口访问数据的代码可能会导致错误。	查找使用 `ModelDataLogs` 格式访问方法的代码。更新该代码以使用 `Dataset` 格式访问方法。例如，假设现有代码包含以下行。 logsout.('Subsystem Name').X.data 将该代码替换为 `Dataset` 访问函数。 get(logsout,"x").Values.data
Mux 模块信号名称丢失。	`Dataset` 格式将 Mux 模块信号视为向量。要通过信号名称识别信号，请用 Bus Creator 模块替换 Mux 模块。
信号查看器不能用于信号记录。	软件不会将信号记录数据记录到信号查看器中。使用信号记录输出变量来查看记录的数据。
`unpack` 函数生成一个错误。	对于 `Simulink.ModelDataLogs` 和 `Simulink.SubsysDataLogs` 对象支持的 `unpack` 函数，`Simulink.SimulationData.Dataset` 对象并不支持。例如，假设 `mlog` 中的数据有三个字段：`x`、`y` 和 `z`。对于 `ModelDataLogs` 格式数据，`mlog.unpack` 函数在基础工作区创建三个变量。对于 `Dataset` 格式的数据，`get` 函数按名称访问数据。 x = get(logsout,"x").Values
`ModelDataLogs` 和 `Dataset` 格式对未命名的信号具有不同的命名规则。	如有必要，添加信号名称。在 `ModelDataLogs` 格式中，对于来自模块的未命名信号，软件以 `SL_BlockName+<portIndex>` 形式指定名称，例如 `SL_Gain1`。在 `Dataset` 格式中，元素不需要名称，因此软件将信号名称留空。对于 `ModelDataLogs` 和 `Dataset` 这两种格式，软件会为来自 Bus Selector 模块的未命名信号指定相同的名称。
未记录引用模型中的测试点。	考虑为引用模型中的测试点启用信号记录。
脚本使用 `who` 或 `whos` 函数。	考虑改用 `find`。

R2021a: 不支持加载以 `ModelDataLogs` 格式保存的数据

当您加载使用 ModelDataLogs 格式作为仿真输入的数据时，软件会发出警告，指出在以后的版本中将不再支持以 ModelDataLogs 格式加载数据。

R2020b: 不支持加载以 `ModelDataLogs` 格式保存的数据

在以后的版本中，将删除加载使用 ModelDataLogs 格式作为仿真输入的数据的功能。

R2016a: 不再支持使用 `ModelDataLogs` 格式记录数据

从 R2016a 开始，您无法再使用 ModelDataLogs 格式记录数据，信号记录始终使用数据集格式。当您打开在以前版本中使用 ModelDataLogs 格式记录数据的模型时，模型配置参数将更新为使用数据集格式记录数据。

您仍可以使用和访问在以前的版本中使用 ModelDataLogs 格式记录的数据，包括 Simulink.SubsysDataLogs、Simulink.TSArray 和 Simulink.Timeseries 对象中的数据。您还可以将以 ModelDataLogs 格式保存的数据转换为数据集格式，这可以简化数据处理。

另请参阅

对象

Simulink.SimulationOutput | Simulink.SimulationData.Dataset