主要内容

本页翻译不是最新的。点击此处可查看最新英文版本。

MAT 文件记录

导出的数据保存在 MAT 文件中

模型配置窗格: 代码生成 / 接口

描述

MAT 文件记录参数指定代码生成器是否将导出的数据保存到 MAT 文件中。

  • 使用基于 ERT 的系统目标文件和服务代码接口配置的模型不支持此参数。

  • 如果选择此参数,您必须选择支持: 非有限数参数。如果系统目标文件参数设置为基于 ERT 的系统目标文件,您还必须选择支持: 浮点数参数。

  • 选择此参数将启用 MAT 文件变量名称修饰符参数。

  • 如果系统目标文件参数设置为基于 ERT 的系统目标文件,并且模型使用导出的函数调用,则清除此参数。

设置

On(基于 GRT 的系统目标文件的默认值) | Off(基于 ERT 的系统目标文件的默认值)
On

启用 MAT 文件记录。这是使用基于 GRT 的系统目标文件进行配置的模型的默认设置。

生成的代码以下列方式之一将导出的数据保存到 MAT 文件中:

有关详细信息,请参阅保存仿真数据Configure Signal Data for Logging

MAT 文件名为 model.mat,其中 model 是您的模型的名称。

Off

禁用 MAT 文件记录。这是使用基于 ERT 的系统目标文件配置的模型的默认设置。

清除此选项有以下好处:

  • 消除与支持文件系统相关联的开销,嵌入式应用程序通常不要求支持文件系统。

  • 消除初始化、更新和清理日志变量所需的额外代码和内存使用量。

  • 在某些情况下,可消除与根输出端口相关联的代码和存储。

  • 无需在 model_step 中的当前时间和停止时间之间进行比较,从而允许生成的程序无限期运行,而不管停止时间如何设置。

推荐的设置

应用场景设置
调试On
可追溯性无影响
效率Off
安全预警Off

编程用法

参数:MatFileLogging
类型:字符向量
值:'on' | 'off'
默认值:对于 GRT 目标为 'on',对于基于 ERT 的目标为 'off'

限制

  • MAT 文件记录不支持信号记录logsout 变量不会保存到 MAT 文件中。

  • 代码生成器不支持自定义数据类型(非 Simulink® 内置的数据类型)的 MAT 文件记录。

  • MAT 文件记录不支持作用域为文件的数据,例如,应用内置存储类 FileScope 的数据项。

  • 在引用模型中,仅支持以下数据记录功能:

    • To File 模块

    • 状态日志记录 - 软件将数据存储在顶层模型的 MAT 文件中。

  • 在 Embedded Coder® 产品的上下文中,MAT 文件记录不支持以下 IDE:Analog Devices® VisualDSP++®Texas Instruments® Code Composer Studio™、Wind River® DIAB/GCC。

  • MAT 文件记录不支持应用了会在生成代码中产生不可寻址数据的 ImportedExternPointer 存储类或存储类的 Outport 模块。例如,存储类 GetSet 会导致 Outport 作为函数调用出现在生成的代码中,而函数调用是不可寻址的。无论您是通过使用模型资源管理器等直接应用存储类,还是通过将 Outport 解析为使用存储类的 Simulink.Signal 对象来应用存储类,此限制都适用。作为解决办法,请将存储类应用于进入 Outport 模块的信号。

  • 如果在选择了允许任务在目标上并发执行参数的情况下为开发计算机编译独立的可执行文件,则生成的 main 函数不包括保存 MAT 文件的调用。当您在开发计算机上运行可执行文件时,该可执行文件不会生成 MAT 文件。

版本历史记录

在 R2006a 之前推出