check_bearing_faults
Check bearing fault frequencies in a stored signal's envelope spectrum using catalog lookup, explicit frequencies, or user-provided geometry to identify fault types.
Instructions
Check expected fault frequencies in a stored signal's envelope spectrum.
THE unified bearing-check tool: catalog lookup, explicit
frequencies, or explicit geometry in one call. Requires the signal
loaded via load_signal() first.
Expected-frequency routes (exactly ONE required):
- bearing_id: catalog lookup (verified entries only) — BPFO/BPFI/BSF/
FTF computed from the catalog geometry; the entry's source citation
is echoed in the result.
- frequencies: explicit {label: hz} dict — for bearings not in the
catalog or non-bearing checks such as a gearbox GMF
(e.g. {"GMF": 350.0}). Labels BPFO/BPFI/BSF/FTF map to the
canonical fault vocabulary; other labels have no canonical form.
- explicit geometry: num_balls + ball_diameter_mm + pitch_diameter_mm
(+ contact_angle_deg) — frequencies computed from user-provided
geometry (out-of-catalog path).
Each check reports fault_type_canonical (outer_race / inner_race /
ball / cage) alongside the acronym.
Args:
ctx: MCP context. Unused — see this module's docstring on logging.
signal_id: ID of the stored signal.
rpm: Shaft speed in RPM.
bearing_id: Bearing designation (e.g. '6205', 'SKF 6205-2RS').
frequencies: Explicit expected frequencies {label: hz}, all > 0.
num_balls: Number of rolling elements (explicit-geometry route).
ball_diameter_mm: Ball/roller diameter Bd in mm.
pitch_diameter_mm: Pitch circle diameter Pd in mm.
contact_angle_deg: Contact angle in degrees (default 0.0).
tolerance_pct: Frequency matching tolerance in percent (default 5).
Returns:
BearingFaultsSummary with one check per expected frequency,
overall assessment, most likely fault (+ canonical form), and the
provenance of the expected frequencies (`source`).
Raises:
ValueError: If the signal is not loaded / has no sampling rate, if
not exactly one route is given, if the geometry is incomplete,
if the bearing is not in the catalog, or if frequencies is
empty / non-positive.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rpm | Yes | ||
| num_balls | No | ||
| signal_id | Yes | ||
| bearing_id | No | ||
| frequencies | No | ||
| tolerance_pct | No | ||
| ball_diameter_mm | No | ||
| contact_angle_deg | No | ||
| pitch_diameter_mm | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rpm | Yes | Shaft speed (RPM) | |
| source | No | Provenance of the expected frequencies: the catalog entry's source citation (bearing_id route), or a note for user-provided geometry/frequencies | |
| signal_id | Yes | Signal identifier used | |
| bearing_id | No | Bearing designation (catalog route); None for the explicit-frequencies and explicit-geometry routes | |
| fault_checks | Yes | Results for each checked frequency | |
| most_likely_fault | No | Most likely fault label if any | |
| overall_assessment | Yes | Summary assessment text | |
| shaft_frequency_hz | Yes | Shaft frequency (Hz) | |
| bearing_frequencies | Yes | Expected frequencies checked (Hz), plus shaft_freq_hz | |
| most_likely_fault_canonical | No | Canonical form of most_likely_fault (None for arbitrary labels) |