# 数据契约 — 乌梅山风电场 (江西, 大唐) — OEM未定 6.31MW级 齿驱DFIG, 8台(51-58号)
# OEM=未定: 通道命名指纹(抗涡激功能/核控估计风速/KEB桨叶驱动器/解缆对风/变桨电池柜/4.X·5.X平台) 与库内已知大唐场
#   (岭门明阳英文变体/海勒斯远景EnOS英文列) 均不匹配 → 大唐另一GBK中文export变体, 待业主铭牌确认 (memory oem-id-channel-naming-fingerprint: onboard推断勿当定谳)。
# rated=6310kW data-first三证: ①主控有功限值上限(额定功率)列 fleet常值6310 ②风机额定功率上限列 fleet常值6310
#   ③有功功率 fleet Pmax 6435-6653 (仅~2-5%过额定=瞬时boost, 非坏值/量纲错; "max6519存疑"已解: fleet一致+物理合理)。
#   扭矩交叉印证: 实际扭矩p99≈29587Nm, T=P/ω=6.31e6/(1700·2π/60)≈35400Nm rated → 量级自洽。
# G-OEM 实证 (2026-07-16, scratchpad/{probe,stats,sentinel}.py 全8台1min直读):
#   真采样率 t.diff中位=60.0s (全8台一致, 禁全局median) / 无整数哨兵(-99/9999扫描=0命中, 缺测=NaN, 死通道=常值0)
#   / 名称列坐实8台(51-58号风机, 每文件单值, 禁文件名parse) / 窗2024-05-01~07-31(3月, 131880行/台)
#   / self_ref: 风速全系机舱风速计(风速/机械式/超声波/核控估计 均self_ref), 无测风塔交付 → 绝对功率曲线/Cp禁。
# 真3叶IPC: 1#/2#/3#桨叶片角度 发电态极差p95=1.88~2.68°(>1°) → pitch=independent_ipc, 非broadcast (已核)。
schema_version: 2
meta:
  oem: 未定 (大唐GBK中文export变体; 通道指纹不匹配库内已知场; 待铭牌/业主确认)
  model: "未定 6.31MW级 (齿驱DFIG; 发电机转速p99≈1707rpm + 主轴转速p99≈8.4rpm → 齿比≈200; 有齿轮箱高速/中速轴温)"
  rated_kw: 6310
  rated_note: "data-first三证 (rated列fleet常值6310 ×2 + Pmax6435-6653仅+2~5%过额定boost + 扭矩量级自洽); 型号铭牌未交付"
  n_turbines: 8
  n_with_data: 8            # 51-58号风机, 内部'名称'列坐实 (全8台min层100%有数据)
  farm: wumeishan
  site: 江西 大唐 山地
  topology: geared_DFIG
  self_ref_risk: true       # 风速=机舱风速计 self_ref; 无测风塔 → 绝对达成率/Cp 禁机舱风 (Cp>Betz=INSUFFICIENT铁证)
  windows:
    turbine_sec: "2024-05-01~2024-07-31 (3月, 60s实测, 131880行/台×8)"
  secondary_layers_deferred:  # 收资数据/1129/ 下2个1s窄列层(Oct2024, 非本窗); 本轮不契约化, 见 survey.data_layers 与 traps
    - "1129/202411290001.csv: 1s, 6列(桨叶角度2×3+发电机转速), 窗2024-10-20起"
    - "1129/乌梅山2期数据.csv: 1s, 7列(偏航角度/有功1s/转速/风向/风速), 窗2024-10-20起"

turbine_sec:                 # 命名=canonical高频原生层 (实为60s/1min; 对齐海勒斯先例 turbine_sec sampling_s:60)
  sampling_s: 60
  machine_col: 名称          # 内部 '51号风机'..'58号风机', 权威id (禁文件名parse)
  required: [发电机有功功率, 风速]
  columns:
    时间: {role: timestamp}
    风速: {valid_range: [0, 60], observed_range: [0.38, 28.06], sentinel: [], canonical_id: WMET_wind_speed_nacelle, note: "机舱风速计 self_ref; p99≈8.3(山地低风); 禁绝对Cp/达成率"}
    机舱中轴线与风向夹角: {valid_range: [-180, 180], observed_range: [-179.99, 179.99], sentinel: [], canonical_id: WYAW_yaw_error, note: "对风误差(机舱相对, 带符号); 发电态中位≈0"}
    发电机有功功率: {valid_range: [-500, 6900], observed_range: [-60.63, 6653.21], sentinel: [], canonical_id: WAPC_active_power, note: "rated6310; Pmax6653=瞬时boost; 负值=电动/idle自耗(真, 非哨兵)"}
    发电机转速: {valid_range: [0, 2200], observed_range: [0.1, 1820.62], sentinel: [], canonical_id: WGEN_speed, note: "DFIG齿驱 ~1700rpm"}
    网侧频率: {valid_range: [45, 55], observed_range: [49.93, 50.06], sentinel: [], canonical_id: WGRID_freq}
    发电机无功功率: {valid_range: [-2000, 2000], observed_range: [-954.63, 1418.55], sentinel: [], canonical_id: WGRID_reactive_power}
    功率因数: {valid_range: [-1, 1], observed_range: [-1, 1], sentinel: [], canonical_id: WGRID_power_factor}
    网侧L1相电流: {valid_range: [0, 4000], observed_range: [4, 3224], sentinel: [], canonical_id: WCNV_current_l1, note: "3相独立; min=4A=idle地板(真读数非哨兵)"}
    网侧L2相电流: {valid_range: [0, 4000], observed_range: [4, 3220], sentinel: [], canonical_id: WCNV_current_l2}
    网侧L3相电流: {valid_range: [0, 4000], observed_range: [4, 3204], sentinel: [], canonical_id: WCNV_current_l3}
    主轴转速: {valid_range: [0, 20], observed_range: [0, 8.94], sentinel: [], canonical_id: WROT_rotor_speed, note: "低速轴rpm; p99≈8.4"}
    舱外温度: {valid_range: [-45, 55], observed_range: [-1.5, 34.09], sentinel: [], canonical_id: WMET_ambient_temp, note: "夏窗5-7月; NBM油温非本列, 反-环温判据用此"}
    舱内温度: {valid_range: [-40, 80], observed_range: [-1, 40.39], sentinel: [], canonical_id: WNAC_temp_inner}
    主轴承温度: {valid_range: [-40, 120], observed_range: [0, 47.79], sentinel: [], canonical_id: WTRM_mainbrg_temp, note: "脂润滑无油浴; 冷浸参照勿配油温"}
    齿轮箱油池温度: {valid_range: [-40, 120], observed_range: [0, 63.8], sentinel: [], canonical_id: WGBX_oil_temp, note: "齿箱油温; 冷浸参照候选(comp=齿箱轴承温时)"}
    齿轮箱入口温度: {valid_range: [-40, 120], observed_range: [0, 59.88], sentinel: [], canonical_id: WGBX_oil_inlet_temp}
    齿轮箱高速轴驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 73.93], sentinel: [], canonical_id: WGBX_hss_de_temp}
    齿轮箱高速轴非驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 79.4], sentinel: [], canonical_id: WGBX_hss_nde_temp}
    齿轮箱中速轴驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 65.48], sentinel: [], canonical_id: WGBX_ims_de_temp}
    齿轮箱中速轴非驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 65.47], sentinel: [], canonical_id: WGBX_ims_nde_temp}
    发电机定子U相线圈温度: {valid_range: [-40, 180], observed_range: [0, 117.62], sentinel: [], canonical_id: WGEN_winding_u, note: "F级155℃阈"}
    发电机定子V相线圈温度: {valid_range: [-40, 180], observed_range: [0, 119.28], sentinel: [], canonical_id: WGEN_winding_v}
    发电机定子W相线圈温度: {valid_range: [-40, 180], observed_range: [0, 117.62], sentinel: [], canonical_id: WGEN_winding_w}
    发电机驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 74.83], sentinel: [], canonical_id: WGEN_brg_de_temp, note: "热汇=发电机冷却; 冷浸参照勿配"}
    发电机非驱动端轴承温度: {valid_range: [-40, 150], observed_range: [0, 107.3], sentinel: [], canonical_id: WGEN_brg_nde_temp}
    轮毂内温度: {valid_range: [-40, 120], observed_range: [0, 38.4], sentinel: [], canonical_id: WHUB_temp}
    发电机实际扭矩: {valid_range: [0, 45000], observed_range: [0, 36723.39], sentinel: [], canonical_id: WGEN_torque, note: "Nm; rated~35400Nm(P/ω); nz59-72%(idle零)"}
    发电机扭矩设定值: {valid_range: [0, 45000], observed_range: [0, 45000], sentinel: [], canonical_id: WGEN_torque_setpoint, note: "扭矩setpoint(未逐台核, 界宽松)"}
    1#桨叶片角度: {valid_range: [-8, 95], observed_range: [-6.54, 92.47], sentinel: [], canonical_id: WROT_pitch_angle_1, note: "真IPC独立三叶之1 (发电态极差p95=2.67°>1°)"}
    2#桨叶片角度: {valid_range: [-8, 95], observed_range: [-6.48, 94.09], sentinel: [], canonical_id: WROT_pitch_angle_2}
    3#桨叶片角度: {valid_range: [-8, 95], observed_range: [-6.35, 91.98], sentinel: [], canonical_id: WROT_pitch_angle_3}
    1#桨设定叶片角度: {valid_range: [-8, 95], observed_range: [-6.76, 92], sentinel: [], canonical_id: WROT_pitch_setpoint_1, note: "变桨setpoint; 测量-setpoint=跟踪误差"}
    2#桨设定叶片角度: {valid_range: [-8, 95], observed_range: [-6.68, 92], sentinel: [], canonical_id: WROT_pitch_setpoint_2}
    3#桨设定叶片角度: {valid_range: [-8, 95], observed_range: [-6.5, 92], sentinel: [], canonical_id: WROT_pitch_setpoint_3}
    1#桨电机温度: {valid_range: [-40, 120], observed_range: [0, 69.82], sentinel: [], canonical_id: WROT_pitch_motor_temp_1}
    2#桨电机温度: {valid_range: [-40, 120], observed_range: [0, 70.88], sentinel: [], canonical_id: WROT_pitch_motor_temp_2}
    3#桨电机温度: {valid_range: [-40, 120], observed_range: [0, 67], sentinel: [], canonical_id: WROT_pitch_motor_temp_3}
    变桨电机1电流: {valid_range: [0, 60], observed_range: [0, 29.03], sentinel: [], canonical_id: WROT_pitch_motor_current_1}
    变桨电机2电流: {valid_range: [0, 60], observed_range: [0, 27.96], sentinel: [], canonical_id: WROT_pitch_motor_current_2}
    变桨电机3电流: {valid_range: [0, 60], observed_range: [0, 27.12], sentinel: [], canonical_id: WROT_pitch_motor_current_3}
    变桨驱动器1温度: {valid_range: [-40, 120], observed_range: [0, 47], sentinel: [], canonical_id: WROT_pitch_driver_temp_1}
    变桨驱动器2温度: {valid_range: [-40, 120], observed_range: [0, 48], sentinel: [], canonical_id: WROT_pitch_driver_temp_2}
    变桨驱动器3温度: {valid_range: [-40, 120], observed_range: [0, 48], sentinel: [], canonical_id: WROT_pitch_driver_temp_3}
    齿轮箱滤网前油压: {valid_range: [-5, 15], observed_range: [-4, 6.92], sentinel: [], canonical_id: WGBX_oil_prs_filter, note: "-4=地板/负压疑, 保留标疑"}
    齿轮箱入口油压: {valid_range: [-5, 15], observed_range: [-4, 2.84], sentinel: [], canonical_id: WGBX_oil_prs_inlet}
    机舱侧向振动(已滤波): {valid_range: [-5, 10], observed_range: [0, 2.77], sentinel: [], canonical_id: WNAC_vib_lateral_filt, note: "健康/variance用; nz73-83%"}
    机舱轴向振动(已滤波): {valid_range: [-5, 10], observed_range: [0, 2.77], sentinel: [], canonical_id: WNAC_vib_fore_aft_filt}
    机舱侧向振动(未滤波): {valid_range: [-5, 10], observed_range: [-0.73, 2.77], sentinel: [], canonical_id: WNAC_vib_lateral_raw}
    机舱轴向振动(未滤波): {valid_range: [-5, 10], observed_range: [-0.52, 2.77], sentinel: [], canonical_id: WNAC_vib_fore_aft_raw}
    风向: {valid_range: [-180, 180], observed_range: [-179.99, 179.99], sentinel: [], canonical_id: WMET_wind_dir, note: "带符号±180"}
    机舱中轴线与风向夹角机械式: {valid_range: [-180, 180], observed_range: [-179.99, 179.99], sentinel: [], canonical_id: WYAW_yaw_error_mech}
    风速机械式: {valid_range: [0, 60], observed_range: [0, 28.06], sentinel: [], canonical_id: WMET_wind_speed_mech}
    机舱中轴线与风向夹角超声波: {valid_range: [-180, 180], observed_range: [-179.99, 179.99], sentinel: [], canonical_id: WYAW_yaw_error_ultra}
    风速超声波: {valid_range: [0, 60], observed_range: [0, 36.16], sentinel: [], canonical_id: WMET_wind_speed_ultra}
    核控估计风速: {valid_range: [0, 60], observed_range: [0.1, 24.14], sentinel: [], canonical_id: WMET_wind_speed_est, note: "控制器估计风速"}
    解缆对风角度: {valid_range: [-180, 180], observed_range: [-179.98, 179.99], sentinel: [], canonical_id: WYAW_wind_align_angle, note: "≡自动对风角度(镜像)"}
    机舱角度: {valid_range: [-1000, 1000], observed_range: [-421.95, 655.58], sentinel: [], canonical_id: WYAW_nacelle_position_accum, note: "累积机舱位置(±500), 非地理0-360方位; 解缆量, 勿当bearing"}
    偏航角度: {valid_range: [-1000, 1000], observed_range: [-471.68, 503.84], sentinel: [], canonical_id: WYAW_yaw_position_accum, note: "累积偏航位置(±500), 非0-360; 与机舱角度/扭揽角度同族"}
    扭揽角度: {valid_range: [-1000, 1000], observed_range: [-471.68, 504.58], sentinel: [], canonical_id: WYAW_cable_twist_angle, note: "扭缆角(累积±500)"}
    偏航状态: {role: status, observed_range: [0, 200], sentinel: [], canonical_id: WYAW_state, note: "离散状态码(0-200枚举); 事件表未交付, 数值勿平均"}
    自算有功功率: {valid_range: [-500, 6900], observed_range: [0, 6602.51], sentinel: [], canonical_id: WAPC_active_power_selfcalc, note: "自算有功(nz59-72%); 与发电机有功功率互证"}
    主控有功限值上限(额定功率): {role: param, dead_channel: true, observed_range: [6310, 6310], sentinel: [], canonical_id: WTUR_rated_power_param, note: "fleet常值6310=rated铭牌参数(非活信号, dead_channel=承认恒值非故障, 承载rated口径)"}
    风机额定功率上限: {role: param, dead_channel: true, observed_range: [6310, 6310], sentinel: [], canonical_id: WTUR_rated_power_limit, note: "fleet常值6310(同上, 恒值param非故障)"}

cleaning:
  physical: "valid_range 界外→NaN (apply_contract_gate, 非clamp); 无整数哨兵(sentinel扫描0命中); 累积角(机舱角度/偏航角度/扭揽角度)界宽±1000勿误NaN"
  semantic: "min层无解码状态码列(偏航状态=离散枚举但事件表未交付); 限电/停机型判据须物理派生(P/频率/风速/转速) 或待事件表; 对风误差=机舱中轴线与风向夹角直读; 累积角非地理bearing"
  per_turbine_liveness: "250列中~117列fleet常值0/死(水冷/塔底/颗粒计数器/HSS_GS*齿箱别名列); 主轴后轴承温度fleet全死; 分析前必per台liveness闸(表头有列≠有活信号, memory channel-header-not-liveness); 主轴转速/振动/扭矩/变桨电流 nz<90%(idle零, 非死)"
traps:
  - "OEM未定: 通道指纹不匹配库内任一已知场(远景EnOS=英文列, 岭门明阳=英文变体); 勿据onboard推断当定谳, 出实名报告前须业主铭牌确认"
  - "镜像dup列: 外侧有功功率≡发电机有功功率; 主轴承内圈温度≡主轴承外圈温度≡主轴承温度; 自动对风角度≡解缆对风角度 → 勿当独立通道交叉印证"
  - "累积角陷阱: 机舱角度/偏航角度/扭揽角度 span ±500(-471~655), 是累积解缆位置非地理0-360方位; 对风须用机舱中轴线与风向夹角(±180), 勿拿累积角当bearing算对中"
  - "死列: 主轴后轴承温度 fleet全8台=0; 齿轮箱HSS_GSGS/GSRS/RS端/中速轴IMS_GSRS/散热器/左右扭力臂 等 T51全零(水冷/塔底族大批死); 契约只映活信号, 未映列gate透传"
  - "无测风塔: 风速全系机舱风速计(风速/机械式/超声波/核控估计均self_ref) → 绝对功率曲线/Cp/达成率 INSUFFICIENT; 用担保曲线+相对机群"
  - "1129/ 下2个1s窄列层(202411290001.csv 桨叶角度2×3+转速; 乌梅山2期数据.csv 偏航/有功1s/转速/风向/风速) 窗2024-10-20起 ≠本窗(5-7月) → 本轮不契约化(survey.data_layers认领, 需独立契约+窗)"
  - "盘上另有 w大唐乌梅山风场(519M集线zip) = 不同盘条目, 非本src(收资数据/), 未纳入 (disk_manifest.n_files=10 仅本src)"