Delphos — Command-Line Usage

Delphos can be launched without a graphical interface via AnyWave.exe --run ..., to integrate it into a script/pipeline. This document gives ready-to-use command examples — see Delphos_GUI.md for the details of the settings themselves.

Basic syntax

AnyWave.exe --run Delphos --input_file <file> [common options] [Delphos parameters]

--run accepts either a plugin name directly (Delphos), a path to a JSON file, or a JSON string — see §4.

Common options useful with Delphos

Option	Role
--input_file <path>	Data file to analyze (required)
--output_dir <dir>	Folder to write the resulting .mrk file to (default: the input file's folder)
--output_file <name>.mrk	Output file name (default: <file_name>_delphos.mrk)
--marker_file <path>	.mrk file to load if different from the file's default sidecar
--use_markers <label1,label2,...>	Only analyze the portions covered by these markers
--skip_markers <label1,label2,...>	Exclude the portions covered by these markers
--pick_channels <chan1,chan2,...>	Restrict the analysis to these channels
--create_montage <bipolar_ieeg\|monopolar\|none>	Build a montage automatically before analysis
--hp <Hz> / --lp <Hz> / --notch <Hz>	Filters applied before detection

Without --use_markers/--skip_markers and no markers in the file, Delphos analyzes the entire recording.

Delphos-specific parameters

Option	Type	Default
--vanish <n>	integer	20
--voices <n>	integer	12
--threshold <n>	number	40
--osc_width_t <n>	number	1.4
--osc_freq_spread_t <n>	number	12
--spk_width_t <n>	number	1.3
--spk_freq_spread_t <n>	number	11
--osc_min_freq <n>	number (Hz)	8
--osc_max_freq <n>	number (Hz)	~ sampling rate / 4
--detect_spk	presence = enabled	enabled if neither --detect_* flag is passed
--detect_osc	presence = enabled	disabled

--detect_spk/--detect_osc are plain flags: their mere presence on the command line enables them, no value needed (--detect_spk, not --detect_spk true).

Examples

Spike detection on the whole file, default settings:

AnyWave.exe --run Delphos --input_file C:\data\patient01.edf

→ writes patient01_delphos.mrk into patient01.edf's folder.

Spikes + oscillations (ripples/fast ripples), output to a dedicated folder:

AnyWave.exe --run Delphos --input_file C:\data\patient01.edf --output_dir C:\data\results --output_file patient01_hfo.mrk --detect_spk --detect_osc --osc_min_freq 80 --osc_max_freq 500

Restrict the analysis to specific channels and a marked portion:

AnyWave.exe --run Delphos --input_file C:\data\patient01.edf --pick_channels "A1,A2,B3" --use_markers "SEEG_run1" --detect_spk

Custom detection parameters:

AnyWave.exe --run Delphos --input_file C:\data\patient01.edf --detect_spk --vanish 15 --voices 16 --threshold 35 --spk_width_t 1.2 --spk_freq_spread_t 9

Via a JSON configuration file

For a more readable or reusable command, group all settings in a JSON file and pass its path to --run:

delphos_patient01.json:

{
  "plugin": "Delphos",
  "input_file": "C:/data/patient01.edf",
  "output_dir": "C:/data/results",
  "output_file": "patient01_hfo.mrk",
  "detect_spk": true,
  "detect_osc": true,
  "osc_min_freq": 80,
  "osc_max_freq": 500,
  "vanish": 20,
  "voices": 12,
  "threshold": 40
}

AnyWave.exe --run delphos_patient01.json

Output

The produced .mrk file contains one marker per detected event (same names/colors as the graphical mode — Spike, Ripple, Fast Ripple, etc., see Delphos_GUI.md), each attached to its originating channel. The input file's original .mrk file (if any) is never modified — a new file is always written separately.