用途:将记录数据导入 Simulink Simulation Data Inspector(SDI)并打开窗口查看,覆盖 MAT、CSV、Excel 文件、工作区变量以及 sim(model) 的日志信号。
主要能力:Simulink.sdi.createRun 有四种源:空运行、'file'、'vars'、'namevalue'。'file' 一次性处理 .mat、.csv、.xlsx;多工作表 Excel 返回 1×N int32 向量,需用 sheetnames() 就地重命名,不要删除重导。'vars' 用于变量名或 .Name 已正确的情况,'namevalue' 用于裸数组等无 .Name 元数据的变量;注意 timeseries 自带的 .Name 会覆盖传入名称。
必要用法:sim 后如果日志已开,SDI 会自动产生一个 run,此时直接 Simulink.sdi.view 即可,不要再调 createRun,以免重复。CSV/Excel 的时间列表头需为 time,否则抛 SDI:sdi:ImportError,可回退到 readmatrix + array2timetable + 'vars',不要改写源文件。每次导入后用 getAllRunIDs、getRun 检查 SignalCount,为 0 说明静默失败。Simulink.sdi.clear 会删除全部 run,执行前须征得用户同意。
适用场景:查看 logged 数据、基准比对前的数据准备等。限制:不负责 compareRuns、流式导入(createRunOrAddToStreamedRun)、MDF/ULG/ROS bag/CAN log/HDF5,也不用于编写测试。非 ImportError 的失败应完整上报错误标识与信息,先询问再换路径。部分函数在 R2011b 起可用,getAllRunIDs 自 R2017a。