Dude command-line

Information and basic commands

info

Show informations about the experiments.

list

List all expfolders.

run

Run experiments (only those that haven’t been run or that have failed).

sum

Summarize experiments that successfully ran.

failed

Show all experiments that failed (returned code different than 0).

missing

Show all experiments that haven’t been executed or have failed.

-f <FILE>, --file <FILE>

Read FILE as a Dudefile. Default FILE=Dudefile.

Filtering experiments

-y, --filter-inline

Select experiments using inline filters separated by semicolons:

dude run/list/sum -y "option1=value;option2=[value3,value4]"
-p, --filter-path

Select experiments starting with PATH:

dude run/list/sum -p raw/exp__optionXvalY
-i, --invert-filters

Invert filter selection. Example:

dude run/list/sum -i -y "option1=value;option2=[value3,value4]"

Run specific options

-o

Show experiment’s output.

--force

Force execution. For example:

dude run --force -y "option1=value;option2=[value3,value4]"
--skip-global

Skip global prepare.

--global-only

Run global prepare only.

Sum specific options

--ignore-status

Include failed experiments in the summaries.

-b, --backend

Default backend is file.

Backend to use for summary: sqlite3, json, and file.

List specific options

-d, --dict

Show output in dict format.

Advanced commands and options

run-once

Creates a folder called “once” and runs one experiment inside. The selection with -y or -x or -p is necessary such that only one experiments is selected.

Advanced filtering can be achieved with the following command-line options.

-x <filter>, --filter <filter>, --select <filter>

Select experiments using filters written in Dudefile. One can use multiple filters, for example:

dude run/list/sum -x filter1,filter2

The filter has to be implemented inside the Dudefile. (More details TBD)

-a, --args

Give arguments to Dudefile separated by semicolons:

dude run/list/sum -a "option1=value;option2=[value3,value4]"