# 数据契约 — 上海电气 SEWIND W2500-146-100 (德惠新河一期, 山东临邑翟家镇 / 华电山东)
# schema_v2 SOP 标准件 (2026-07-18, oem-onboard subagent)。
#
# ★★ 验 name-based 装配后 parquet (outputs/dehui/cleaned/上气_10min.parquet; canonical=中文原表头)。
# ★★ 上气=一期20台 A1-A20 (★装配台号=SCADA'风机名称'列=A1-A20; 4、功率曲线folder命名B1-B20是电科院报告排序 无关)。
# ★★ 双OEM混场: 一期=上气W2500(本契约) / 二期=东气DEW-D2500-141直驱(dec_dew_d2500_141_dehui.yaml)。
# ★★ topology=geared(南京高速FD2777D 135.97:1水冷)+全功率变流器(日风RF069FP2500)+异步机(上电YFKKY500-4);
#     但 F258_600 导出模板**无齿箱温度列** → 齿箱热诊断做不了(数据缺, 非机型缺)。
#
# reuse: SEWIND家族(库内W2500-135马王/W2000长清族); OEM级语义复用(kW/状态8=发电/state11半载降额),
#        列定义本场F258_600导出重验(马王精简7列≠本场富集20列 → 不复用列定义, 复用陷阱/单位/状态语义)。
# 源: 48半月GBK CSV(24×2024+24×2025)/20台/2,105,280行/全2整年(2024-01~2025-12)。
schema_version: 2

meta:
  oem: 上海电气 SEWIND
  model: W2500-146-100
  topology: geared_fullconv     # 齿箱(FD2777D 135.97:1)+全功率变流器+异步机(YFKKY500-4 2650kW/1450rpm/风冷); 非DFIG
  rated_kw: 2500                # ✅实证: ws>12 plateau p50~2494/max2526(单文件); fleet max2645; 铭牌2500
  rotor_d_m: 146
  hub_height_m: 100
  source_farm: 德惠新河一期 (山东德州临邑县翟家镇, 华电山东新能源临邑分公司)
  n_machines: 20               # A1-A20 全有数据
  commission: "2020-11吊装/2020-12调试/2021-01试运行"
  encoding: GBK
  layout:
    format: "48半月CSV F258_600__YYYYMMDD_YYYYMMDD.csv (24×2024 + 24×2025); 全20台堆叠(风机名称列内); 20列"
    assemble: "name-based; key=(风机名称,时间); 风机名称 sorted A1..A20; F258=上电导出模板代号/600=600s聚合(非型号)"
  sampling:
    turbine_10min_s: 600
    window: "2024-01-01 ~ 2025-12-31 (2整年)"
  ground_truth:
    status_enum_ref: "configs/fault_dicts/sewind_w2500_135_status_enum_mawang.csv (复用SEWIND W2500自解15码: 8=发电/11=半载降额/1=有风停机; 本场额外码41待自解)"
  power_curve_ref: "4、功率曲线/上气/A?(folder命名B1-B20) per台12月CSV + 电科院W2500曲线; 无测风塔→绝对达成率INSUFFICIENT"
  self_ref: "★无测风塔(3、测风塔数据 无) → 机舱风绝对功率曲线/Cp/达成率 INSUFFICIENT(self_ref铁律); 相对fleet筛查可做"

turbine_10min:
  sampling_s: 600
  required: ["有功功率(kW)", "10min平均风速(m/s)"]
  machine_col: 风机名称
  time_col: 时间
  columns:
    时间: {role: timestamp}

    "有功功率(kW)":
      canonical_id: WTUR_W
      unit: kW
      valid_range: [-150, 2750]
      observed_range: [-62, 2645]
      block_if_raw_exceeds: 50000
      note: "rated2500(ws>12 plateau~2500); 负=空转寄生真物理(valid内保留禁clip); self_ref达成率INSUFFICIENT"
    "10min平均风速(m/s)":
      canonical_id: WMET_horWdSpd
      unit: m/s
      valid_range: [0, 40]
      observed_range: [0, 28.4]
      self_ref_risk: high
      note: "机舱风; 无测风塔→功率曲线自指"
    "桨距角(°)":
      canonical_id: WROT_PtchAngValBld
      unit: deg
      valid_range: [-5, 95]
      observed_range: [0, 93]
      note: "raw min-21/max123 garbage→界外NaN; p50=0(below-rated顺桨); 集距(单桨角列)"
    "发电机转速(rpm)":
      canonical_id: WGEN_Spd
      unit: rpm
      valid_range: [0, 1700]
      observed_range: [0, 1543]
      note: "p50~851; 额定~1450-1500(spec范围850-1624); 0=停机"
    "发电机定子U温度(℃)":
      canonical_id: WGEN_TmpStaU
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 114]
      note: "0=offline占位; 相间不平衡走U/W(无V列); F级155℃"
    "发电机定子W温度(℃)":
      canonical_id: WGEN_TmpStaW
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 114]
    "发电机前轴承温度(℃)":
      canonical_id: WGEN_TmpBrgDE
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 85]
      note: "raw min-196.6 garbage→界外NaN; 齿箱异步机发电机前轴承(非直驱主轴承)"
    "发电机后轴承温度(℃)":
      canonical_id: WGEN_TmpBrgNDE
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 89]
    "舱内温度(℃)":
      canonical_id: WNAC_IntTmp
      unit: degC
      valid_range: [-40, 80]
      observed_range: [0, 54]
    "环境温度(℃)":
      canonical_id: WMET_EnvTmp
      unit: degC
      valid_range: [-40, 55]
      observed_range: [-11, 46]
    "变频器柜体温度":
      canonical_id: WCNV_TmpCab
      unit: degC
      valid_range: [-40, 100]
      observed_range: [0, 58]
      note: "★稀疏 nn~0.12(条件/事件采样, per台8.5-26.7%) → 下游只在有值行; 无(℃)后缀"
    "电机温度1(℃)":
      canonical_id: WPCH_TmpMotBld1
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 82]
      note: "疑变桨电机温(电机温度1/2/3=3叶片); 0=offline"
    "电机温度2(℃)":
      canonical_id: WPCH_TmpMotBld2
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 104]
      note: "raw min-305 garbage→界外NaN"
    "电机温度3(℃)":
      canonical_id: WPCH_TmpMotBld3
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 74]
    "机舱位置(°)":
      canonical_id: WNAC_Dir
      unit: deg
      valid_range: [0, 360]
      observed_range: [0, 360]
      frame: nacelle_encoder
      note: "[0,360]wrapped方位; 偏航编码器相对零位(无测风塔标定) → 相对朝向/扇区可, 勿当GPS地理绝对"
    "扭缆位置(°)":
      canonical_id: WYAW_CableTwist
      unit: deg
      valid_range: [-1100, 1100]
      observed_range: [-693, 752]
      note: "unwrapped电缆扭角累计(±2圈); 解缆/偏航次数代理"
    "风向角(°)":
      canonical_id: WYAW_YawErr
      unit: deg
      valid_range: [-180, 180]
      observed_range: [-180, 180]
      frame: nacelle_relative
      note: "★相对对风误差(signed vane, nacelle-frame), 非地理! raw min-270界外→NaN; 静态偏航用此(native对风角前提门✓)"

    风机状态:
      role: state_enum
      canonical_id: WSLG_turbine_state
      unit: enum
      status_enum_ref: configs/fault_dicts/sewind_w2500_135_status_enum_mawang.csv
      semantic: "复用SEWIND W2500自解: 8=发电(dominant64%)/1=有风停机(真损候选)/3·6·10·2·5·9·4·7=停机(负寄生)/11=半载降额/12·43=发电变体/0·41=初始或本场额外(41待自解); 稀疏必ffill"