3.7 Listing Information
The list commands print information about the current model and session. There are five general areas: Model Summary, Geometry, Mesh, Special Entities, and Cubit Environment. The descriptions of these areas includes example output based on the model generated by a journal file listed below. The model consists of a 1x2x3 brick meshed with element size 0.1.
Journal File Used for List Examples
brick x 1 y 2 z 3 |
3.7.1 List Model Summary
List Model
List Totals
Cubit> list model |
|
Model Entity Totals: |
|
Journaled Command: list model |
3.7.2 List Geometry
The following commands list information about the geometry of the model.
List Names [Group|Body|Volume|Surface|Curve|Vertex|All]
List {Group|Body|Volume|Surface|Curve|Vertex} <range> [Ids]
List {geom_list} [Geometry|Mesh [Detail]]
List {Group|Body|Volume|Surface|Curve|Vertex} <range> {X|Y|Z}
The first command lists the names in use, and the entity type and id corresponding to each name. Specifying all lists names for all types; other options list names for a specific entity type. The names for an individual entity can be obtained by listing just that entity. Sample output from the list names surface command is shown below. This output shows that, for example, Surface 2 has the name ’BackSurface’.
______Name______ __Type__ Id _Propagated_ |
3.7.2.1 List Names Example
The second command provides information on the number of entities in the model and their identification numbers. If a range is given then detailed information is given on each entity in that range, unless the ids option is also given. If the ids option is used, just a list of ids is printed. This list can be very useful for large models in which several geometry decomposition operations have performed. Sample output from the list surface command is shown below.
Cubit> list surface ids |
|
Cubit> list surf ids |
3.7.2.2 List Surface [range] Ids’ Examples
The <range> can be very general using the general entity parsing syntax. Using a <range> gives a brief synopsis of the local connectivity of the model, e.g. one can list the ids of the surfaces containing vertex 2; as shown in the listing below.. An intermediately detailed synopsis can be obtained by placing the range of entities in a group, then listing the group.
Cubit> list surface in vertex 2 ids |
|
Cubit> group "v2_surfs" equals surface in vertex 2 |
3.7.2.3 Using ’List’ for Querying Connectivity.
The third command provides detailed information for each of the specific entities. This information includes the entity’s name and id, its meshing scheme and how that scheme was selected, whether it is meshed and other meshing parameters such as smooth scheme, interval size and count. The entity’s connectivity is summarized by a table of the entity’s subentities and a list of the entity’s superentities. Also, the nodesets, sidesets, blocks, and groups containing the entity are listed.
Specifying geometry will additionally list the extent of the entity’s geometric bounding box, the geometric size of the entity, and depending on entity type, other information such as surface normal. See also the list {entities} x command below. If multiple volumes, surfaces, or curves are selected, it will list the total volume, area, or length of all entities, and the total geometric bounding box. If multiple volumes are selected, the centroid listed will be the composite centroid of the all of the volumes.
Specifying mesh will additionally list the number of mesh entities of each type interior to the entity and on bounding subentities. mesh detail will list the ids of the mesh entities as well, following the format of the list ids command above.
The fourth command lists the entities sorted by either the x, y, or z coordinate of their geometric center. For example, in a large, basically cylindrical model centered around z-axis, it is useful to list the surfaces of a volume sorted by z to identify the source and target sweeping surfaces.
3.7.3 List Mesh
List {Hex|Face|Edge|Node} <id_range>
List {Hex|Face|Edge|Node} <id_range> IDs
3.7.4 List Special Entities
List {special_type} <range>
(Some special entities are of interest mainly to developers and are not described here, e.g. whisker sheets, and whisker hexes.)
3.7.5 List Cubit Environment
The user may list information about the current Cubit environment such as message output settings, memory usage, and graphics settings.
3.7.5.1 Message Output Settings
There are several major categories of Cubit 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 Cubit.
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
[Set] Logging {Off|On File <’filename’> [Resume]}
List Logging
List Journal Title "<title_string>"
List Title
List Default Block
Set Default Block {ON|off}
List Settings
3.7.5.2 Sample output
Cubit> 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. |
3.7.5.3 Graphical Display Information
List View
3.7.5.4 Memory Usage Information
List Memory [‘<object type>’]