# 数据契约 — 辉腾梁/B区一期 (farm#16, 大唐) — OEM未知 1.5MW DFIG geared (数据derive, 无机台表)
# ⚠ TASKS旧note"金风"错: 发电机转速1855>>叶轮19.7(比94)=有齿轮箱 → 非金风直驱. 列schema同唐兴.
meta:
  farm: 辉腾梁风电场 (B区一期)
  farm_code: HTL
  oem: 未知 (1.5MW geared DFIG; 列naming同唐兴(叶片N变桨角度A/X-Y振动加速度); 内蒙辉腾梁; 待识别)
  model: 未知 (rated~1500; gen1855/rotor19.7 比~94)
  topology: dfig_geared
  rated_kw: 1500   # 有功 max各台1509-1577
  n_turbines_with_data: 33   # B区一期001-033
  province: 内蒙
  sampling: {sec_s: 10}
  windows: {sec: "2023-11-22 ~ 2024-02-21 (~3月冬窗)"}
  data_location: "F:\\datang\\辉腾梁风电场\\辉腾梁.tar.gz (33 CSV, GBK名surrogateescape, _11后缀)"
  met_mast: absent
  power_curve_table: absent
  event_table: absent_status_code   # 无状态码 → 物理派生态
  encoding: gbk
  provenance: "scripts/hl_survey.py, hl_goem2.py"

# ============ sec 层 (18列; 10秒; 33台) ============
turbine_sec:
  required: [有功功率, 环境风速]
  columns:
    时间: {canonical_id: timestamp, parse: datetime}
    有功功率: {canonical_id: WAPC_active_power, unit: kW, valid_range: [-100, 1700], note: "max~1545 rated1500"}
    无功功率: {canonical_id: WAPC_reactive_power}
    环境风速: {canonical_id: WMET_wind_speed_nacelle, unit: m/s, self_ref_risk: true}
    环境风向: {canonical_id: WMET_wind_direction_geo, unit: deg, valid_range: [0, 360], frame: geographic, note: "🔴地理0-360但无机舱位置列→偏航误差不可算(无heading)"}
    叶片1变桨角度A: {canonical_id: WROT_pitch_1, unit: deg, note: "🔴集距死(spread0.000° 第12OEM); +2/3#"}
    齿轮箱油温: {canonical_id: WTRM_gearbox_oil_temp, unit: degC, note: "唯一齿轮箱测点"}
    主轴前轴承温度: {canonical_id: WROT_mainshaft_front_bearing_temp, unit: degC, note: "冬窗低-5~17"}
    机舱温度: {canonical_id: WNAC_ambient_temp, unit: degC}
    X方向振动加速度: {canonical_id: WNAC_vibration_x, note: "🔴近死(nunique4-7极粗, [0,0.05])→振动不可判别"}
    Y方向振动加速度: {canonical_id: WNAC_vibration_y, note: "🔴近死(nunique2)"}
    叶轮转速: {canonical_id: WROT_speed, unit: rpm, valid_range: [0, 25]}
    发电机转速: {canonical_id: WGEN_speed, unit: rpm, valid_range: [-30, 2000], note: "geared max1855"}
    扭缆角度: {canonical_id: WYAW_cable_twist, note: "累积非heading; 不能作yaw"}
  no_status_code: "🔴 无状态码 → 物理派生(P>20=发电/ws<3低风待机/rotor<0.5停机/other); 限电同步性判别"

cleaning:
  physical:
    - "有功功率 clip[-100,1700]; 发电机转速≈-20哨兵→NaN"
  semantic:
    - "环境风速=机舱风 self_ref → 无mast → 绝对功率曲线 INSUFFICIENT"
    - "🔴 无机舱位置/heading → 偏航 INSUFFICIENT(环境风向地理但无nacelle); 扭缆角度=累积非heading"
    - "🔴 X/Y振动近死(nunique<10极粗) → 振动/叶片不平衡 INSUFFICIENT"
    - "集距死; 无状态码→物理派生; 限电同步性判别"

traps:
  - "★ TASKS旧note'金风'错(实geared非直驱); OEM未知1.5MW列schema同唐兴"
  - "🔴 偏航INSUFFICIENT(无机舱heading) + 振动INSUFFICIENT(近死nunique<10) 双缺"
  - "★ 集距死(第12OEM); 无状态码物理派生; 冬窗2023-11~2024-02非年度"
  - "🟡 tar.gz GBK名surrogateescape; 33台10秒~25M行 clean; 无mast→绝对INSUFFICIENT"