The Dakota executable file is named
dakota.exe on Windows). If this command is entered at the command
prompt without any arguments, a usage message similar to the following appears:
usage: dakota [options and <args>] -help (Print this summary) -version (Print DAKOTA version number) -input <$val> (REQUIRED DAKOTA input file $val) -preproc [$val] (Pre-process input file with pyprepro or tool $val) -output <$val> (Redirect DAKOTA standard output to file $val) -error <$val> (Redirect DAKOTA standard error to file $val) -parser <$val> (Parsing technology: nidr[strict][:dumpfile]) -no_input_echo (Do not echo DAKOTA input file) -check (Perform input checks) -pre_run [$val] (Perform pre-run (variables generation) phase) -run [$val] (Perform run (model evaluation) phase) -post_run [$val] (Perform post-run (final results) phase) -read_restart [$val] (Read an existing DAKOTA restart file $val) -stop_restart <$val> (Stop restart file processing at restart record $val) -write_restart [$val] (Write a new DAKOTA restart file $val)
Of these available command line inputs, only the
-input option is required, and
-input can be omitted if the input file name is the final item on the command line; all other command-line inputs are optional.
-helpoption prints the usage message above.
-versionoption prints the version number of the executable.
-checkoption invokes a dry-run mode in which the input file is processed and checked for errors, but the study is not performed.
-inputoption provides the name of the Dakota input file, which can optionally be pre-processed as a template using the
-erroroptions provide file names for redirection of the Dakota standard output (stdout) and standard error (stderr), respectively. By default, Dakota will echo the input file to the output stream, but
-no input echocan override this behavior.
-parserinput is for debugging and will not be further described here.
-write restartoptions provide the names of restart databases to read from and write to, respectively.
-stop restartoption limits the number of function evaluations read from the restart database (the default is all the evaluations) for those cases in which some evaluations were erroneous or corrupted.
Restart management is an important (but advanced) technique for retaining data from expensive engineering applications.
Note that these command line options can be abbreviated so long as the abbreviation is unique. Accordingly, the
following are valid, unambiguous specifications:
-po and can be used in place of the longer forms of the command line options.