# 5 号机缸体振动标签（临时实验目录）

> 位置：项目根目录 `_tmp_cylinder_vibration/`。  
> 参考 `_tmp_temperature/` 的组织方式；**未改动 `models/`**。  
> 当前阶段只做到：算法、标签、统一字段、HTML、报告和说明文档，暂不合并进模型。

## 目标

把 5 号机缸体振动做成和温度/润滑油压力类似的“故障演化标签”：

- 15 分钟首周期波形特征；
- 动态局部基线（1~30 天）；
- 轻微 / 异常 / 严重异常三级；
- 相邻小时合并成小时标签；
- 同一时刻 6 缸并排查看，标签前后各补 6 小时；
- 标签带可读的 `阶段触发依据`；
- 输出统一字段表，后续可进入数据库/模型。

## 数据口径

- 机组：5 号机；
- 点位：`5号机组一缸缸体振动` ~ `5号机组六缸缸体振动`；
- 每个文件只用**首周期**；
- 只使用运行态：`rpm > 0`；
- 约 15 分钟一个文件；
- 温度只作为事后对照，不参与振动标签生成。

## 目录

| 文件 | 作用 |
|---|---|
| `config.py` | 机组、缸号、事件、阈值和路径 |
| `data.py` | 读取 `wave_file` / `wave_sample_one` 和温度参考 |
| `features.py` | 首周期时域、频域、包络、跨缸残差特征 |
| `local_labels.py` | 30 天动态局部基线、稳健阈值、15 分钟标签 |
| `adaptive.py` | 自适应扩段、方向、等级、显著性 |
| `hourly.py` | 15 分钟标签汇总为小时标签，相邻小时合并 |
| `review.py` | 排查指标和 `review_flags` |
| `unified_labels.py` | 映射为统一故障标签字段 |
| `context_html.py` | 生成 `waveforms.html` 交互排查页 |
| `make_report.py` | 生成统一表、截图和 Word 报告 |
| `run_full.py` | 全时段特征和标签 |
| `run_context.py` | 小时标签、排查指标、HTML |
| `out/` | 标签、统一表、报告、截图 |

## 快速运行

```bash
# 1. 全量特征 + 15 分钟标签 + 小时标签前处理
python3 _tmp_cylinder_vibration/run_full.py

# 2. 小时标签 + 排查指标 + HTML
python3 _tmp_cylinder_vibration/run_context.py

# 3. 统一字段表 + waveforms.html 截图 + Word 报告
python3 -m _tmp_cylinder_vibration.make_report
```

打开：

```bash
open _tmp_cylinder_vibration/out/html/waveforms.html
```

## 主要输出

| 文件 | 内容 |
|---|---|
| `out/vibration_features_full.csv` | 全时段首周期原始特征 |
| `out/vibration_features_full_local.csv` | 动态局部基线、z、分数、等级前数据 |
| `out/vibration_labels_full.csv` | 15 分钟点级标签 |
| `out/vibration_intervals_full.csv` | 自适应 15 分钟段 |
| `out/vibration_hourly_labels.csv` | 小时标签（最终展示口径） |
| `out/label_review.csv` | 排查指标和标记 |
| `out/cylinder_vibration_label_unified.csv` | 振动统一字段表 |
| `out/fault_label_unified_preview.csv` | 压力/温度/振动三类统一预览 |
| `out/html/waveforms.html` | 1×6 子图交互排查页 |
| `总结文档/缸体振动演化过程故障标签手册.docx` | Word 报告 |
| `out/report_assets/` | 报告截图（只截右侧图表） |

## 当前结果（2026-11）

- 小时标签：127 条；
- 轻微 68、异常 29、严重异常 30；
- 多特征确认 46；
- 3 次事件全部命中；
- 具体结果见 `out/分析报告.md` 和 `总结文档/缸体振动演化过程故障标签手册.docx`。

## 限制

- 振动是首周期快照，不是连续 15 分钟波形；
- 启动/停机瞬态仍可能形成标签，用 `review_flags` 标记而不是删除；
- 标签是规则扫描结果，不等同于物理故障结论；
- 本目录暂不写数据库、不接 API、不合并 `models/`。

## 后续

见 `合并方案.md`。下一阶段再把稳定模块迁入 `models/` 并接入统一故障标签表。