Command line interface
Last updated
Last updated
Lead-DBS can now also be accessed from the command-line in the standalone version.
To run lead, open a terminal in the application folder of the standalone release and run the run_lead.sh script specifying the path to Matlab Runtime (currently v96). For example, in Mac:
It is also possible to execute a process without the lead GUI by specifying further options. For example, in order to run coregistration and normalization using the Segment algorithm:
Where path/to/patient/dir is the directory of the patient. Multiple patients can be processed by entering all their directories.
Command line options are defined the same way as the handles name in the GUI. It is possible to query them opening the lead_dbs.fig in GUIDE and clicking the desired component. A non extensive list of options is also listed in the Command line options page.
Using the -process option the basic Lead-DBS pipeline is executed: coregistration, normalization, brain shift correction and electrode reconstruction (PaCER). For example:
When using the -process option it is also possible to specify BIDS subject directory(s). In this case the subject images will be processed in a derivates (Lead_DBS-like) folder. If a BIDS root directory is set, then all of its subjects will be processed.
Exported jobs created with the Export Code button can be run from the command line using the execute command and specifying the file location:
It's important to remark that the file is in .json format. This option must be set in the exporting code dialog:
Finally, it is also possible to edit this .json file with a text editor and run the desired processes (without the need to specify every option as in the previous section).
