科研 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.
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
-
Classify the question. Design check (will this resonate?) or diagnosis (why is this vibrating / what's wrong?). They use different parts of this skill.
-
Design check — SDOF/MDOF natural frequency:
python scripts/vibration.py sdof --k 2.5e6 --m 40 --c 400reports undamped natural frequencywn = sqrt(k/m), damping ratiozeta = c/(2*sqrt(k*m)), and damped frequencywd. For an MDOF lumped system,python scripts/vibration.py mdof --mass masses.csv --stiff stiffness.csvsolves the generalized eigenvalue problem(K - w^2*M) phi = 0and reports all natural frequencies and mode shapes. -
Forced response and resonance margin:
python scripts/vibration.py forced --wn 150 --zeta 0.02 --forcing-freq 148reports 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. -
Diagnosis — spectrum from a measured signal:
python scripts/vibration.py spectrum --signal accel.csv --col accel --fs 5000computes the FFT magnitude and a Welch PSD, and lists the largest peaks with frequency and amplitude. -
Match peaks to fault frequencies:
python scripts/vibration.py fault-freqs --rpm 1780 --balls 9 --pitch-dia 40 --element-dia 8 --contact-angle 0prints 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. -
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.
-
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-feaor 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
spectrumcommand, 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 --selftestchecks 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.
示例提示词
这台泵振动异常,帮我用频谱分析判断是不平衡还是轴承故障。
所属插件
安装该插件会一并获得同领域的 17 个 Skill / MCP。
同插件的其他科研 Skill
- 控制系统分析与PID设计Models, analyzes, and designs feedback control systems with python-control and scipy.signal: transfer functions, Bode plots, root locus, and PID tuning. Use for SISO control design.
- FEniCSx有限元分析Runs FEA with FEniCSx or scikit-fem: mesh generation, boundary conditions, linear elasticity, heat conduction, and result visualization. Use for custom open-source finite-element workflows.
- 测量不确定度分析Builds a GUM-style measurement uncertainty budget from Type A/B evaluation, RSS combination, and error propagation to a derived result. Use when a reported value needs a defensible plus-or-minus.
- 热流体系统研究方法指导Applies source-aware mechanical-engineering judgment to research tasks spanning thermal-fluids, turbomachinery, experiments, and writing. Use for broad mechanical-engineering research support.
- 可靠性工程分析Covers reliability engineering methods: Weibull analysis, fault tree analysis, FMEA, reliability block diagrams, and accelerated life testing. Use for failure-rate or reliability-prediction tasks.
- 工程实验数据分析设计Designs and analyzes engineering experiments or simulations with baseline cases, hypothesis-driven DOE, and uncertainty quantification. Use for CFD, lab data, or parameter-study analysis.
- 科研导师式反馈Gives constructive, evidence-based mentoring feedback on student manuscripts, proposals, code, and figures without impersonating an advisor. Use for advisor-style review of student work.
- 研究计划书撰写Develops research proposals with solicitation alignment, reviewer-focused logic, evidence-bounded preliminary results, and milestones. Use for federal, foundation, or internal research proposals.
- 科研示意图制作Creates publication-quality, editable scientific and engineering schematics with explicit physical meaning and clear labels. Use for experimental-facility diagrams, mechanisms, or graphical abstracts.
- 科研汇报幻灯片设计Designs clean, graphics-first technical presentations and posters with logical progression and visual hierarchy. Use for research talks, conference slides, or defenses.
- 科研写作与文献综述Writes and revises research narratives, literature reviews, manuscript sections, and figure discussions with proper citations. Use for drafting or revising technical manuscript text.
- 审稿人作者迭代改稿Runs an iterative manuscript-improvement loop where a reviewer agent critiques, an author agent revises, and a verifier checks each revision. Use for simulated peer review or rebuttal prep.
- ROS2机器人开发Covers ROS2 robotics development with rclpy: nodes, topics, services, actions, tf2 transforms, and Nav2 navigation. Use when building or debugging a ROS2 node or navigation stack.
- 数字信号处理Covers digital signal processing with scipy.signal: filter design, spectral analysis, peak detection, and PSD estimation. Use for vibration, biomedical, or time-series signal tasks.
- SimPy离散事件仿真Builds discrete-event simulations with SimPy: M/M/c queues, manufacturing lines, resource contention, and confidence intervals via replications. Use for queueing or throughput analysis.
- 热流体系统分析指导Analyzes thermal-fluid systems, experiments, CFD, and correlations with explicit assumptions, validity limits, and uncertainty. Use for heat transfer or thermal-management 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 左侧点击「插件」,在「组件」页签搜索「机械振动与故障诊断」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
机械振动与故障诊断需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
机械振动与故障诊断经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。