Command-line usage¶
You can invoke the primary workflow of phys2bids
from the command line.
The phys2bids
command¶
usage: phys2bids [-h] -in FILENAME [-info] [-indir INDIR] [-outdir OUTDIR]
[-heur HEUR_FILE] [-sub SUB] [-ses SES] [-chtrig CHTRIG]
[-chsel [CHSEL [CHSEL ...]]] [-ntp NUM_TIMEPOINTS_EXPECTED]
[-tr TR] [-thr THR] [-chnames [CH_NAME [CH_NAME ...]]]
[-chplot CHPLOT] [-debug] [-quiet] [-v]
Required Argument:¶
- -in, --input-file
The name of the file containing physiological data, with or without extension.
Named Arguments¶
- -info, --info
Only output info about the file, don’t process. Default is to process.
Default: False
- -indir, --input-dir
Folder containing input. Default is current folder.
Default: “.”
- -outdir, --output-dir
Folder where output should be placed. Default is current folder. If “-heur” is used, it’ll become the site folder. Requires “-sub”. Optional to specify “-ses”.
Default: “.”
- -heur, --heuristic
File containing heuristic, with or without extension. This file is needed in order to convert your input file to BIDS format! If no path is specified, it assumes the file is in the current folder. Edit the heur_ex.py file in heuristics folder.
- -sub, --subject
Specify alongside “-heur”. Code of subject to process.
- -ses, --session
Specify alongside “-heur”. Code of session to process.
- -chtrig, --channel-trigger
The column number of the trigger channel. Channel numbering starts with 0. Default is 0.
Default: 0
- -chsel, --channel-selection
The column numbers of the channels to process. Default is to process all channels.
- -ntp, --numtps
Number of expected timepoints (TRs). Default is 0. Note: the estimation of when the neuroimaging acquisition started cannot take place with this default.
Default: 0
- -tr, --tr
TR of sequence in seconds. Default is 0 second.
Default: 0
- -thr, --threshold
Threshold to use for trigger detection. If “ntp” and “TR” are specified, phys2bids automatically computes a threshold to detect the triggers. Use this parameter to set it manually
- -chnames, --channel-names
Column header (for json file output).
Default: []
- -chplot, --channels-plot
full path to store channels plot
Default: “”
- -debug, --debug
Only print debugging info to log file. Default is False.
Default: False
- -quiet, --quiet
Only print warnings to log file. Default is False.
Default: False
- -v, --version
show program’s version number and exit