List Cube-it Environment

The user may list information about the current Cube-it environment such as message output settings, memory usage, and graphics settings.

Message Output Settings

There are several major categories of Cube-it messages.

Info (Information) messages tell the user about normal events, such as the id of a newly created body, or the completion of a meshing algorithm.
Warning messages signal unusual events that are potential problems.
Error messages signal either user error, such as syntax errors, or the failure of some operation, such as the failure to mesh a surface.
Echo messages tell the user what was journaled.
Debug messages tell developers about algorithm progress. There are many types of Debug messages, each one concentrating on a different aspect of Cube-it.

By default, Info, Warning, Error, and Echo messages are printed, and Debug messages are not printed. Information, Warning and Debug message printing can be turned on or off (or toggled) with a set command; error messages are always printed. Debugging output can be redirected to a file. Current message printing settings can be listed.

List {Echo|Info|Errors|Warning|Debug }

Set {Echo|Info|Warning} [On|Off]

[Set] Debug <index> [On|Off]

[Set] Debug <index> File <'filename'>

[Set] Debug <index> Terminal

Message flags can also be set using command line options, e.g. -warning={on|off} and -information={on|off}. Debug flags can be set on with -debug=<setting>, where <setting> is a comma-separated list of integers or ranges of integers denoting which flags to turn on. E.g. to set debug flags 1, 3, and 8 to 10 on, the syntax is -debug=1,3,8-10.

In addition to the major categories, there are some special purpose output settings.

[Set] Logging {Off|On File <'filename'> [Resume]}

List Logging

If logging is enabled, all echo, info, warning, and error messages will be output both to the terminal and to the logging file. The resume option will append to the logfile, if it exists, instead of writing over it. If the logfile doesn't already exist, it will be created.

List Journal Title "<title_string>"

The List Journal command lists which types of Cube-it commands will be journaled and the file to which the journaled commands are being written.

List Title

The List Title command will list the title to be written to the Exodus file. To assign a title to an exodus file, use the Title command.

List Default Block

Set Default Block {ON|off}

The List Default Block command lists which type of geometric entities for which blocks will automatically be generated at export if no other blocks have been specified. The Set Default Block command will toggle whether these default blocks are written, or not, during the export operation when no other blocks have been specified.

List Settings

The List Settings command lists the value of all the message flags, journal file and echo settings, as well as additional information. The first section lists a short description of each debug flag and its current setting. Next come the other message settings, followed by some flags affecting algorithm behavior.

Sample output

Cube-it> list settings
Debug Flag Settings (flag number, setting, output to, description):
 1  OFF  terminal           Debug Graphics toggle for some debug options.
 2  OFF  terminal           Whisker weaving information
 3  OFF  terminal           Timing information for 3D Meshing routines.
 4  OFF  terminal           Graphics Debugging (DrawingTool)
 5  OFF  terminal           FastQ debugging
 6  OFF  terminal           Submapping graphics debugging
 7  OFF  terminal           Knife progress whisker weaving information
 8  OFF  terminal           Mapping Face debug / Linear Programming debug
 9  OFF  terminal           Paver Debugging
.
.
.
echo              = On
info              = On
journal           = On
journal graphics  = Off
journal names     = On
journal aprepro   = On
journal file      = 'cubit11.jou'
warning           = On
logging           = Off
recording         = Off
keep invalid mesh = Off
default names     = Off
default block    = Volumes
catch interrupt   = On
name replacement character = '_', suffix character = '@'
Matching Intervals is fast, TRUE;
multiple curves will be fixed per iteration.
Note in rare cases 'slow', FALSE, may produce better meshes.
Match Intervals rounding is FALSE;
intervals will be rounded towards the user-specified intervals.

Graphical Display Information

List View

List view prints the current graphics view and mode parameters; See Graphics Window .

Memory Usage Information

Users are encouraged to use Unix commands such as `top' to check total Cube-it memory use. Developers may check internal memory usage with the following command:

List Memory [`<object type>']

Without an object type, the command prints memory use for all types of objects.