科研 Skill

机械振动与故障诊断

vibration-analysis

Analyzes mechanical vibration: SDOF/MDOF natural frequencies, resonance checks, and FFT-based diagnosis of rotating-machinery faults such as imbalance or bearing defects. Use for vibration diagnosis.

发布者 Codar安全审核通过v0.1.0更新于 2026-11-18

SKILL.md

Mechanical Vibration Analysis

Covers two related jobs: (1) predicting a system's natural frequencies and forced response so resonance can be designed out, and (2) diagnosing an existing vibration problem on rotating machinery (pumps, fans, motors) from measured acceleration or velocity data. Use quick-fea's --modes option instead when the system is a 3D solid part best modeled by finite elements; use this skill for lumped-parameter (SDOF/MDOF) hand analysis and for spectrum-based fault diagnosis.

Purpose

  • Compute natural frequency, damping ratio, and forced-response amplitude for simple spring-mass-damper (SDOF) and small multi-degree-of-freedom (MDOF) systems.
  • Check a rotating machine's running speed and its harmonics against natural frequencies and known structural resonances, with a stated separation margin.
  • Take a measured acceleration or velocity time series, compute its FFT/PSD, and match peaks against expected fault frequencies (1x/2x running speed, blade-pass, bearing defect frequencies, gear mesh) to point at a likely cause.
  • Report amplitude against a standard severity chart (ISO 10816 / 20816 class) where applicable, not just a bare frequency list.

Prerequisites

numpy, scipy, and matplotlib (pip install numpy scipy matplotlib). For fault diagnosis: a time-domain vibration record (acceleration or velocity, with a known sample rate) and the machine's running speed (RPM). For bearing-fault frequencies: the bearing's geometry (ball/roller count, pitch and element diameter, contact angle) or its manufacturer bearing-frequency table. This skill shares signal-processing's FFT/PSD/ filtering primitives; it adds the vibration-specific natural-frequency models and fault- frequency formulas that skill does not cover.

Workflow

  1. Classify the question. Design check (will this resonate?) or diagnosis (why is this vibrating / what's wrong?). They use different parts of this skill.

  2. Design check — SDOF/MDOF natural frequency: python scripts/vibration.py sdof --k 2.5e6 --m 40 --c 400 reports undamped natural frequency wn = sqrt(k/m), damping ratio zeta = c/(2*sqrt(k*m)), and damped frequency wd. For an MDOF lumped system, python scripts/vibration.py mdof --mass masses.csv --stiff stiffness.csv solves the generalized eigenvalue problem (K - w^2*M) phi = 0 and reports all natural frequencies and mode shapes.

  3. Forced response and resonance margin: python scripts/vibration.py forced --wn 150 --zeta 0.02 --forcing-freq 148 reports the dynamic amplification factor and flags resonance when the forcing frequency is within about 20% of a natural frequency at low damping (zeta < 0.05), which is the usual rule of thumb for rotating machinery; tighten this margin for safety-critical or very lightly damped structures.

  4. Diagnosis — spectrum from a measured signal: python scripts/vibration.py spectrum --signal accel.csv --col accel --fs 5000 computes the FFT magnitude and a Welch PSD, and lists the largest peaks with frequency and amplitude.

  5. Match peaks to fault frequencies: python scripts/vibration.py fault-freqs --rpm 1780 --balls 9 --pitch-dia 40 --element-dia 8 --contact-angle 0 prints 1x/2x/3x running speed and the four standard bearing-defect frequencies (BPFO, BPFI, BSF, FTF). Compare these against the peaks from step 4: a strong peak at 1x with harmonics usually means imbalance or misalignment (misalignment favors 2x and axial content); a peak at BPFO/BPFI with sidebands at 1x suggests a bearing defect; a peak at gear-mesh frequency (teeth x RPM) with sidebands at shaft speed suggests a gear-tooth problem.

  6. Severity check: where a standard applies (ISO 10816-3 for industrial machines on rigid/flexible foundations, or 20816 for the current edition), compare the measured RMS velocity against the zone A/B/C/D bands and report the zone, not just a raw number.

  7. Report: measured or predicted frequencies, the matched or ruled-out fault hypotheses with the evidence for each, the resonance margin (if a design check), and a recommendation (no action / monitor / balance / align / replace bearing / investigate further).

Limitations

  • SDOF/MDOF hand models assume lumped mass and linear, time-invariant stiffness and damping; they do not capture distributed-mass or nonlinear effects (use quick-fea or a full FEA tool for those).
  • Bearing-defect frequency formulas assume pure rolling without slip and a stationary outer race; real bearings show some scatter (a few percent) around the computed values, and significant slip changes them further — treat matches within about 5% as supporting evidence, not proof, and corroborate with another indicator (trend, waveform, or a second measurement) before condemning a part.
  • FFT frequency resolution is fs / N (sample rate / number of samples); low-frequency faults need either a long record or a lower sample rate, and this skill does not auto-tune the acquisition for the user — state the resolution actually achieved.
  • No automatic order-tracking for varying-speed machinery; for run-up/coast-down data, resample to a constant-angle domain before using the spectrum command, or flag that the spectrum is smeared.
  • Severity bands (ISO 10816/20816) are illustrative category boundaries; always use the current edition of the actual standard for a compliance decision, not the numbers hardcoded here.

Related skills

signal-processing (general DSP primitives this skill's FFT/PSD routines build on), quick-fea (FEA-based modal analysis for 3D solid parts), structural-analysis (pump casing/impeller fatigue from blade-passing and rotor-imbalance loads), fatigue-fracture-analysis (life estimate once a vibration amplitude and frequency are known), centrifugal-pumps / positive-displacement-pumps (source of the running-speed and blade/vane-pass frequencies used in fault matching).

Quality checks

  • python scripts/vibration.py --selftest checks the SDOF natural-frequency formula against a hand-solvable case and the fault-frequency formulas against published reference values for a standard bearing; run it after any edit to the script.
  • Every reported fault match states the percentage difference between the observed peak and the theoretical fault frequency, so the user can judge how strong the match is.
  • Natural-frequency and resonance-margin results are reported with units and the input parameters, so a reviewer can recompute them by hand.

示例提示词

这台泵振动异常,帮我用频谱分析判断是不平衡还是轴承故障。

所属插件

工程分析、控制与工程科研面向工程科研通用方法:有限元分析、控制系统设计、信号处理与振动诊断、可靠性工程、离散事件仿真、ROS2 机器人、测量不确定度,以及热流体方向的工程科研选题、数据分析、论文写作与审稿互评。

安装该插件会一并获得同领域的 17 个 Skill / MCP。

同插件的其他科研 Skill

常见问题

机械振动与故障诊断能做什么?

Analyzes mechanical vibration: SDOF/MDOF natural frequencies, resonance checks, and FFT-based diagnosis of rotating-machinery faults such as imbalance or bearing defects. Use for vibration diagnosis。

如何安装机械振动与故障诊断?

在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「机械振动与故障诊断」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。

机械振动与故障诊断需要哪些权限?

该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。

机械振动与故障诊断经过官方审核吗?

是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。