Verifier

The diagnostic verifier turns a raw BioTrace+ export into a machine-readable report and a small set of clear figures. It reports diagnostics only and makes no modeling or clinical claims.

What it does

Loads EDF/EDF+ through MNE

Reports channel names, sample rate, duration, and unit assumptions

Computes per-channel RMS and peak-to-peak

Detects EDF+ annotations and likely marker channels

Validates the four expected EEG channels using configurable aliases

Writes diagnostic.json plus PNG/SVG figures (trace, PSD, marker timeline)

Exits nonzero on

A missing expected channel

A recording that is too short

A disallowed sample rate

Missing required events

$ nexus-neuromirror verify session.edf --out reports/diagnostic

Accepted upload formats

Format	Extensions	Handling
EDF / EDF+	.edf	Analyzed with the MNE verifier → report + figures
ASCII / CSV	.csv, .txt, .asc	Cataloged only (checksum + metadata) in the MVP
MATLAB	.mat	Cataloged only (checksum + metadata) in the MVP
BCD	.bcd	Archival only — never parsed

The hosted preview caps uploads at 8 MB (NNM_MAX_UPLOAD_BYTES). A 60 s four-channel synthetic EDF is ~150 KB. For larger real recordings, use the CLI directly.

diagnostic.json

{
  "sample_rate_hz": 256,
  "duration_s": 60.0,
  "channels": ["Fz", "FCz", "Pz", "Oz"],
  "rms_uv": { "Fz": 11.4, "FCz": 9.8,
              "Pz": 14.2, "Oz": 21.6 },
  "markers": 8,
  "hard_failures": []
}

Figures

multichannel_trace.png

psd.png

marker_timeline.svg

Reports are reproducible and contain no personally identifying information.