Guide/NOESISReader/Output
Command line
noesisreader-cli runs every analysis and export without the GUI — ideal for batch processing and scripted pipelines.
noesisreader-cli [options] COMMAND SESSION [arguments]
General commands#
| Command | Result |
|---|
inspect SESSION | Every stream with class, samples, rate, range, units, timing uncertainty, quality warnings and events. |
analyze SESSION | Computes derived streams and runs every event detector. |
visualizers SESSION | Availability of every visualizer, with its provenance label and missing inputs. |
stats SESSION | Range statistics (use --from / --to). |
xcorr SESSION A[:ch] B[:ch] | Cross-correlation, lag, Pearson and Spearman between two channels. |
epochs SESSION EVENTS STREAM[:ch] | Impulse-response averaging around events (--pre, --post, --kind). |
export-csv SESSION OUT STREAM… | CSV export of streams. |
export-json SESSION OUT STREAM… | JSON export with provenance. |
export-wav SESSION OUT | WAV export of the microphone. |
report SESSION OUT.md | Markdown analysis report (with RF / Synthesis sections). |
compatible SESSION STREAM | Every visualizer: compatible with the stream, or why not. |
RF / SDR#
| Command | Result |
|---|
rf-info SESSION | SDR metadata, coverage, sweeps, resolution, IQ availability. |
rf-sweeps SESSION | Sweep table: timing, windows received / planned, missing, duplicates. |
rf-quality SESSION | RF and IQ data-quality report. |
rf-export SESSION OUT | --mode spectrum|range|occupancy|waterfall, --fmin/--fmax, --sweep N or --at s. |
rf-band SESSION FMIN FMAX | Band timeline (--metric integrated|max|mean|noise_floor|occupancy|peak_count, --out CSV). |
rf-peaks SESSION | Peak / carrier tracks (--threshold dB, --fmin/--fmax, --out CSV). |
iq-export SESSION OUT | Raw IQ snippet (--snippet N; OUT .cf32 or .csv). |
Frequencies accept suffixes: 433.92M, 1.2G, 500k.
Synthesis#
| Command | Result |
|---|
synthesis-info SESSION | Manifest, modalities, features and lineage summary. |
synthesis-quality SESSION | Quality and missingness report. |
synthesis-export SESSION OUT | OUT.json = manifest; OUT.csv = matrix (--mode feature-time|feature-feature|modality|rf-feature, --norm raw|zscore|minmax|common, --metric pearson|spearman|lagged|coherence|coincidence). |
Options#
| Option | Meaning |
|---|
--json | JSON output. |
--from <s> / --to <s> | Range start / end in seconds. |
--pre <s> / --post <s> | Epoch window before / after each event. |
--kind <kind> | Event-kind filter. |
--no-derived | Skip derived streams and detectors. |
--fmin, --fmax, --sweep, --at, --metric, --threshold, --margin, --mode, --norm, --out, --snippet, --columns | RF and Synthesis command options (above). |
Examples#
noesisreader-cli inspect sessions/session-ID
noesisreader-cli xcorr sessions/session-ID audio.microphone "tel:iio:accel_3d:iio:device0/accelerometer:2" --from 4 --to 6
noesisreader-cli epochs sessions/session-ID events.stimulus audio.microphone --pre 0.2 --post 0.8
noesisreader-cli report sessions/session-ID report.md
noesisreader-cli rf-band sessions/session-ID 433.05M 434.79M --metric occupancy --out ism433.csv
noesisreader-cli synthesis-export sessions/session-ID matrix.csv --mode feature-time --norm zscore
Synthetic sessions#
noesis-fixture-gen writes labelled synthetic sessions for practice and testing:
noesis-fixture-gen all OUTPUT_DIR
Fixtures: timing, missing, trials, rf, rf-focus, rf-malformed, rf-future, rf-large (all = every fixture except rf-large).
