Cube-it 16.3 User Documentation
To run Cube-it from the command line:
Cube-it [options and args] [journalFile(s)|python historyFile(s)]
Command options for the command line are:
Cube-it
-help (Print this summary)
-Include <$val> (Specify a journal file)
-input $val (Playback commands in file $val)
-solidmodel <$val> (Read .sat or .cub from file $val)
-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)
-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)
-variable=<value> (Assign an aprepro variable a value)
Each of these are 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:
-help | Print a short usage summary of the command syntax to the terminal and exit. |
|
-initfile <$val> | Use the file specified by <$val> as the initialization file instead of the default set of initialization files. See Initialization Files |
|
-noinitfile | 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. |
|
-batch | Specify that there will be no interactive input in this execution of Cube-it. Cube-it will terminate after reading the initialization file, the geometry file, and the input_file_list. |
|
-nographics | Run Cube-it without graphics. This is generally used with the -batch option or when running Cube-it over a line terminal. |
|
-display | Sets the location where the Cube-it 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. |
|
-nojournal | Do not create a journal file for this execution of Cube-it . 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 Cube-it . |
|
-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. |
|
-nodeletions | Turn off the ability to delete files with the delete file '<filename>' command. |
|
-nooverwritecheck | 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 | Restore the specified filename (or "cubit_geom") mesh and ACIS files, e.g. cubit_geom.save.g and cubit_geom.save.sat. |
|
-noecho | 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 Cube-it to the console. |
|
-warning={on|off} | Turn {on|off} the printing of warning messages from Cube-it 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_file_list> | Input files to be read and executed by Cube-it . Files are processed in the order listed, and afterwards interactive command input can be entered (unless the -batch option is used.) |
|
<variable=value> | APREPRO variable-value pairs to be used in the Cube-it 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 .) |
To pass an APREPRO variable into a Cube-it Session, start Cube-it with the variable defined in quotes i.e. Cube-it "some_var=2.3"