# 数据契约 — 唐龙三期/C系列 (farm#14, 大唐) — 上海电气 SEWIND W2000-116, 2MW DFIG geared
# ⚠ 唐龙多期多OEM: 一期=金风直驱A系列(farm#13) / 三期=上海电气W2000-116 C系列(本). 机台表坐实(已填非模板).
# 复用 repo sewind_w2000_110_80(长清) + sewind_w2000n_105_jishan_p1(吉山) 语义层 (W2000族, 116变体).
meta:
  farm: 唐龙风电场 (三期/C系列, 安徽张山)
  farm_code: TL3
  oem: 上海电气 SEWIND
  model: W2000-116 (2MW DFIG geared; 安徽; 90m轮毂; gen1840/rotor14.7 比~125)
  topology: dfig_geared
  rated_kw: 2000   # 有功 max~2103
  rotor_diameter_m: 116
  hub_height_m: 90
  n_turbines_with_data: 24   # C01-C24 (机台表编号50+, C系列)
  province: 安徽
  sampling: {sec_s: 10}
  windows: {sec: "2023 Aug-Oct (202308/09/10, 3文件/台)"}
  met_mast: point_table_only_suspect   # 🟡 收资测风塔点表坐标123/44(NE中国)≠安徽(疑模板默认/未更新); 且无mast数据文件 → 绝对功率曲线 INSUFFICIENT
  power_curve_table: present   # 🟢 收资曲线2密度(1.18场站/1.225标准) → 设计曲线参照
  event_table: status_code_present   # 风机标准状态(集团标准1-6) + 风机状态(0-10)
  encoding: gbk
  yaw_calib_subset: "🟡 偏航校准后的数据/(F009/16/21/22, 28列含对风角度=直接偏航, post-yaw-cal) + 调整后偏航误差数据校核.zip → 偏航校准验证子集(4台); C系列主用风向vane"
  reuse: "上海电气W2000族复用长清/吉山; 116变体; 状态码per场重解(本场标准状态1=发电异长清/吉山枚举)"
  provenance: "scripts/tl3_survey.py, tl3_peek_c.py, tl3_goem2.py"

# ============ sec 层 (39列富; 10秒; 24台 C系列) ============
turbine_sec:
  required: [有功功率, 风速, 风机标准状态]
  columns:
    时间: {canonical_id: timestamp, parse: datetime}
    设备名: {canonical_id: WTUR_id, note: "唐龙风场CNN号风机"}
    有功功率: {canonical_id: WAPC_active_power, unit: kW, valid_range: [-100, 2200], note: "max2103 rated2000"}
    风速: {canonical_id: WMET_wind_speed_nacelle, unit: m/s, self_ref_risk: true, note: "+30s/10min平均"}
    风向: {canonical_id: WYAW_error_vane, unit: deg, valid_range: [-180, 180], note: "🟢 vane对风误差; 发电态全台中位-1.8~+3.0近0 → 偏航per机偏置可做(第5场)"}
    机舱位置: {canonical_id: WYAW_nacelle_position, unit: deg, valid_range: [0, 360], note: "heading 0-360"}
    扭缆位置: {canonical_id: WYAW_cable_twist, note: "扭缆角度"}
    发电机转速: {canonical_id: WGEN_speed, unit: rpm, valid_range: [-30, 2000], note: "geared max1840; -27哨兵near0"}
    风轮转速: {canonical_id: WROT_speed, unit: rpm, valid_range: [0, 25]}
    桨距角1: {canonical_id: WROT_pitch_1, unit: deg, note: "🔴集距死(spread0.000° 第11OEM); +桨距角集/2/3"}
    机舱振动传感器X: {canonical_id: WNAC_vibration_x, valid_range: [-5, 5], note: "🔴clip(唐兴教训); 本样本~0.04正常; +Y/有效值"}
    机舱振动传感器Y: {canonical_id: WNAC_vibration_y, valid_range: [-5, 5]}
    齿轮箱低速轴承温度: {canonical_id: WTRM_gearbox_lss_bearing_temp, unit: degC}
    齿轮箱高速轴承温度: {canonical_id: WTRM_gearbox_hss_bearing_temp, unit: degC}
    齿轮箱油温: {canonical_id: WTRM_gearbox_oil_temp, unit: degC}
    发电机定子U温度: {canonical_id: WGEN_stator_temp_u, unit: degC, note: "+V/W温度"}
    发电机驱动端轴承温度: {canonical_id: WGEN_bearing_de_temp, unit: degC, note: "+自由端"}
    风机标准状态:
      canonical_id: WTUR_standard_state
      status_enum_ref: configs/fault_dicts/sewind_w2000_116_tanglong_p3_state_enum.csv
      semantic: "★主状态(cross-tab坐实): 1=发电78.8%(P232/rpm1048/pitch0)/2=低风待机顺桨18.5%(pitch89)/5=停机/6=过渡/4=停; 风机状态(0-10)另一列辅"
    发电量: {canonical_id: WTUR_energy_10min, note: "+日/月/年发电量(累积); 无内置可利用率→状态派生"}

cleaning:
  physical:
    - "有功功率 clip[-100,2200]; 发电机转速≈-27哨兵→NaN; 风轮clip[0,25]"
    - "🔴 X/Y振动 clip[-5,5] (唐兴corrupt教训); 振动统计用median"
    - "桨距/温度越界哨兵剔"
  semantic:
    - "风速=机舱风 self_ref → 无mast(点表坐标疑模板) → 绝对功率曲线 INSUFFICIENT(仅设计曲线)"
    - "🟢 风向=vane对风误差 → 偏航per机偏置可做"
    - "无内置可利用率 → 风机标准状态派生(1发电/2低风/4,5停)"
    - "集距死→叶片不平衡靠X/Y振动(clip后, 仅level非1P)"

traps:
  - "★ 唐龙多期多OEM(一期金风直驱/三期上海电气W2000); 机台表坐实勿混"
  - "🔴 X/Y振动必clip+median(唐兴教训)"
  - "★ 集距死(第11OEM); 无内置可利用率(异长清/吉山W2000有)→标准状态派生"
  - "🟡 mast点表坐标123/44≠安徽(疑模板默认)+无mast数据 → 绝对功率曲线INSUFFICIENT"
  - "🟡 F系列偏航校准子集(4台对风角度直接, post-cal)单列; C系列主用风向"