guanlan-src/app_ETL/configs/contracts/taizhong_tz2000_93_fuxin_rushan.yaml

# 数据契约 — 太重 TZ2000/93 齿箱DFIG (华电福新乳山风场, 山东威海乳山 / 华电山东)
# schema_v2 SOP 标准件 (2026-07-18, 半成品onboard补链回填 wake选项b)。
#
# ★ 特殊: 本契约验 **清洗层 cleaned/turbine_10min.parquet (列已归一化)**, 非原始 CSV —
#   现 cleaned 由 scripts/onboard_fuxin_rushan.py 生成 (e482ade3, 早于契约; 惠山债偿模式补链):
#   原始=风机数据/A1-A24/output.csv (1-min, 25列, 目录名"10分钟"实测1-min王家湾坑) → 列名去台号前缀+去(历史)
#   → 哨兵剥离(温度valid[-40,125]/功率[0,2200]) → 派生10min真时均层(温度median/功率mean)。
#   valid_range = 清洗时 clip 门 (脚本 TEMP_LO/HI, POW_LO/HI); observed_range = 现 cleaned 实测 min/max。
# ★ OEM = 太重 TZ2000/93 (2MW齿箱双馈): cleaned/fingerprint.json (e482ade3 遗留onboard元数据) 坐实;
#   库内无同型契约复用 (夏邱/南墅=上海电气SEWIND, 结构不同) → 独立写。G3可迁移性: 诊断算子用前须重标。
# ★ self_ref 订正: findings FR-1 早判"无测风塔"失实 → 实有真6高度测风塔(3、测风塔数据, 窗2025-10~11约1月,
#   部分高度层坏); 绝对达成率仍 INSUFFICIENT 但理由="有塔但窗1月+单塔空间代表性未过", 达成率须 power-curve-ntf 专线。
schema_version: 2

meta:
  oem: 太重 TZ2000
  model: TZ2000/93 (2MW 齿箱双馈 DFIG; 93m叶轮)
  topology: dfig_geared            # 齿轮箱油温+高/低速轴+主轴 + 发电机DE/NDE轴承 + 发电机线圈L1L2L3三相 + rpm_gen高速轴
  rated_kw: 2000                   # 太重TZ2000铭牌(2MW级); cleaned功率 p99~1779/max2064 = 运行未满发或场特性(风资源)
  rated_kw_note: "铭牌2000kW(TZ2000). cleaned实测 power p99~1779 max2064 → 达成率参考额定取2000; 未满发成因(风资源/降容)须专线, onboard不判。"
  rotor_d_m: 93                    # TZ2000/93 型号后缀
  source_farm: 华电福新乳山风场(山东省威海市乳山市, 华电山东; 华电山东隐患排查数据-2026.2 批, 同夏邱/南墅/虎头崖/德惠源)
  n_machines: 24                   # ✅风机数据目录 A1-A24 = 24台有温度数据; ★21台有实际功率(A01/A02/A03=限值台无电网有功功率列)
  n_machines_note: "24台目录(A1-A24)全有温度; 但 A01/A02/A03 无'电网有功功率'列(仅功率限值) → power=NaN → 21台有功率数据。findings n_machines=21(有效功率台)。"
  absent_channels_note: "cleaned 10min层无: 桨距角(三叶不平衡/集距 N/A) / 振动(部件振动 N/A; 8、CMS有报告无数据) / 机舱位置/风向角(扇区/静态偏航/cable_twist N/A) / 齿箱双压dP / 逐相电流。→ 温度NBM(相间/配对差)+机群相对+限电(功率-风推断)可做; 变桨/偏航/振动/绝对功率曲线 不可做。"
  secondary_layers:
    metmast: "3、测风塔数据 (登记非清洗): 测风塔数据.csv(zip内, 6高度 avgspeedlv1-6/directionlv1-6/温湿压, 15min, 窗2025-10-25~11-25约1月, ★部分高度层0/NaN坏) + 气象实测2025-10-25_11-25.csv(同窗) + 功率数据/实际功率数据csv。→ 绝对达成率专线(power-curve-ntf: 15min→10min重采+空间代表性+不确定度带); onboard未装cleaned。"
    event_fault: "7、机组状态、事件、故障数据 (登记非装配): 事件/故障层, 限电剥离/停机型/A_op可建 (Phase-2)。"
  layout:
    format: "原始: 1、10分钟SCADA数据/风机数据/风机数据/A{1..24}/output.csv (per台1目录, 1-min实测25列); cleaned: 派生10min真时均层16列(归一化名)"
    encoding: utf-8
    time_format: "YYYY-MM-DD HH:MM:SS (原'时间'列)"
    machine_token: "目录 A1..A24 (无前导0) → 清洗统一 A01..A24 (对齐gold_cms)"
    assemble: "scripts/onboard_fuxin_rushan.py (逐台output.csv → clean_col去前缀 → 哨兵剥离 → resample('10min')median/mean → concat)"
  sampling:
    turbine_10min_s: 600           # ✅ cleaned per台 t.diff().median()=600 (全24台 min=median=max=600)
    raw_s: 60                      # ★原始output.csv实测1-min (目录名"10分钟"错; 王家湾坑)
    window: "2025-01-01 ~ 2026-01-23 (约13月, 1257371行/24台)"

turbine_10min:
  sampling_s: 600
  required: ["power", "wind"]
  machine_col: tid
  time_col: time
  columns:
    power:
      canonical_id: WTUR_active_power
      raw_unit: kW
      valid_range: [0, 2200]
      observed_range: [0, 2064.0]        # p99~1779 rated2000; A01/A02/A03限值台=NaN(30.6% nan含限值台+停机)
      self_ref_note: "★订正: 早判'无测风塔self_ref'失实, 实有6高度测风塔(窗1月部分层坏); 绝对达成率仍INSUFFICIENT(有塔但窗1月+单塔空间代表性未过), 须 power-curve-ntf 专线, 非机舱风self_ref一句可结。"
    wind:
      canonical_id: WMET_horWdSpd
      unit: m/s
      valid_range: [0, 40]
      observed_range: [0, 35.5]
      self_ref_risk: medium
      note: "机舱风(风速10min平均); 有真测风塔但窗仅1月 → 达成率专线才用塔风替self_ref"
    rpm_gen:
      canonical_id: WGEN_Spd
      unit: rpm
      valid_range: [-2, 2000]
      observed_range: [0, 1843.7]
      semantic: "发电机转速(高速轴, 齿箱DFIG); 原'发电机转速1s'列"
    ambient:
      canonical_id: WMET_EnvTmp
      unit: degC
      valid_range: [-40, 55]
      observed_range: [-39.7, 45.3]
      semantic: "户外温度(分箱轴/环温); clip -40 边界(实测min=-39.7)"
    nacelle_temp:
      canonical_id: WNAC_IntTmp
      unit: degC
      valid_range: [-40, 80]
      observed_range: [-40.0, 41.5]
      semantic: "机舱温度(辅助); clip -40 边界"
    # ---- 9部件温度 (引擎判据轴; valid上限125=清洗clip门, observed_max=125=边界真值) ----
    齿轮箱油温:
      canonical_id: WGdV_TmpOil
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-6.0, 87.5]
      semantic: "齿箱油温 → 齿箱轴承温冷浸参照(高/低速轴)"
    齿轮箱高速轴温度:
      canonical_id: WGdV_TmpHSShaft
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-5.7, 93.8]
    齿轮箱低速轴温度:
      canonical_id: WGdV_TmpLSShaft
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-6.1, 91.6]
    主轴温度:
      canonical_id: WROT_TmpMainBrg
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-7.6, 65.8]
      semantic: "主轴承(脂润滑, 无油浴冷浸参照)"
    发电机驱动端轴承温度:
      canonical_id: WGEN_TmpBrgDE
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-37.8, 109.0]
      semantic: "发电机DE轴承 → 配对差(vs NDE)可做"
    发电机非驱动端轴承温度:
      canonical_id: WGEN_TmpBrgNDE
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-10.0, 115.7]
    发电机线圈L1温度:
      canonical_id: WGEN_TmpStaU
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-11.7, 125.0]
      semantic: "★发电机线圈三相L1/L2/L3 → 相间不平衡可做; obs_max=125=clip边界(哨兵142-148/649剔)"
    发电机线圈L2温度:
      canonical_id: WGEN_TmpStaV
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-7.7, 125.0]
    发电机线圈L3温度:
      canonical_id: WGEN_TmpStaW
      unit: degC
      valid_range: [-40, 125]
      observed_range: [-7.9, 125.0]