CI Data File Reader数据文件读取 API

CI Data File Reader 由两个 Windows 动态链接库（DLL）组成，为第三方应用程序提供访问 Crystal Instruments 测量数据的接口。这些数据以 ASAM Transport Format XML（ATFX）格式存储，该格式由自动化与测量系统标准化协会（ASAM）的 Open Data Services（ODS）规范定义，专用于存储振动数据及其各种形态。CI 软件原生即以 ATFX 格式保存信号与录制数据，用户可方便地查看并导出。

.atfx 文件基于 XML，记录信号数据以及录制属性，包括录制时间、长度、通道数、通道参数（如输入通道传感器与灵敏度）、地理坐标、采样率、高通滤波设置等。ATFX 文件引用一个 .dat 文件，存放原始时间数据以及由傅里叶变换、频率响应函数、互功率谱、倍频程谱等方法计算得到的处理谱数据；同时引用两类附加原始数据文件——.ts 时间戳文件（保存时刻，精度可达纳秒）与 .gps 文件（录制所在地理位置，如纬度、经度、海拔）。

API 提供一套精简的文件读取与浏览库来解码 ATFX、TS 与 GPS 文件，用户可将其集成进自研应用。目前支持基于 Windows 的程序，理想语言为 C#，同时也可在 Python、Matlab 与 LabVIEW 中调用。API 既提供对 ASAM ODS 模型类的直接调用（如用 NVHMeasurement、NVHEnvironment 读取精确到纳秒的 DateTime），也提供 Utility 工具类封装常用操作：GetListOfAllSignals 返回文件内全部信号清单，GetChannelTable 返回二维字符串通道表。读取时可将数据转换为工程单位，例如把加速度 m/s² 换算为 g、EU_rms 换算为 EU_Peak，由 GetFrame 函数传入转换参数完成。由于频谱类型等显示参数不写入 ATFX，读取时默认频谱类型为 EU_rms²，工程单位则随文件保存。