energy-manage-platform/docs/api/fault-frequency.md

故障频率接口说明

接口

GET /AnalysisMulti/fault-frequency/resolve

Nginx 对外路径：

http://127.0.0.1:8080/AnalysisMulti/fault-frequency/resolve

算法服务直连路径：

http://127.0.0.1:8888/fault-frequency/resolve

参数

参数	必填	说明
engineCode	是	风机编号，如 WOG01344
pointName	是	波形测点英文键，如 main_bearing_radial_horizontal_vibration
rpm	否	当前转速，默认 0；发电机测点用发电机转速，主轴承/齿轮箱低速测点会按机型传动比折算
millTypeCode	否	机型编号；不传则从 wind_engine_group 查询

成功响应

{
  "code": 200,
  "supported": true,
  "engineCode": "WOG01344",
  "millTypeCode": "WEM00041",
  "componentType": "main_bearing",
  "position": "front",
  "stage": 0,
  "brand": "SKF",
  "model": "240/560CA/W33",
  "nRolls": 108,
  "rollerDiameter": 18,
  "pitchDiameter": 623.13,
  "contactAngle": 15,
  "rpm": 1500,
  "shaftRpm": 13.277,
  "speedRatio": 112.98,
  "frequencies": {
    "BPFI": 12.282,
    "BPFO": 11.616,
    "BSF": 3.827,
    "FTF": 0.108
  },
  "source": "unit_dict_brand_model",
  "confidence": 0.95,
  "missing": [],
  "warnings": ["按机型传动比折算到低速轴"]
}

齿轮箱齿轮测点额外返回：

"GMF": 22.349

参数缺失响应

{
  "code": 200,
  "supported": false,
  "componentType": null,
  "frequencies": {},
  "missing": ["pitch_diameter", "contact_angle"],
  "message": "轴承几何参数不完整，无法计算故障频率",
  "warnings": []
}

数据来源优先级

1. component_fault_spec（品牌/型号级故障参数）；
2. unit_dict_brand_model（兼容现有轴承字典）；
3. unit_bearings / unit_dynamo / unit_gearbox_structure / unit_gearbox_bearings 提供具体部件品牌型号和齿数；
4. measurement_point_component 提供测点与部件/位置映射。

峰值证据接口

GET /AnalysisMulti/fault-frequency/evidence

参数：

参数	必填	说明
windCode	是	风场编号
recordId	是	波形记录 ID
engineCode	是	风机编号
pointName	是	测点英文键
rpm	否	备用转速；优先使用波形记录中的转速
millTypeCode	否	机型编号

返回每条故障频率的：

{
  "faultType": "BPFO",
  "targetFreq": 8.63,
  "peakFreq": 8.3,
  "peak": 0.000004,
  "ratio": 5.36,
  "method": "envelope",
  "harmonics": [],
  "status": "normal|watch|alarm"
}

采样率低于 12800 Hz 返回 supported=false，不给出峰值结论。

约束

• 缺参数时返回 supported=false，不生成频率、不参与故障判定；
• 主轴承/齿轮箱低速测点按 wind_engine_mill.rotational_speed_ratio 折算，缺少传动比时按输入转速处理并在 warnings 标注；
• 齿轮箱级间转速目前按低速轴近似，后续可由各级齿数精确计算；
• 采样频率低于 12800 Hz 的波形不能用于轴承高频故障诊断。