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

# 数据契约 — 远景 ENVISION EN-87/EN-93 1.5MW DFIG (盂县东梁乡片区, 山西)
# ★★★ 文件名 crrc_wt1500_* = 历史误命名 (onboard 时误推断中车); 实际 OEM = 远景, 文件名保留防断 outputs 证据链 (fingerprint/gate json 引此路径)。
# schema: docs/OEM_KB §3. 校验器: scripts/validate_contract.py. oem-onboard 2026-07-06.
# ★ OEM 定谳 (2026-07-12, 用户+数据范式交叉核对): 用户"东梁乡片区=远景 EN-87/EN-93 1.5MW DFIG(齿轮箱双馈)";
#   数据范式核对 — yuxian(东梁)通道命名逐字匹配 pingyin(远景EN110) 与 envision_en87(王家湾, 用户确认=远景82) 的远景独特指纹
#   (主轴转速/发电机定子U相线圈温度/齿轮箱中间轴驱动端非驱动端温度/主轴承外圈温度 = 远景命名范式, 非中车/华锐/上电)。
#   数据佐证: p95 1440/1517=1.5MW; gen 1101rpm 高速侧 + 齿轮箱油池/油路/中间轴温 = 齿轮箱双馈 (与远景 EN-87/93 DFIG 相容)。原"中车CRRC"系onboard推断(台账"OEM待定")彻底出局。
#   盂县是县含多场跨多OEM (西烟一期金风GW/西烟二期远景EN110/西潘二期运达2.2/东梁远景EN87-93); 本数据=东梁片区。
meta:
  oem: "远景 ENVISION (定谳 — 用户确认 + 数据范式交叉核对王家湾en87/pingyin en110 远景通道指纹)"
  model: "EN-87 / EN-93 1.5MW DFIG (齿轮箱双馈; rated 实测 p95≈1519kW=1.5MW; EN-87 vs EN-93 分型待机台表/叶轮径)"
  topology: DFIG_geared          # 发电机转速 med 1103rpm(高速) + 主轴转速独立列 → 齿轮箱双馈
  rated_kw: 1500
  farm_code: WOF035300036
  source_farm: 盂县风电场 (山西, 中广核, 一期东梁1线 D01-D17 + 二期 D18-D33)
  turbine_count: 33              # D01-D33 (名称="盂县 Dnn"); 逐 zip 内成员坐实
  data_layers:
    agg_10min: "收资数据/min/Data_*.zip (2 zip, *_ten_avg_val.csv 37列GBK, 名称列, 600s). 窗2024-05~2025-05整年"
    min_1: "收资数据/sec/Data_*.zip (2 zip, *_minute.csv, 1min). 状态码/更高频量待此层"
  sampling: {agg_10min_s: 600, verified: "样本D05 时间diff中位=600s+众数600"}
  provenance: "oem-onboard 2026-07-06; G-OEM 样本D05 52704行; 编码=gbk, 哨兵=NaN型(无-99/9999)"

turbine:
  required: [发电机有功功率, 风速]
  columns:
    发电机有功功率: {canonical_id: WAPC_active_power, unit: kW, valid_range: [-200, 1700]}   # p95≈1519≈额定1500, 负值20%(电动/待机)
    发电机转速: {canonical_id: WGEN_speed, unit: rpm, valid_range: [-200, 2000]}              # med1103 高速侧DFIG
    主轴转速: {canonical_id: WROT_rotor_speed, unit: rpm, valid_range: [-5, 40]}
    风速: {canonical_id: WMET_wind_speed_nacelle, unit: m/s, valid_range: [0, 45], self_ref_risk: true}  # 机舱风 med4.8
    机舱风向夹角:
      canonical_id: WYAW_yaw_error
      frame: UNVERIFIED            # ⚠ range0-360 med151 (非±180对中型) → 坐标系待定: 可能机舱-北 非真失配; 对风分析须先定义/居中
      valid_range: [0, 360]
      note: "★yaw分析前必核: 0-360且med151≠对风失配(应近0); 疑机舱位置或vane-北向. 用前 wrap/减fleet中位或找1min层真失配列"
    '1#桨叶片角度': {canonical_id: WROT_pitch_angle_1, unit: deg, valid_range: [-5, 95]}    # med0.09运行 max92顺桨
    '2#桨叶片角度': {canonical_id: WROT_pitch_angle_2, unit: deg, valid_range: [-5, 95]}
    '3#桨叶片角度': {canonical_id: WROT_pitch_angle_3, unit: deg, valid_range: [-5, 95]}
    '1#桨设定角度': {canonical_id: WROT_pitch_setpoint_1, unit: deg, valid_range: [-5, 95]}
    实际扭矩: {canonical_id: WGEN_torque_actual, unit: Nm}
    设定扭矩: {canonical_id: WGEN_torque_set, unit: Nm}
    发电机驱动端轴承温度: {canonical_id: WGEN_de_bearing_temp, unit: degC, valid_range: [-40, 150]}
    发电机非驱动端轴承温度: {canonical_id: WGEN_nde_bearing_temp, unit: degC, valid_range: [-40, 150]}
    发电机定子U相线圈温度: {canonical_id: WGEN_stator_u_temp, unit: degC, valid_range: [-40, 200]}
    发电机定子V相线圈温度: {canonical_id: WGEN_stator_v_temp, unit: degC, valid_range: [-40, 200]}
    发电机定子W相线圈温度: {canonical_id: WGEN_stator_w_temp, unit: degC, valid_range: [-40, 200]}
    齿轮箱油路入口温度: {canonical_id: WTRM_gbx_oil_inlet_temp, unit: degC, valid_range: [-40, 120]}
    齿轮箱油池温度: {canonical_id: WTRM_gbx_oil_sump_temp, unit: degC, valid_range: [-40, 120]}
    齿轮箱中间轴驱动端轴承温度: {canonical_id: WTRM_gbx_ims_de_temp, unit: degC, valid_range: [-40, 130]}
    齿轮箱中间轴非驱动端轴承温度: {canonical_id: WTRM_gbx_ims_nde_temp, unit: degC, valid_range: [-40, 130]}
    主轴承外圈温度: {canonical_id: WTRM_mainbrg_outer_temp, unit: degC, valid_range: [-40, 120]}
    舱外温度: {canonical_id: WMET_ambient_temp, unit: degC, valid_range: [-45, 55]}          # NBM共模基线 med11
    舱内温度: {canonical_id: WNAC_nacelle_temp, unit: degC, valid_range: [-45, 80]}
    可利用率: {canonical_id: WAVL_availability, unit: pct, valid_range: [0, 100]}
    功率曲线状态: {canonical_id: WSTA_pc_status, role: state, note: "10min层100%空 → 状态码/限电须去1min层"}

cleaning:
  physical:
    - "温度类 <= -50 → NaN (哨兵/坏值)"
    - "风速 > 45 → 尖峰剔"
  semantic:
    - "★功率曲线状态 10min层全空 → 无有效状态码: 可用率/停机物理派生 (发电=P>50 / 有风停=|P|≤50&风≥3 / 低风待机=|P|≤50&风<3). 无电网频率列→不分脱网停"
    - "机舱风向夹角 0-360 非对中型 → 对风绝对值不可直读, 须坐标系核实 (self_ref/名实)"

traps:
  - "★ rated 1500 ≠ 已有中车契约 crrc_wt2200d131(诺木洪2.2MW) → 结构复用参数必重验; 同OEM不同型语义逐型核"
  - "★ 机舱风向夹角 0-360 med151 ≠ 对风失配(应近0) → 疑机舱位置/vane-北; 静态偏航须先定义坐标系, 勿当失配直读 (self_ref铁律)"
  - "★ 功率曲线状态 10min层空 → 限电/状态分析须去1min层(收资数据/sec/*_minute.csv), 10min层限电只能靠功率封顶间接"
  - "发电机转速range含负(电动/停机瞬态) → 用主轴转速做rotor更稳"