Crystal Instruments CI Data File Reader 数据文件读取 API

免费 ATFX 数据读取 API，以两个 Windows DLL 让 C#、Python、Matlab、LabVIEW 程序直接读取 CI 采集数据

询价与选型 13923449916 索取规格书

协议与合规

ASAM ODS (ATFX)

Crystal Instruments Corporation 原厂产品，西科创业中国区供货与服务 · 原厂页面 ↗

产品概述

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²，工程单位则随文件保存。

技术参数

Crystal Instruments CI Data File Reader 数据文件读取 API — 技术参数
文件格式	ASAM ODS ATFX（XML）
组成	2 个 Windows DLL
支持编程语言	C#、Python、Matlab、LabVIEW
附加数据文件	.dat 原始/频谱数据、.ts 时间戳、.gps 位置数据
时间戳精度	纳秒级
默认频谱类型	EU_rms²
价格	免费

参数摘自原厂资料。同一型号常有选配与衍生版本，下单前请与我们确认最终配置。

核心特性

免费提供，由两个 Windows DLL 组成的 ATFX 读取接口
原生支持 C#、Python、Matlab 与 LabVIEW 集成开发
数据基于 ASAM ODS 规范的 ATFX XML 格式存储
提供 ODS 模型类直接调用与 Utility 便捷函数两层接口
附带 .ts 纳秒时间戳与 .gps 地理位置数据读取
支持工程单位换算（m/s² 转 g、EU_rms 转 EU_Peak 等）

典型应用

在自研软件中直接读取 CI 采集的振动与声学数据
将 ATFX 数据接入 Matlab/Python 进行二次分析与算法开发
在 LabVIEW 中构建自动化测试与数据后处理流程
批量提取通道参数、采样率与传感器灵敏度等元数据
结合时间戳与 GPS 位置进行远程或野外观测数据管理

常见问题

EDM 软件必须搭配 Crystal Instruments 的硬件才能使用吗？

EDM 前端的实时分析与控制功能运行在 Crystal Instruments 的 Spider 与 CoCo 硬件上，因此实时采集、振动控制和实时数字滤波需要配套硬件。但 EDM Post Analyzer 是独立的 Windows 应用，可直接在电脑上打开已录制的数据文件做事后分析；CI Data File Reader API 也是独立的免费库，能被任意第三方软件调用。只要你有 CI 仪器或拿到 ATFX 数据文件，就可在 PC 端完成大部分分析，不必被绑在同一台设备上。Post Analyzer 本身又分 PA Viewer、PA Basic 与 PA Premium 三个版本，分别对应查看与报告、FFT 频谱与三维显示、以及倍频程与阶次等高级功能，可按需选用。

我们能用自己公司的软件或 Python 读取测试数据吗？

可以。Crystal Instruments 软件原生以 ASAM ODS 标准的 ATFX 格式存储信号与记录，ATFX 是基于 XML 的开放格式，内含采样率、通道灵敏度、时间戳等元数据。CI 提供免费的 CI Data File Reader，包含两个 DLL，可被自研软件直接调用，支持 C#、Python、Matlab 和 LabView。通过其中的 Utility 类无需理解复杂的 ASAM ODS 模型即可列出信号、读取通道表并把数据转成工程单位（如加速度 m/s² 与 g），也能处理 EU 有效值至峰值等不同频谱类型，避免数据被私有格式锁定。