MATLAB 测试无法执行 - 系统环境缺失

[Rgeph]

MATLAB 测试无法执行 - 系统环境缺失

Labels: environment, MATLAB, testing

简要说明

MATLAB 测试套件结构完整，包含 21 个全面的 ADC 特性测试，但当前系统环境中未安装 MATLAB，导致无法执行这些测试。

当前状态

✅ 测试代码 - 完整可用

• 21 个测试脚本（3个基础 + 13个AOUT + 5个DOUT）
• 完善的配置框架（common_test_aout.m, common_test_dout.m）
• 清晰的测试组织结构

✅ 测试数据 - 参考数据集可用

• reference_dataset/sinewave_noise_200uV.csv - AOUT测试数据
• reference_dataset/dout_SAR_12b_weight_2.csv - DOUT测试数据

❌ MATLAB 环境 - 系统中不存在

• 系统 PATH 中找不到 MATLAB 可执行文件
• 标准安装目录（Program Files, Program Files (x86)）中未找到

测试清单

基础功能测试 (3个)

• test_alias.m - 频率别名和折叠
• run_basic.m - 基础正弦波分析
• run_sinfit.m - 正弦波拟合

模拟输出 (AOUT) 测试 (13个)

频谱与相位分析

• run_tomdec.m - Tomlinson-Harashima预编码
• run_plotspec.m - 频谱分析（ENOB、SNDR、SFDR等）
• run_plotphase_fft.m - FFT相位分析
• run_plotphase_lms.m - LMS相位分析

误差分析

• run_errsin_code.m - 码值误差
• run_errsin_phase.m - 相位误差
• run_errpdf.m - 误差PDF
• run_errac.m - 误差自相关
• run_errspec.m - 误差频谱
• run_errevspec.m - 误差包络频谱

非线性与特性

• run_inlsine.m - 积分非线性(INL)测试
• run_fitstaticnl.m - 静态非线性拟合
• run_toolset_aout.m - 完整工具集
• run_jitter_load.m - 时钟抖动

数字输出 (DOUT) 测试 (5个)

核心功能

• run_bitact.m - 位活动分析
• run_wscaling.m - 权重缩放
• run_wcalsin.m - 权重校准

特性检查

• run_bitsweep.m - 位扫描
• run_ovfchk.m - 溢出检查

测试覆盖范围

当这些测试可以运行时，将验证以下 ADC 特性：

特性	覆盖	测试
频率分析	AOUT	plotspec, plotphase_*
非线性度	AOUT	inlsine, fitstaticnl
误差特征	AOUT	errsin_*, errac, errspec
相位精度	AOUT	plotphase_fft, plotphase_lms
位活动	DOUT	bitact
权重校准	DOUT	wscaling, wcalsin
溢出检测	DOUT	ovfchk, bitsweep
时钟抖动	AOUT	jitter_load

环境要求

已满足 ✓

• 完整的测试代码和脚本
• 参考数据集（2个 CSV 文件）
• 测试配置框架

未满足 ✗

• MATLAB R2020a 或更新版本
• 信号处理工具箱 (Signal Processing Toolbox)
• 显示环境（用于图形输出）

建议的解决方案

短期

1. 在装有 MATLAB 的机器上手动执行测试

   cd matlab/tests
   run_all

2. 在 CI/CD 管道中配置 MATLAB 容器或 VM（如果有许可证）

3. 记录当前环境限制，文档中说明 MATLAB 测试需要单独环境

长期

1. 考虑使用 MATLAB 编译运行时 (MCR) 或 MATLAB 容器镜像
2. 探索 Octave 兼容性（如果可行）
3. 制定 MATLAB 和 Python 测试的互补验证策略
   • Python 完成 CPU 可用的测试
   • MATLAB 在专用环境中进行额外验证

输出位置

当测试运行时，将生成以下输出：

• 图形：matlab/tests/test_plots/ - PNG 图像
• 数据：matlab/tests/test_output/ - 测试结果数据
• 参考：reference_output/ - 黄金参考（已提交到仓库）

相关文件

• MATLAB_TESTS_OVERVIEW.md - 完整的测试文档
• matlab/tests/run_all.m - 主测试脚本
• matlab/tests/aout/ - AOUT 测试目录
• matlab/tests/dout/ - DOUT 测试目录
• reference_dataset/ - 参考数据集

---

优先级：中
类别：环境/基础设施、MATLAB 测试执行
状态：待部署 MATLAB 环境
自动生成于本地工作区，2026-06-03