cas-bigdatalab time_gradual_change_check 时序平缓性检测Skill
功能概述
与 QC13（恒定值检测）互补的平缓性检测。两项检查：(1) 突变跳点——相邻时间点的变化幅度超过 jump_threshold；(2) 方向振荡——滑动窗口内数值升降反转次数超过 oscillation_limit。
处理逻辑
- 读取输入数据表，按时间字段排序
- 计算相邻点的一阶差分
- 突变跳点：标记 |Δ| > jump_threshold 的点及前一个点
- 方向振荡：滑动窗口内统计符号变化次数，超限则标记整个窗口
- 输出带质控标识的结果文件
支持的文件格式
- CSV (.csv) / TSV (.tsv) / Excel (.xls, .xlsx) / SPSS (.sav)
使用方法
python scripts/time_gradual_change_check.py \
--input_path <输入文件> \
--output_path <输出文件> \
--check_field temperature \
--time_field timestamp \
--time_format "%Y-%m-%d %H:%M:%S" \
--jump_threshold 10.0 \
--qc_mark QC0017 \
--mark_field_name QC0000
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--input_path |
是 | 输入文件路径 |
--output_path |
是 | 输出文件路径 |
--check_field |
是 | 检测字段 |
--time_field |
是 | 时间字段 |
--time_format |
是 | 时间格式 |
--jump_threshold |
否 | 突变阈值（不设则不检测跳点） |
--window_size |
否 | 振荡窗口（默认5） |
--oscillation_limit |
否 | 窗口最大反转次数（默认2） |
--qc_mark |
是 | 质控标识 |
--mark_field_name |
否 | 质控标识字段名 |
输出示例
[QC FAIL] 时序平缓性检测未通过 (2 项问题):
[突变跳点] 1 处相邻变化超过阈值 20.0
[方向振荡] 存在振荡异常（5 点窗口内反转超过 1 次），共标记 6 个数据点
[OK] 结果已写入 -> output.csv
注意事项
- 数据按时间字段排序后再检测
- jump_threshold 不设则不检测跳点（只检测振荡）
- 与 QC10_TimeConsistency（变化率）互补：QC17 侧重于变化幅度的平滑性而非速度