# 功图特征抽取（indicator_features）

从 `wave_file` + `wave_sample_one`（每文件一个**首周期**）抽取单周期功图特征，用于找气阀/活塞故障特征。**只读、抽样、不建模**。

级配（现场确认）：**一级=2/4/6 缸、二级=3/5 缸、三级=1 缸**；气体从 2/4/6 进，1 缸压缩后出，压力逐级升高。

## 用法

```bash
cd backend
python indicator_features/extract_from_db.py \
  --unit 7 --cylinders 二 四 六 --sides 盖侧 轴侧 \
  --start 2026-05-01 --end 2026-05-22 --per-day 3 \
  --output cache/indicator/7_1stage_valve_202605.csv
```

- `--per-day N`：每个测点每天最多取 N 个文件（均匀取样），控制拉取量。
- 输出每周期一行的 CSV：吸/排气平台、压比、相位占比、斜率、拐角、指示功等。

## 特征（当前）

- 平台：`p_suction`、`p_discharge`、`p_span`、`pressure_ratio`
- 相位：`suction_frac`、`discharge_frac`
- 线型：`compression_slope`、`expansion_slope`、`corner_sharpness`
- 功：`indicated_work`、`imep`（**注意**：需物理相位锚定，当前不可靠）

## 已知问题

1. **坏通道**：如 8 号机六缸盖侧、7 号机六缸盖侧/四缸盖侧在部分时段压力≈0，必须识别并排除。
2. **指示功/效率**：单周期起始角与活塞相位未锚定，`∮P dV` 目前不可用；需用键相/相位对齐后再算。
3. **数据覆盖**：功图只在设备运行日存在，很多故障发生在停机附近，故障前数据可能不足。

见 `观察记录.md`。