generate_diagnostic_report
Runs full vibration diagnosis and produces a self-contained report with ISO severity, spectral analysis, anomaly state, and recommended actions.
Instructions
Generate the integrated diagnostic report — one document, whole case.
Runs the full diagnosis, then renders signal overview, ISO severity,
anomaly state, characteristic-frequency matching, spectral energy, an
annotated envelope spectrum, and recommended actions into a single
self-contained document.
AUTHORSHIP CONTRACT — this matters more than it may appear. Every
evaluative sentence in the returned ``statements`` list was written by
this server. Reuse them verbatim when presenting the result. Do NOT coin
standard names, machine classes, severity zones, or confidence levels of
your own: this server deliberately publishes no confidence figure, and
the standards caveat that travels with every severity verdict must not be
dropped or paraphrased. If a question is not answered by these
statements, say so rather than filling the gap.
Unlike ``generate_diagnostic_report_docx``, this tool takes no content
sections from the caller. Supply the analysis inputs; the wording is the
server's.
Args:
signal_id: ID of the stored signal (from load_signal).
rpm: Machine operating speed in RPM.
bearing_id: Bearing designation for characteristic-frequency
matching. Omitted means the matching section states why it was
not attempted rather than disappearing.
machine_group: ISO 20816-3 group — 1 (large, >300 kW) or 2 (medium,
15-300 kW). Default 2.
support_type: 'rigid' or 'flexible'. Default 'rigid'.
baseline_signal_id: Optional stored signal from the same machine in a
known-good state. Supplying it turns absolute readings into
deltas, which is what tells a reader whether a condition is new
or stable.
formats: Renderings to produce — any of 'html', 'pdf'. Defaults to
['html']. 'pdf' requires
``pip install predictive-maintenance-mcp[pdf]``.
ctx: MCP context. Unused — see this module's docstring on logging.
Returns:
Dict with ``statements`` (every authored sentence, in document
order), ``files`` (one entry per rendering), ``verdict``,
``evidence_strength``, and ``provenance``.
Raises:
ValueError: If a signal id is not loaded, has no sampling rate, or an
unsupported format is requested.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rpm | Yes | ||
| formats | No | ||
| signal_id | Yes | ||
| bearing_id | No | ||
| support_type | No | rigid | |
| machine_group | No | ||
| baseline_signal_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||