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

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

```text
加载 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` | 在统计结果窗口复制选中内容 |

### 选区操作

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

- 按 `F` 或点击工具栏放大按钮，放大到选区；
- 按 `S` 查看选区统计；
- 右键选择“统计当前选区”；
- 右键选择“导出选区数据”，保存为 CSV 或 Excel；
- 右键选择“清除选区”，或直接按 `Esc`。

### 视图恢复

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

- 单击：返回上一个视图范围；
- 双击：恢复最初的完整显示范围。

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

### 分图与合并

- 工具栏布局按钮单击：在分图与原值合并之间切换；
- 分图状态下双击布局按钮：使用归一化方式合并曲线；
- 快捷键 `M`：在分图和合并显示之间切换。

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

---

## 5. 统计、对比与诊断

### 曲线统计

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

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

### A/B 差值分析

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

### 数据质量与异常检测

- “数据质量检查”用于发现时间倒退、重复时间、无效时间、NaN/Inf、长间隔和异常采样间隔；
- “异常点检测”根据用户设置的上下限、最大相邻变化量或最大变化率执行规则检测；
- 双击异常结果可跳转到对应时间，并在全部可见曲线上添加固定异常标记。

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

---

## 6. 公式与信号处理

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

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

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

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

---

## 7. 导出

软件支持：

- 导出当前工程中已选择的解析信号；
- 使用 CSV / Excel 信号模板筛选、排序和重命名导出列；
- 将当前时间选区导出为 CSV 或 Excel；
- 复制当前波形到剪贴板；
- 将当前波形保存为图片。

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

---

## 8. 数据与隐私

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

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

---

## 9. 使用与合作

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

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

---

## 10. 免责声明

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

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

---

## 11. 反馈与联系

欢迎反馈：

- Bug 与兼容性问题；
- 新数据格式适配需求；
- 功能与交互建议；
- 企业使用、项目合作、部署支持及其他技术合作。

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

**Author:** Yom Li
**Email:** yomli271828@outlook.com

