signal-management

Signal Management

Load, generate, inspect, and manage vibration signals in the predictive-maintenance-mcp in-memory repository. Supports CSV, TXT, NPY, WAV, MAT (MATLAB), and Parquet formats, plus headerless raw binary (.bin, .raw, .dat) with a declared decode contract. The signal_id returned by loading is the single handle every analysis, diagnosis, report, and prognostics tool accepts.

Prerequisite: The predictive-maintenance-mcp MCP server must be connected.

Core Operations

List Available Signals

• On disk: list_signals(scope="disk") — files under data/signals/ that load_signal can open (this is also the default scope).
• In memory: list_signals(scope="memory") — signals currently loaded, with their signal_id, sampling rate, and declared unit.

Load a Signal

Call load_signal(filepath="real_train/baseline_1.csv", signal_unit="g").

• filepath: path relative to data/signals/ or an absolute path
• signal_id (optional): custom handle. Default: the relative path with separators replaced by underscores — real_train/baseline_1.csv becomes real_train_baseline_1, so same-named files in different folders never collide silently
• sampling_rate (optional): Hz — overrides the companion metadata file. Required if no _metadata.json declares it (ask the user; never guess)
• signal_unit (optional): "g", "m/s2", "mm/s", or "m/s" — declare it if known. ISO severity verdicts are REFUSED for signals without a declared unit; units are never guessed from amplitude
• overwrite: re-loading a path whose signal_id already exists is an explicit error unless overwrite=True
• Asset identity: a companion whose measurement object declares asset_id, measurement_point_id and acquired_at (optionally rpm in rev/min, load, operating_state, sensor_id, direction, declared_by) is validated on load, and the measurement is then recorded in the local asset ledger; the returned measurement block reports ledger_status, snapshot_status and the comparability grade against the point. An invalid object is refused with every problem named; a companion without the object loads exactly as before