DOCUMENTATION
使用说明
此指南来自作者提供的产品文档,具体功能以安装版本为准。原文中的应力专项模块属于独立的应力程序,Signal Studio 独立版不包含该模块。
YL Signal Studio 是一款面向工程测试、CAN 总线数据解析、信号处理与波形分析的桌面数据分析软件。
软件可以将总线日志和测量文件转换为可分析的工程信号,并提供波形浏览、区间选择、双游标、统计、公式计算、信号重标定、数据质量检查、异常检测、A/B 对比及结果导出等能力。
重要工程结论应结合原始数据、正式试验方法和专业人员复核。本软件用于辅助分析,不替代安全、法规、认证或产品定型所要求的正式验证流程。
1. 主要功能
数据解析
CAN 数据
- 加载一个或多个 DBC ;
- 导入 ASC、BLF、PEAK TRC 和 SocketCAN candump 日志;
- 自动匹配数据中实际存在的 CAN Message;
- 按 Message 建立索引,并在用户选择信号时按需解码;
- 支持标准帧、扩展帧、多通道及 Rx/Tx 方向区分;
- 支持信号搜索、分类浏览和多文件工程。
SIF 文件
- 支持直接导入 SoMat SIF 测量文件;
- 无需加载 DBC;
- 自动读取文件中的通道、采样间隔及单位信息;
- 导入后的信号可直接参与波形、统计、公式、对比和导出。
波形分析
- 单信号或多信号绘图;
- 分图显示、原值合并及归一化合并;
- 滚轮缩放、空格拖动平移及中键平移;
- 时间区间选择、选区放大和选区数据导出;
- 浮动数据游标、A/B 双固定游标和多图共享游标;
- 曲线显示/隐藏、单曲线聚焦、颜色调整及图像复制/保存;
- 大数据量下按当前视图自动降低绘制点数,完整数据仍用于统计和计算。
统计与诊断
- Minimum、Maximum、Mean、Peak-to-Peak;
- RMS、Standard Deviation、Sample Count;
- 统计区间起止时间、持续时间及极值发生时间;
- 完整范围或当前选区统计;
- 时间倒退、重复时间、无效值、长间隔等数据质量检查;
- 基于上下限、相邻变化量和变化率的规则型异常检测;
- 异常结果跳转及固定标记。
信号处理与派生信号
- Moving Average;
- Low-pass / High-pass Filter;
- 常数加、减、乘、除;
- 多信号公式和公式组;
- 信号重标定、斜率/截距转换、显示名称及单位调整;
- 派生结果可继续参与绘图、统计、对比和导出,原始数据不会被改写。
对比与工程辅助
- 两条活动信号的 A/B 差值分析;
- 差值、绝对差、RMS 差值、平均/最大绝对差统计;
- 视图书签、事件书签、收藏及信号组;
- DBC 副本编辑和冲突检查;
- 手柄-油缸速度匹配、应力数据处理等专项模块。
2. 支持的数据格式
数据文件
| 格式 | 用途 | DBC | 说明 |
|---|---|---|---|
.asc |
CAN ASCII Log | 需要 | 支持快速索引、按需读取和 NumPy 批量解码 |
.blf |
Vector Binary Logging Format | 需要 | 按需解析 CAN Message |
.trc |
PEAK TRC 日志 | 需要 | 支持当前解析器能够识别的 PEAK TRC 版本 |
.log |
SocketCAN candump 日志 | 需要 | 解析 candump 文本记录 |
.csv |
通用测量数据 | 不需要 | 第一列作为时间,后续列作为数值信号 |
.sif |
SoMat SIF 工程信号 | 不需要 | 直接读取通道、采样间隔和单位 |
.mf4 / .mdf |
ASAM MDF 测量文件 | 不需要 | 直接浏览数值通道;运行环境需包含 asammdf |
CAN 数据库
| 格式 | 说明 |
|---|---|
.dbc |
定义 CAN ID、Message、Signal、Byte Order、Factor、Offset、Unit 和枚举等解码信息 |
ASC、BLF、TRC 和 candump LOG 属于原始 CAN 数据,应先加载匹配的 DBC,再导入数据文件。一个 CAN 数据文件可以联合使用多个 DBC。
SIF、CSV、MF4 和 MDF 是测量信号文件,不需要 DBC。
3. 快速开始
CAN 日志
- 点击顶部文件菜单加载一个或多个
.dbc; - 导入
.asc、.blf、.trc或.log,也可以直接将文件拖入窗口; - 在左侧信号树展开文件和 Message;
- 搜索名称、别名或单位,勾选需要查看的 Signal;
- 信号首次使用时按需解码,随后直接复用缓存;
- 在绘图区完成缩放、选区、游标、统计、公式或导出操作。
加载 DBC
↓
导入 CAN 日志
↓
展开或搜索信号
↓
勾选信号
↓
波形 / 统计 / 公式 / 对比 / 导出
测量文件
CSV、SIF、MF4 和 MDF 可以直接导入:
- 选择文件或拖入窗口;
- 等待左侧信号树显示通道;
- 勾选需要分析的通道;
- 使用与 CAN 信号相同的波形、统计、公式和导出功能。
CSV 文件应至少包含两列。第一列被视为时间列,其余可转换为数值的列被视为信号。
4. 波形操作
绘图区采用“左键选区、空格拖动平移”的交互方式。输入框正在编辑时,空格仍用于正常输入,不会触发平移。
鼠标操作
| 操作 | 结果 |
|---|---|
| 鼠标悬停在曲线上 | 显示浮动游标及当前时间、信号值 |
| 单击绘图区或曲线 | 在最近采样点放置固定游标 A,再次单击放置 B |
| 拖动固定游标 A / B | 移动对应固定游标,并同步所有可见分图 |
| 左键水平拖动 | 创建时间选区;分图模式下选区会同步显示在所有曲线 |
| 拖动选区边界 | 调整选区起止时间 |
| 单击已有选区 | 清除当前选区 |
按住 Space 后左键拖动 |
平移当前视图 |
| 中键拖动 | 平移当前视图,无需按住空格 |
| 鼠标滚轮 | 以指针位置为中心缩放视图 |
| 右键绘图区 | 打开选区、书签、图片、信号工具、快速处理和快速运算菜单 |
| 单击图例名称或眼睛 | 显示或隐藏对应曲线 |
| 双击图例或曲线 | 仅聚焦该信号;再次双击恢复此前可见状态 |
当 A、B 两个固定游标都已存在时,再次单击会移动距离点击位置更近的固定游标。按 Esc 可以同时清除当前选区和 A/B 固定游标。
键盘快捷键
以下快捷键在波形工作区生效:
| 快捷键 | 功能 |
|---|---|
Space + 左键拖动 |
平移波形 |
F |
放大到当前选区 |
S |
统计当前可见曲线;存在选区时统计选区,否则统计完整范围 |
M |
在分图和合并显示之间切换 |
Esc |
清除选区和固定游标 |
Ctrl/Cmd + C |
在统计结果窗口复制选中内容 |
选区操作
左键拖动只负责创建分析选区,不会立即改变缩放范围。创建选区后可以:
- 按
F或点击工具栏放大按钮,放大到选区; - 按
S查看选区统计; - 右键选择“统计当前选区”;
- 右键选择“导出选区数据”,保存为 CSV 或 Excel;
- 右键选择“清除选区”,或直接按
Esc。
视图恢复
绘图区的自动范围按钮保留视图历史:
- 单击:返回上一个视图范围;
- 双击:恢复最初的完整显示范围。
“显示”菜单中的视图命令还可以分别恢复全部范围、X 轴范围或 Y 轴范围。
分图与合并
- 工具栏布局按钮单击:在分图与原值合并之间切换;
- 分图状态下双击布局按钮:使用归一化方式合并曲线;
- 快捷键
M:在分图和合并显示之间切换。
归一化合并只改变显示尺度,不改写原始信号值。
5. 统计、对比与诊断
曲线统计
统计功能始终读取完整分辨率信号,而不是屏幕上为提高流畅度而抽样后的绘制点。
没有选区时统计完整信号;存在选区时统计当前时间范围。统计结果支持复制。
A/B 差值分析
活动曲线不少于两条时,可以从工具菜单打开 A/B 差值分析,选择两条信号并查看对齐后的差值统计。需要时可将差值或绝对差发布为派生信号。
数据质量与异常检测
- “数据质量检查”用于发现时间倒退、重复时间、无效时间、NaN/Inf、长间隔和异常采样间隔;
- “异常点检测”根据用户设置的上下限、最大相邻变化量或最大变化率执行规则检测;
- 双击异常结果可跳转到对应时间,并在全部可见曲线上添加固定异常标记。
检测结果是工程分析线索,不应脱离原始数据和工况直接作为最终结论。
6. 公式与信号处理
公式工作区可以创建多条输出信号,并通过 [信号名] 引用原始信号或其他派生信号。例如:
压力差 = [压力A] - [压力B];
液压功率 = [压力] * [流量] / 600;
平滑压力 = moving_avg([压力], 5);
公式编辑器会显示错误和警告。红色错误表示当前公式无法执行;黄色警告表示公式仍可执行,但存在重复、单位缺失或其他需要留意的问题。
右键曲线还可以快速执行 Moving Average、Low-pass、High-pass 和常数运算。处理结果作为显示处理链或派生信号保存,不覆盖原始采集数据。
7. 导出
软件支持:
- 导出当前工程中已选择的解析信号;
- 使用 CSV / Excel 信号模板筛选、排序和重命名导出列;
- 将当前时间选区导出为 CSV 或 Excel;
- 复制当前波形到剪贴板;
- 将当前波形保存为图片。
导出前请确认目标信号已加载。CAN 信号仍处于懒加载状态时,导出服务会按需请求相应 Message,而不会无条件解析整个文件。
8. 数据与隐私
当前默认构建在本地读取和处理用户导入的数据。正常的文件解析、波形分析、公式计算和统计不会主动上传工程测试数据。
请自行保存原始采集文件、DBC、公式方案和重要导出结果。清空工程只清理软件当前会话及相关状态,不会删除磁盘上的原始文件。
9. 使用与合作
个人学习、研究、技术验证以及其他非商业用途,可以安心使用。
当软件进入产品、项目交付、收费服务、企业正式生产环境或其他业务场景时,请在正式使用前与作者沟通,确认适合的使用与合作方式。详细内容请阅读使用与合作说明。
10. 免责声明
YL Signal Studio 按现状提供。作者会持续改进功能、解析兼容性和计算稳定性,但无法保证软件适配所有设备、文件变体和使用环境。
因原始数据、DBC、第三方格式、用户操作、软件异常或分析结果使用方式引起的风险,应由使用者结合实际场景进行评估。安全、法规、认证及产品定型相关决策必须经过正式方法验证和专业人员复核。
11. 反馈与联系
欢迎反馈:
- Bug 与兼容性问题;
- 新数据格式适配需求;
- 功能与交互建议;
- 企业使用、项目合作、部署支持及其他技术合作。
一般问题可以通过项目仓库反馈;涉及企业使用、项目合作或部署支持等事项,也可以通过 Email 联系作者。
Author: Yom Li Email: yomli271828@outlook.com