Execution Command Syntax

To run CUBIT from the command line:

 cubit [options and args] [journalFile(s)]

 claro [options and args] [journalFile(s)|python historyFile(s)]

Claro is the GUI version of CUBIT, which includes a python interpreter. To run a python script in CUBIT from the command line, run claro instead of cubit.

Command options for the command line are:

   -help (Print this summary)
   -Include <$val> (Specify a journal file)
   -workingdir <$val> (Directory to use as working directory)
   -input $val (Playback commands in file $val)
   -solidmodel <$val> (Read .sat, .cub or .exo from file $val)
   -nogeom (Read .exo from -solidmodel $val without creating geometry)
   -lite (Read .exo from -solidmodel $val in lite mode)
   -fastq <$val> (Read FASTQ file $val)
   -initfile <$val> (Read $val as initialization file instead
    of $HOME/.cubit)
   -batch (Batch Mode - No Interactive Command Input)
   -nographics (Do not display graphics windows)
   -nogui (Do not display graphical user interface)
   -noinitfile (Do not read .cubit file)
   -noecho (Do not echo commands to console)
   -nojournal (Do not write journal file)
   -nodeletions (Do not allow file deletions)
   -journalfile <$val> (Name of journal file, will be overwritten)
   -restore [$val] (Name of restore file (default = cubit_geom.save.sat))
   -maxjournal [$val] (Maximum number of journal files to write)
   -warning [$val] (Warning Messages On/Off)
   -information [$val] (Informational Messages On/Off)
   -debug <$val> (Set specified flags on, e.g. 1,3,7-9
    enables 1,3,7,8,9))
   -display <$val> (Specify display to be used for
    graphics window)
   -driver <$val> (Specify the type of driver to be used for
    graphics display)
   -nooverwritecheck (Do not perform file export overwrite check)
   -nobanner (Suppress printing of startup information)
   -version (Prints version information)
   -log <$val> (Copy all output to specified file)
   APREPRO variable pair (Quoted name value pair)

Each of these is optional. If specified, the quantities in square brackets, [$val], are optional and the quantities in angle brackets, <$val>, are required.

Options are summarized in more detail below:


Print a short usage summary of the command syntax to the terminal and exit.


Set the working directory to be used at startup. Journal files will be written to this directory.

-initfile <$val>

Use the file specified by <$val> as the initialization file instead of the default set of initialization files. See Initialization Files


Do not read any initialization file. This overrides the default behavior described in Initialization Files

-solidmodel <$val>

Read the ACIS solid model geometry or .cub file information from the file specified by <$val> prior to prompting for interactive input.


Specify that there will be no interactive input in this execution of CUBIT. CUBIT will terminate after reading the initialization file, the geometry file, and the input_file_list.


Run CUBIT without graphics. This is generally used with the -batch option or when running CUBIT over a line terminal.


Run CUBIT without the graphical user interface.


Sets the location where the CUBIT graphics system will be displayed, analogous to the -display environment variable for the X Windows system. Unix only.

-driver <type>

Sets the <type> of graphics display driver to be used. Available drivers depend on platform, hardware, and system installation. Typical drivers include X11 and OpenGL.


Do not create a journal file for this execution of CUBIT. This option performs the same function as the Journal Off command. The default behavior is to create a new journal file for every execution of CUBIT.

-journalfile <file>

Write the journal entries to <file>. The file will be overwritten if it already exists.

-maxjournal <$val>

Only create a maximum of <$val> default journal files. Default journal files are of the form cubit#.jou where # is a number in the range 01 to 999.


Turn off the ability to delete files with the delete file '<filename>' command.


Turn off the file overwrite check flag. Files that are written may then overwrite (erase) old files with the same name with no warning. This is typically useful when re-running journal files, in order to overwrite existing output files. See the set File Overwrite Check [ON|off] command.


Restore the specified filename (or "cubit_geom") mesh and ACIS files, e.g. cubit_geom.save.g and cubit_geom.save.sat.


Do not echo commands to the console. This option performs the same function as the Echo Off command. The default behavior is to echo commands to the console.

-debug <$val>

Set to "on" the debug message flags indicated by <$val>, where <$val> is a comma-separated list of integers or ranges of integers, e.g. 1,3,8-10.

-information {on|off}

Turn {on|off} the printing of information messages from CUBIT to the console.

-warning {on|off}

Turn {on|off} the printing of warning messages from CUBIT to the console.

-Include <path>

Allows the user to specify a journal file from the command line.

-fastq <file>

Read the mesh and geometry definition data in the FASTQ file <file> and interpret the data as FASTQ commands. See T. D. Blacker, FASTQ Users Manual Version 1.2, SAND88-1326, Sandia National Laboratories, (1988). for a description of the FASTQ file format.


Input files to be read and executed by CUBIT. Files are processed in the order listed, and afterwards interactive command input can be entered (unless the -batch option is used.)

-log <file>

Copies all output to the specified file.


APREPRO variable-value pairs to be used in the CUBIT session. Values can be either doubles or character type (character values must be surrounded by double quotes.). Command options can also be specified using the CUBIT_OPT environment variable. (See Environment Variables .)

Passing Variables into a CUBIT Session

To pass an aprepro variable into a CUBIT Session, start cubit with the variable defined in quotes i.e. cubit "some_var=2.3"