# 数据契约 — 东方电气 DEC DF110-2500 齿箱机型 (龙口一期-东气, 山东龙口 / 华电)
# schema_v2 SOP 标准件 (2026-07-18, 新场 onboard)。
#
# ★★ 验 name-based 归一化后 parquet (scripts/longkou_dongqi_df110_assemble.py 输出 canonical 列名)。
# ★★ 仅 **DF110-2500 (6台: 6/7/8/12/13/14)**; DF93-1500(23台) 直驱另契约 dec_df93_1500_longkou_dongqi.yaml。
# ★★ **DF110 = 齿箱机型 (非直驱!)**: 齿轮箱油温+发电机轴承温 live(台7 p50=54℃) — 推翻机型doc'直驱'
#    (doc'直驱'只适用DF93); 东气 = 混拓扑。
#
# reuse: 东方电气 DEC 族; DF110变体语义本场重验。
schema_version: 2

meta:
  oem: 东方电气 DEC (东电新能源)
  model: DF110-2500 齿箱机型
  topology: geared              # ★台7实证: 齿轮箱油温度live(p50=54℃/nuniq1195)+发电机轴承温live → 齿箱(非直驱); 推翻机型doc'直驱'(只适用DF93)
  rated_kw: 2500               # ✅实证: 归一化功率曲线 ws[11,13)中位=2555kW; p99~2564 max2629
  rotor_d_m: 110
  hub_height_m: 80
  source_farm: 龙口一期-东气 (山东龙口, 华电)
  n_machines: 6                # 6/7/8/12/13/14
  sub_model_note: "东气混子型混拓扑: DF93-1500直驱(23台) + DF110-2500齿箱(6台,本契约); 分母必分子型"
  layout:
    format: "xlsx per机号目录 per2月段; **归一化经 assembler**"
    assemble: "scripts/longkou_dongqi_df110_assemble.py (223列4台/132列子集2台 同套命名; 跳.1/.2重复列; 机号=DQ<N>)"
    schema_variants: "223列(台7,8,12,13) + 132列子集(台6,14, 全在223); .1/.2后缀=pandas自动重命名重复列(100%同首列)取首"
  sampling:
    turbine_10min_s: 600
    window: "2025全年"

turbine_10min:
  sampling_s: 600
  required: [有功功率, 风速]
  machine_col: _tid
  time_col: 时间
  columns:
    时间: {role: timestamp}

    有功功率:
      canonical_id: WTUR_W
      unit: kW
      valid_range: [-150, 2700]
      observed_range: [-12, 2629]        # ✅ p99~2564(rated2500 plateau ws11-13=2555); 负=空转寄生真物理禁clip
      self_ref_note: "别名'功率'; 本场无测风塔 → 绝对达成率INSUFFICIENT(风速self_ref)"
    风速:
      canonical_id: WMET_horWdSpd
      unit: m/s
      valid_range: [0, 40]
      observed_range: [0, 22.9]
      self_ref_risk: high
      trap: "别名'风速'/'瞬时测量风速'"

    齿轮箱油温:
      canonical_id: WTRM_TmpGbxOil
      unit: degC
      valid_range: [-40, 130]
      observed_range: [0, 75]
      semantic: "★DF110齿箱机型标志(区别DF93直驱无齿箱); temp-NBM可配冷浸参照(油温=参照本身则配环温/邻机); 0值疑停机态待清洗"
    发电机轴承温:
      canonical_id: WGEN_TmpBrg
      unit: degC
      valid_range: [-40, 130]
      observed_range: [0, 75]
      semantic: "齿箱DFIG发电机轴承温(区别DF93直驱主轴承D/N)"

    定子U电流:
      canonical_id: WGEN_IStaU
      unit: A
      valid_range: [0, 3200]
      observed_range: [0, 2596]
      semantic: "★DF110报定子**电流**非温度(区别DF93定子温度U/V/W) → 相间不平衡走电流轴; 无定子温则热诊靠齿箱/轴承温"

    机舱位置方位:
      canonical_id: WNAC_Dir
      unit: deg
      valid_range: [0, 360]              # ★方位角非扭角!
      observed_range: [0, 359.9]
      trap: "★**DF110机舱位置=真方位角[0,360)wrapped, 非扭角**(区别DF93 unwrap扭角[-358,616]) → 可作地理朝向/扇区(过pseudo-geo三件套); 无扭角轴(cable_twist DF110不可做)"

    机舱内温: {canonical_id: WNAC_IntTmp, unit: degC, valid_range: [-40, 80], observed_range: [0, 47]}
    舱外温:
      canonical_id: WNAC_ExtTmp
      unit: degC
      valid_range: [-50, 60]
      observed_range: [-8, 41]
      trap: "🟡 cross-turbine同窗核前provisional(同DF93 caveat); 别名'机舱外温度'(.1重复列跳)"
    偏航误差: {canonical_id: WYAW_YawErr, unit: deg, valid_range: [-185, 185], observed_range: [-180, 180]}
    转速:
      canonical_id: WROT_Spd
      unit: rpm
      valid_range: [-2, 22]
      observed_range: [-1.3, 15.1]
      semantic: "★~7.87rpm=转子/低速轴转速(齿箱机型但此列=低速轴非发电机高速轴); 别名'转速'/'低速轴编码器转速'"

cleaning:
  physical:
    - "有功功率负值=空转寄生真物理禁clip"
    - "valid_range界外→NaN非clamp"
    - "齿轮箱油温/发电机轴承温 0值=停机态(非哨兵), 清洗保留(发电态P>50过滤后自然剔)"
  semantic:
    - "机舱位置=方位角[0,360)(区别DF93扭角) → 可作扇区/地理(过pseudo-geo三件套)"
    - "定子电流非温度 → 相间热诊靠齿箱/轴承温"
    - "风速self_ref+无测风塔 → 绝对达成率INSUFFICIENT"
  derive:
    - "10min已是时均层(东气原生)"

traps:
  - "★**DF110=齿箱非直驱**(齿轮箱油温/发电机轴承温live, 台7实证 → 推翻机型doc'直驱'; doc'直驱'只适用DF93)"
  - "★**机舱位置=方位角非扭角**(区别DF93 unwrap扭角) → DF110可做扇区/地理, cable_twist不可做"
  - "★**定子电流非温度**(区别DF93定子温度) → 相间不平衡走电流轴"
  - "★**分子型**: DF110(6台,本契约rated2500) vs DF93(23台,rated1500,直驱另契约); 混曲线=大叶轮假超发"
  - "223列(4台)/132子集(2台); .1/.2=pandas重复列取首"