---
description: >
  Signal loading, generation, and cache management using the
  predictive-maintenance-mcp server. Use this skill when the user says "load
  signal", "import signal", "list signals", "available signals", "generate test
  signal", "create test data", "synthetic signal", "clear cache", "signal info",
  "what signals are loaded", "show signals", "signal formats", or needs help
  managing vibration signal files and the in-memory signal repository.
---

# 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. 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`

**Batch loading** (e.g. for model training) — pass a list; the batch is
atomic and fail-fast (one error names the bad entries, nothing is loaded):

Call `load_signal(filepath=["real_train/baseline_1.csv", "real_train/baseline_2.csv"], signal_unit="g")`

### Inspect Signal Metadata

Call `get_signal_info(signal_id="real_train_baseline_1")` — sampling rate,
duration, sample count, declared unit, and the full companion metadata
(source_metadata: rpm, reference frequencies, ...) without loading the array
into the conversation.

### Generate Test Signals

Call `generate_test_signal(signal_type="bearing_fault", duration=10.0, sampling_rate=10000, random_seed=42)`.

Parameters:
- **signal_type**: `"bearing_fault"` (10 Hz impacts on a 1 kHz carrier),
  `"gear_fault"` (200 Hz mesh tone + harmonics), `"imbalance"` (25 Hz tone,
  1500 RPM), or `"normal"` (broadband noise)
- **duration**: seconds (default 10.0)
- **sampling_rate**: Hz (default 10000)
- **noise_level**: additive white-noise amplitude (default 0.1)
- **random_seed**: set for reproducible signals

The tool writes a timestamped CSV plus companion metadata (sampling rate and
unit "g"), auto-registers it, and returns the StoredSignalInfo — the returned
signal_id is immediately analyzable and ISO-assessable with no manual steps.

This is useful for:
- Demonstrating the diagnostic workflow without real sensor data
- Testing skills and reports with known fault signatures
- Training users on vibration analysis

### Clear Signals

- `clear_signals(signal_id="real_train_baseline_1")` — remove one signal
- `clear_signals()` — clear the whole in-memory cache

### Visualize a Signal

Call `plot_signal(signal_id="real_train_baseline_1")` to generate an
interactive HTML time-domain plot of the raw waveform.

## Workflow for New Users

1. `list_signals(scope="disk")` to see available data files
2. `load_signal(filepath="<file>", signal_unit="g")` — declare the unit if known
3. `get_signal_info(signal_id="<id>")` to verify it loaded correctly
4. `plot_signal(signal_id="<id>")` for a quick visual check
5. Proceed with analysis (quick-screening, bearing-diagnosis, ...)

If no data files are available, generate a test signal:
1. `generate_test_signal(signal_type="bearing_fault", random_seed=42)`
2. Analyze the signal_id returned in the result

## Important Notes

- Signals are cached in memory; they persist for the session but not across
  server restarts (re-load after a restart)
- CSV files: the first numeric column is used
- Always confirm sampling_rate and signal_unit for formats that do not embed
  them — ask the user, never guess
- All signal data stays local — nothing is transmitted externally
- Signal management prepares data for analysis that supports — and never
  replaces — the engineer's judgment