DOCUMENTATION

使用说明

此指南来自作者提供的产品文档,具体功能以安装版本为准。原文中的应力专项模块属于独立的应力程序,Signal Studio 独立版不包含该模块。

下载 README(Markdown)

YL Signal Studio 是一款面向工程测试、CAN 总线数据解析、信号处理与波形分析的桌面数据分析软件。

软件可以将总线日志和测量文件转换为可分析的工程信号,并提供波形浏览、区间选择、双游标、统计、公式计算、信号重标定、数据质量检查、异常检测、A/B 对比及结果导出等能力。

重要工程结论应结合原始数据、正式试验方法和专业人员复核。本软件用于辅助分析,不替代安全、法规、认证或产品定型所要求的正式验证流程。


1. 主要功能

数据解析

CAN 数据

SIF 文件

波形分析

统计与诊断

信号处理与派生信号

对比与工程辅助


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 日志

  1. 点击顶部文件菜单加载一个或多个 .dbc;
  2. 导入 .asc、.blf、.trc 或 .log,也可以直接将文件拖入窗口;
  3. 在左侧信号树展开文件和 Message;
  4. 搜索名称、别名或单位,勾选需要查看的 Signal;
  5. 信号首次使用时按需解码,随后直接复用缓存;
  6. 在绘图区完成缩放、选区、游标、统计、公式或导出操作。
加载 DBC
   ↓
导入 CAN 日志
   ↓
展开或搜索信号
   ↓
勾选信号
   ↓
波形 / 统计 / 公式 / 对比 / 导出

测量文件

CSV、SIF、MF4 和 MDF 可以直接导入:

  1. 选择文件或拖入窗口;
  2. 等待左侧信号树显示通道;
  3. 勾选需要分析的通道;
  4. 使用与 CAN 信号相同的波形、统计、公式和导出功能。

CSV 文件应至少包含两列。第一列被视为时间列,其余可转换为数值的列被视为信号。


4. 波形操作

绘图区采用“左键选区、空格拖动平移”的交互方式。输入框正在编辑时,空格仍用于正常输入,不会触发平移。

鼠标操作

操作 结果
鼠标悬停在曲线上 显示浮动游标及当前时间、信号值
单击绘图区或曲线 在最近采样点放置固定游标 A,再次单击放置 B
拖动固定游标 A / B 移动对应固定游标,并同步所有可见分图
左键水平拖动 创建时间选区;分图模式下选区会同步显示在所有曲线
拖动选区边界 调整选区起止时间
单击已有选区 清除当前选区
按住 Space 后左键拖动 平移当前视图
中键拖动 平移当前视图,无需按住空格
鼠标滚轮 以指针位置为中心缩放视图
右键绘图区 打开选区、书签、图片、信号工具、快速处理和快速运算菜单
单击图例名称或眼睛 显示或隐藏对应曲线
双击图例或曲线 仅聚焦该信号;再次双击恢复此前可见状态

当 A、B 两个固定游标都已存在时,再次单击会移动距离点击位置更近的固定游标。按 Esc 可以同时清除当前选区和 A/B 固定游标。

键盘快捷键

以下快捷键在波形工作区生效:

快捷键 功能
Space + 左键拖动 平移波形
F 放大到当前选区
S 统计当前可见曲线;存在选区时统计选区,否则统计完整范围
M 在分图和合并显示之间切换
Esc 清除选区和固定游标
Ctrl/Cmd + C 在统计结果窗口复制选中内容

选区操作

左键拖动只负责创建分析选区,不会立即改变缩放范围。创建选区后可以:

视图恢复

绘图区的自动范围按钮保留视图历史:

“显示”菜单中的视图命令还可以分别恢复全部范围、X 轴范围或 Y 轴范围。

分图与合并

归一化合并只改变显示尺度,不改写原始信号值。


5. 统计、对比与诊断

曲线统计

统计功能始终读取完整分辨率信号,而不是屏幕上为提高流畅度而抽样后的绘制点。

没有选区时统计完整信号;存在选区时统计当前时间范围。统计结果支持复制。

A/B 差值分析

活动曲线不少于两条时,可以从工具菜单打开 A/B 差值分析,选择两条信号并查看对齐后的差值统计。需要时可将差值或绝对差发布为派生信号。

数据质量与异常检测

检测结果是工程分析线索,不应脱离原始数据和工况直接作为最终结论。


6. 公式与信号处理

公式工作区可以创建多条输出信号,并通过 [信号名] 引用原始信号或其他派生信号。例如:

压力差 = [压力A] - [压力B];
液压功率 = [压力] * [流量] / 600;
平滑压力 = moving_avg([压力], 5);

公式编辑器会显示错误和警告。红色错误表示当前公式无法执行;黄色警告表示公式仍可执行,但存在重复、单位缺失或其他需要留意的问题。

右键曲线还可以快速执行 Moving Average、Low-pass、High-pass 和常数运算。处理结果作为显示处理链或派生信号保存,不覆盖原始采集数据。


7. 导出

软件支持:

导出前请确认目标信号已加载。CAN 信号仍处于懒加载状态时,导出服务会按需请求相应 Message,而不会无条件解析整个文件。


8. 数据与隐私

当前默认构建在本地读取和处理用户导入的数据。正常的文件解析、波形分析、公式计算和统计不会主动上传工程测试数据。

请自行保存原始采集文件、DBC、公式方案和重要导出结果。清空工程只清理软件当前会话及相关状态,不会删除磁盘上的原始文件。


9. 使用与合作

个人学习、研究、技术验证以及其他非商业用途,可以安心使用。

当软件进入产品、项目交付、收费服务、企业正式生产环境或其他业务场景时,请在正式使用前与作者沟通,确认适合的使用与合作方式。详细内容请阅读使用与合作说明。


10. 免责声明

YL Signal Studio 按现状提供。作者会持续改进功能、解析兼容性和计算稳定性,但无法保证软件适配所有设备、文件变体和使用环境。

因原始数据、DBC、第三方格式、用户操作、软件异常或分析结果使用方式引起的风险,应由使用者结合实际场景进行评估。安全、法规、认证及产品定型相关决策必须经过正式方法验证和专业人员复核。


11. 反馈与联系

欢迎反馈:

一般问题可以通过项目仓库反馈;涉及企业使用、项目合作或部署支持等事项,也可以通过 Email 联系作者。

Author: Yom Li Email: yomli271828@outlook.com