避开这5个坑！Simulink信号输出到MAT文件的正确姿势

避开这5个坑！Simulink信号输出到MAT文件的正确姿势

在自动驾驶算法验证或机器人控制策略迭代的漫长征途中，仿真数据的可靠存储是确保每一次实验价值得以延续的基石。很多工程师习惯性地将Simulink的仿真结果一股脑儿地通过To File模块塞进MAT文件，直到某天需要回溯分析时，才惊觉数据格式混乱、采样点错位，甚至文件过大无法打开，宝贵的仿真时间就此付诸东流。To File模块看似简单，实则暗藏玄机，尤其是在处理高维传感器数据、长时间序列或并行仿真时，一个不经意的参数设置就可能导致后续数据处理流程的全面崩溃。本文将聚焦于实战中最高频的五个“深坑”，结合MATLAB 2023b引入的新特性，为你梳理出一套稳健、高效且面向未来的数据输出策略。

1. 采样率陷阱：当“仿真时间”不等于“数据时间”

第一个也是最隐蔽的坑，源于对信号采样与存储机制的误解。很多开发者认为，To File模块会忠实地记录下仿真每一步的信号值，但事实并非如此。模块的存储行为严重依赖于其采样时间参数，而这个参数默认是-1，即继承上游信号的采样时间。

1.1 问题场景：混频信号存储失真

想象一个典型的自动驾驶感知仿真场景：摄像头图像处理以30Hz运行，而雷达点云生成是10Hz，两者最终汇入一个融合算法。如果你用一个To File模块来记录融合后的总线信号，并且采样时间设置为-1（继承），会发生什么？

% 假设在模型初始化脚本中定义了信号
cam_fs = 30; % 30 Hz
radar_fs = 10; % 10 Hz
% 在Simulink模型中，对应信号源模块的采样时间设置为 1/cam_fs 和 1/radar_fs。

如果融合模块的输出采样时间被设定为与摄像头同步（即1/30秒），那么To File模块也会以30Hz的频率进行存储。这意味着雷达信号中那些发生在非30Hz整数倍时间点上的数据会被彻底忽略。你存储的并非完整的雷达信息，而是对其进行了二次采样的结果，这在进行后续的时序对齐分析时，会引入难以察觉的误差。

1.2 解决方案：显式指定存储采样率

正确的做法是，根据你后续分析所需的数据时间精度，显式地为To File模块设置一个合适的、统一的采样时间。

• 对于需要最高保真度的分析：将采样时间设置为模型的最小采样时间（通常是仿真步长）。这能确保记录下仿真求解器计算的每一个步长的数据，但会生成巨大的文件。
• 对于侧重系统级行为的分析：设置一个满足奈奎斯特采样定理的采样率，该采样率需高于你所关心的信号最高频率的两倍。例如，如果你只关心10Hz以下的动态，那么20Hz的存储采样率可能就足够了。

注意：在模块对话框中，Sample time参数填写的就是采样周期（秒），例如，对于100Hz的存储率，应填写0.01。

一个更清晰的对比可以总结如下：