# 数据契约 — 东方电气 DEC DEW-D2500-141 直驱 (德惠新河二期, 山东德州陵城 / 华电山东)
# schema_v2 SOP 标准件 (2026-07-18, oem-onboard subagent)。
#
# ★★ 验 name-based 装配后 parquet (outputs/dehui/cleaned/东气_10min.parquet; canonical=中文原表头, _tid=B1-B20)。
# ★★ 东气=二期20台 B1-B20 (文件名=台号); 装配 time_col=时间。
# ★★ 双OEM混场: 二期=东气DEW-D2500-141直驱(本契约) / 一期=上气W2500齿箱(sewind_w2500_146_dehui.yaml)。
# ★★ topology=直驱PMSG (机型docx: 直驱/齿箱N/A/永磁PM02500; 数据铁证: 风轮转速≡发电机转速同轴max11rpm
#     + 全部齿轮箱通道nuniq=1全0死列) → 齿箱温度/振动模板列**死**(表头有列≠有活信号); 冷浸参照不配。
# ★★ 99列模板 28列死(见 goem_dongqi.json dead_cols_28): 全齿箱通道 + 发电机定子绕组温度/发电机轴承2/低速轴前后
#     /变流器模块温度/传动链振动 死 → 真发电机温走 发电机U/V/W相温度+发电机轴承温度。
#
# reuse: DEC家族(库内 longkou东气/金华山DF121/义都口G2000族); DEW-D2500-141=库内首见直驱型, 算子OEM级重验。
# 源: 20 per台UTF-8-sig CSV(B1-B20)/1,051,196行/全2025年(2025-01-01~2026-01-01)。
schema_version: 2

meta:
  oem: 东方电气 DEC (东方风电)
  model: DEW-D2500-141
  topology: direct_drive_pmsg   # ★直驱永磁; 数据实证 风轮转速≡发电机转速 + 全齿箱通道死
  rated_kw: 2500                # ✅铭牌2500(简介+机型docx); ws>12 plateau p50~2603(发电机PM02500 2650裕量); fleet max2662
  rotor_d_m: 141
  hub_height_m: "90/100/140三选(spec待机位/可研核; 平原海拔15-25m)"
  source_farm: 德惠新河二期 (山东德州陵城, 华电山东新能源陵城分公司)
  n_machines: 20               # B1-B20 全有数据 = 20×2.5MW = 50MW二期
  commission: "2022-03-10 全部并网"
  generator: "东方电机 PM02500 永磁直驱 2650kW/690V; 绝缘F"
  encoding: UTF-8-sig
  layout:
    format: "20 per台CSV B1.csv..B20.csv (各~31MB, 99列富集); 文件名=台号"
    assemble: "name-based; _tid=B<N>(文件名); time_col=时间"
  sampling:
    turbine_10min_s: 600
    window: "2025-01-01 ~ 2026-01-01 (2025整年)"
  ground_truth:
    status_enum_ref: "configs/fault_dicts/dongfang_dec_3p2mw_status_enum_0_43.csv (复用DEC自解: 15=正常运行/12=调度限电/13=部件降额/14=告警发电/0=启动; ⚠源自DEC 3.2MW型, DEC通用约定, 本型码22/23/24/25待验; 另图纸dongfang_am44a_codes.csv=告警码表)"
  self_ref: "★无测风塔(3、测风塔数据 无) → 机舱风绝对功率曲线/Cp/达成率 INSUFFICIENT(self_ref); 相对fleet筛查+per台温度NBM(全年窗+发展性)可做"
  curtailment_note: "★限功率flag非纯限电信号(per台5.7%~68%悬殊, fleet60%远超状态12调度限电12%; B1/B15异); 限电识别用 风机主状态=12 + 有功上限/有功调度下限 setpoint"
  cold_soak_config: "N/A — 直驱无齿箱油温; 发电机轴承=直驱主轴承(热汇发电机冷却非油浴) → 不配冷浸参照(弱参照产假sensor_suspect)"
  direction_frame: "★绝对风向=nacelle派生(机舱位置+相对vane, 三件套median|r|~0.35-0.47°), 非独立地理; 无测风塔 → self_ref, 禁扇区/风玫瑰/绝对偏航锚; 静态偏航用相对偏航误差列"

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

    瞬时功率:
      canonical_id: WTUR_W
      unit: kW
      valid_range: [-150, 2750]
      observed_range: [-30, 2620]
      block_if_raw_exceeds: 50000
      note: "rated2500(ws>12 plateau~2603); 负=空转寄生真物理; self_ref达成率INSUFFICIENT"
    风速10min:
      canonical_id: WMET_horWdSpd
      unit: m/s
      valid_range: [0, 40]
      observed_range: [0, 15]
      self_ref_risk: high
      note: "机舱风10min; 另有风速1s/风速30s/原始风速1"
    风速1s: {canonical_id: WMET_horWdSpd_1s, unit: m/s, valid_range: [0, 45], observed_range: [0, 15]}
    风速30s: {canonical_id: WMET_horWdSpd_30s, unit: m/s, valid_range: [0, 45], observed_range: [0, 15]}
    原始风速1: {canonical_id: WMET_horWdSpd_raw, unit: m/s, valid_range: [0, 45], observed_range: [0, 16]}
    湍流强度: {canonical_id: WMET_TI, unit: ratio, valid_range: [0, 5], observed_range: [0, 1], note: "max24.5 spike→界外NaN"}
    空气密度: {canonical_id: WMET_AirDen, unit: kg/m3, valid_range: [0, 1.5], observed_range: [0, 1.3], note: "0=停机占位"}
    环境温度: {canonical_id: WMET_EnvTmp, unit: degC, valid_range: [-40, 55], observed_range: [-10, 40]}

    风轮转速:
      canonical_id: WROT_Spd
      unit: rpm
      valid_range: [-2, 15]
      observed_range: [0, 11]
      note: "★≡发电机转速(直驱同轴); max11rpm"
    发电机转速:
      canonical_id: WGEN_Spd
      unit: rpm
      valid_range: [-2, 15]
      observed_range: [0, 11]
      note: "★直驱=风轮转速(非齿箱升速)"
    发电机扭矩:
      canonical_id: WGEN_Trq
      unit: Nm
      valid_range: [-100000, 3000000]
      observed_range: [0, 2400000]
      note: "N·m量级(直驱大扭矩); p50~434k"

    发电机U相温度:
      canonical_id: WGEN_TmpStaU
      unit: degC
      valid_range: [-40, 200]
      observed_range: [0, 125]
      note: "★真定子绕组温(发电机定子绕组温度列死); max306 spike→界外NaN; 相间不平衡走U/V/W"
    发电机V相温度: {canonical_id: WGEN_TmpStaV, unit: degC, valid_range: [-40, 200], observed_range: [0, 130], note: "max388 spike→NaN"}
    发电机W相温度: {canonical_id: WGEN_TmpStaW, unit: degC, valid_range: [-40, 200], observed_range: [0, 120]}
    发电机轴承温度:
      canonical_id: WGEN_TmpBrg
      unit: degC
      valid_range: [-40, 150]
      observed_range: [0, 70]
      note: "★直驱主轴承(热汇发电机冷却; 发电机轴承2温度列死); 冷浸参照不配"
    轮毂温度: {canonical_id: WROT_TmpHub, unit: degC, valid_range: [-45, 90], observed_range: [0, 50], sentinel: [-40], note: "-40=温度floor哨兵→NaN"}
    机舱内温度: {canonical_id: WNAC_IntTmp, unit: degC, valid_range: [-40, 90], observed_range: [-5, 50], note: "max116 spike→NaN"}
    机舱配电柜温度: {canonical_id: WNAC_TmpDistCab, unit: degC, valid_range: [-40, 90], observed_range: [-5, 50]}
    机舱控制柜温度: {canonical_id: WNAC_TmpCtrlCab, unit: degC, valid_range: [-40, 90], observed_range: [0, 55]}
    辅助变压器温度: {canonical_id: WTRM_TmpAuxTfmr, unit: degC, valid_range: [-40, 200], observed_range: [0, 80], note: "max192 spike→界外NaN"}
    变流器冷却介质温度: {canonical_id: WCNV_TmpCoolant, unit: degC, valid_range: [-40, 90], observed_range: [0, 45]}

    轴1电机温度: {canonical_id: WPCH_TmpMotBld1, unit: degC, valid_range: [-45, 120], observed_range: [-40, 75], sentinel: [-40], note: "变桨轴电机温(轴1/2/3=3叶片); -40=floor哨兵"}
    轴2电机温度: {canonical_id: WPCH_TmpMotBld2, unit: degC, valid_range: [-45, 120], observed_range: [-40, 75], sentinel: [-40]}
    轴3电机温度: {canonical_id: WPCH_TmpMotBld3, unit: degC, valid_range: [-45, 120], observed_range: [-40, 80], sentinel: [-40]}
    轴1控制柜温度: {canonical_id: WPCH_TmpCtrlCab1, unit: degC, valid_range: [-45, 90], observed_range: [-40, 60], sentinel: [-40]}
    轴2控制柜温度: {canonical_id: WPCH_TmpCtrlCab2, unit: degC, valid_range: [-45, 90], observed_range: [-40, 60], sentinel: [-40]}
    轴3控制柜温度: {canonical_id: WPCH_TmpCtrlCab3, unit: degC, valid_range: [-45, 90], observed_range: [-40, 60], sentinel: [-40]}
    轴1后备电源柜温度: {canonical_id: WPCH_TmpBupCab1, unit: degC, valid_range: [-45, 90], observed_range: [-40, 55], sentinel: [-40]}
    轴2后备电源柜温度: {canonical_id: WPCH_TmpBupCab2, unit: degC, valid_range: [-45, 90], observed_range: [-40, 55], sentinel: [-40]}
    轴3后备电源柜温度: {canonical_id: WPCH_TmpBupCab3, unit: degC, valid_range: [-45, 90], observed_range: [-40, 55], sentinel: [-40]}

    桨角1:
      canonical_id: WROT_PtchAngBld1
      unit: deg
      valid_range: [-5, 95]
      observed_range: [0, 93]
      note: "raw min-314 garbage→界外NaN; p50~0(below-rated); 独立变桨(桨角1/2/3三叶片)"
    桨角2: {canonical_id: WROT_PtchAngBld2, unit: deg, valid_range: [-5, 95], observed_range: [0, 93]}
    桨角3: {canonical_id: WROT_PtchAngBld3, unit: deg, valid_range: [-5, 95], observed_range: [0, 93]}
    桨叶1角度给定: {canonical_id: WROT_PtchAngSpBld1, unit: deg, valid_range: [-5, 100], observed_range: [0, 96], note: "变桨setpoint"}
    桨叶2角度给定: {canonical_id: WROT_PtchAngSpBld2, unit: deg, valid_range: [-5, 100], observed_range: [0, 96]}
    桨叶3角度给定: {canonical_id: WROT_PtchAngSpBld3, unit: deg, valid_range: [-5, 100], observed_range: [0, 96]}

    电网A相电流: {canonical_id: WCNV_GriIA, unit: A, valid_range: [0, 3000], observed_range: [0, 2270]}
    电网B相电流: {canonical_id: WCNV_GriIB, unit: A, valid_range: [0, 3000], observed_range: [0, 2270]}
    电网C相电流: {canonical_id: WCNV_GriIC, unit: A, valid_range: [0, 3000], observed_range: [0, 2270]}
    无功功率: {canonical_id: WTUR_VAr, unit: kVar, valid_range: [-1000, 1000], observed_range: [-250, 700]}

    机舱位置:
      canonical_id: WNAC_Dir
      unit: deg
      valid_range: [0, 360]
      observed_range: [0, 360]
      frame: nacelle_encoder
      note: "[0,360]wrapped方位; 偏航编码器相对零位"
    偏航误差:
      canonical_id: WYAW_YawErr
      unit: deg
      valid_range: [-180, 180]
      observed_range: [-180, 180]
      frame: nacelle_relative
      note: "相对对风误差(signed vane); 静态偏航用此"
    绝对风向:
      canonical_id: WMET_Dir_pseudo
      unit: deg
      valid_range: [0, 360]
      observed_range: [0, 357]
      frame: nacelle_derived
      note: "★nacelle派生(机舱位置+相对vane), 非独立地理; 禁扇区/风玫瑰/绝对偏航锚(循环)"
    电缆扭角: {canonical_id: WYAW_CableTwist, unit: deg, valid_range: [-1100, 1100], observed_range: [-500, 550], note: "unwrapped扭缆累计; 解缆代理"}

    有功上限: {canonical_id: WTUR_WSpLim, unit: kW, valid_range: [-10, 2600], observed_range: [0, 2520], note: "有功上限setpoint(限电/降额判据源)"}
    有功调度下限: {canonical_id: WTUR_WSpLoLim, unit: kW, valid_range: [-10, 2600], observed_range: [0, 100], note: "调度下限setpoint(多为0/100)"}
    无功设定: {canonical_id: WTUR_VArSp, unit: kVar, valid_range: [-1000, 1000], observed_range: [-250, 700], note: "无功setpoint(AVC调度; 无功归因=dispatch ceiling)"}
    理论可发最大功率: {canonical_id: WTUR_WThy, unit: kW, valid_range: [-50, 2700], observed_range: [0, 2560], note: "理论应发(限电损失分母参考; OEM算法产物勿当独立真值)"}
    停机事件地址: {canonical_id: WSLG_stop_event_addr, unit: code, valid_range: [0, 20000], observed_range: [0, 12000], note: "★停机事件码(稀疏nz0.07, 事件驱动); 首发故障地址列死; 事件层另有 7、故障统计xlsx"}

    限功率:
      canonical_id: WTUR_CurtFlag
      unit: bool
      valid_range: [0, 1]
      observed_range: [0, 1]
      note: "★★非纯限电信号: per台5.7%(B1/B15)~68%(其余18)悬殊, fleet60%远超状态12(12%) → 疑=有功上限<额定即置1或部分台固化; 限电识别改用 风机主状态=12 + setpoint; CL-3 channel-semantics WARN候选"
    计入功率曲线:
      canonical_id: WTUR_PcFlag
      unit: bool
      valid_range: [0, 1]
      observed_range: [0, 1]
      note: "power curve有效点flag; B1/B15~77% vs 其余~50-60%"

    风机主状态:
      role: state_enum
      canonical_id: WSLG_turbine_state
      unit: enum
      status_enum_ref: configs/fault_dicts/dongfang_dec_3p2mw_status_enum_0_43.csv
      semantic: "复用DEC自解: 15=正常运行(dominant, power curve主样本)/12=调度限电(11.6%, 限电剥离主信号)/13=部件降额(9.6%)/14=告警发电/0=启动/16·17=停机/22·23·24·25=本型待验; 含小数值(14.9x=10min跨态平均); 稀疏必ffill"