DUMP
This command produces an output file from a Mesh
Object. Some of the standard graphics packages supported are AVS, GMV and TECPLOT. If the option is LaGriT,
a restart dump is made; a subsequent read/LaGriT command will
restart the code at the state at which the dump command was issued. The default file type is binary. To create an ASCII formatted
gmv dump precede the dump command with this command:
cmo/setatt/dumptype=ascii/
or include 'ascii' in the command.
NOTE: For LaGriT versions dated after October
1999, use cmo/setatt//ipolydat/no to
prevent polygon data to be written to GMV files.
FORMAT:
dump/file_type/file_name/[cmo_name]/
valid file_types are: coord, zone,
gmv, avs, avs2, tecplot, geofest, chad, fehm, stor, datex ,stl, x3d, geom, elem_adj_node, elem_adj_elem and LaGriT
dump / coord /file_name/[cmo_name]/
Will output a file with node list x,y,z values and
element connectivity list in FEHM format.
dump / zone /file_name/[cmo_name]/[delatt|keepatt|keepatt_area]
Output a set of 4 files (for additional output options see: pset/zone command).
file_name_material.zone is node list
for each material (imt) value.
file_name_outside.zone
is a node list for each of 6 (top , bottom, left, right, front, back)
possible external boundaries for rectangular geometries. If keepatt
is specified, then 6 node based attributes are added to the mesh
object. If delatt is specified mesh object is not modified.
The attribute names are top, bottom, left_w, right_e,
back_n, front_s.
Note that a node can belong to more
than 1 list. For example in an orthogonal cube aligned with the coordinate
axes, a corner node can belong to 3 lists (e.g. front_s, top and left_w
lists). If the keyword keepatt_area is specified, three node attributes (xn_area, yn_area, zn_area) are added and they contain the vector area associated with external triangles of a tetrahedaral mesh. These area vectors are computed by computing the median mesh (triangle centroids connected to triangle edge centers) and summing the area vectors of median mesh components incident upon each external node.
file_name_outside.area
is a list of the outside area associated with each node in the file_name_outside.zone
list. Areas are vector areas such that the magnitude of the
vector is the scalar area associated with the node and the direction
of the vector is the area weighted normal vector of the node.
file_name_multi_mat.zone
is a list of list of nodes for each material that are connected by
an edge to a node of a different material. Each list consists of a header
followed by list entries. The header consists of the material number
followed by "multi-material connections" on the same line, followed by
"nnum" on the next line, followed by the number of entries in the list.
(The notation nnum is a holdback from the earlier version of this command,
and really should be nedges.) The list entries consist of two nodes.
The first node is the one inside the material in question, the second
is the node in the other material. The lists are sorted by the first node,
but are not sorted by the second. Each list entry is on its own separate
line, and the nodes in each entry are separated by a comma.
file_name_outside.area is
a list of 2D areas associated with each node.
dump / zone_imt /file_name/[cmo_name]
/[imt_value]Will output only one file:
file_name_material.zone
is node list for each integer material (imt) value. If the optional fifth argument is specified as an integer, then a node list file is written only listing the nodes with the value specified by imt_value.
dump / zone_outside | zone_outside_minmax /
file_name/[cmo_name] / [delatt|keepatt|keepatt_area]
Will output only two files:
file_name_outside.zone
is a node list for each of 6 possible external boundaries.
file_name_outside.area is
a list of 2D areas associated with each node.
zone_outside_minmax will identify only the min and max outside node along each
direction of the regular grid.
Click for image showing outside nodes.
dump / avs /file_name/[cmo_name]
/ iopt_points / iopt_elements / iopt_node_attributes/iopt_element_attributes
Output in AVS UCD (Unstructured Cell Data) format.
One can turn on or off the output of node coordinates (iopt_points),
element connectivity (iopt_elements), node attributes (iopt_node_attributes)
and element attributes (iopt_element_attributes). 1 (default) is
on, 2 is on but the first column will not include the node number or element number, 0 turns off output of that part of the file. Use the =2 option with caution since the output will really not be AVS format files. This is fine as long as you do not expect read/avs or the AVS graphics program to read the file..
For file format specification see http://help.avs.com/Express/doc/help/reference/dvmac/UCD_Form.htm
dump / avs2 / file_name/[cmo_name]/[iopt_points]/iopt_elements]/[iopt_node_attributes]/[iopt_element_attributes]
This option will output integers as integers instead of floating point. The other avs option converts
integers to reals on output. The /avs/ option above outputs all attributes
as real numbers. This option is slower but the files are smaller if
there are integers in the node or element attributes.
dump / stl /file_name/[cmo_name]/
Output in STL, stereo lithography format. This is only supported for triangle mesh objects.
dump/geom/file
will write an ascii file containing the geometry
information for the current run. This information includes the region and
mregion definitions and surface, names, types and definitions.
dump/LaGriT/file_name/[cmo_name]/
[ascii | binary]
will write an restart file that contains geometry
and mesh object information. cmo_name can be '-all-'
in which case all mesh objects are written to the file or it can
specify a list of mesh objects to be written. The default
is ascii.
dump/recolor/file_name
This command writes the existing colormap
to the specified file. (See colormap
command)
dump/elem_adj_node/file_name/mo_name
Write adjacency information to an ascii file. Write
list of all elements adjacent to each node.
File format:
node_number number_of_adjacent_elem e1 e2 ... en
dump/elem_adj_elem/
file_name/mo_name [delatt | keepatt | attonly]
Option: delatt - Write adjacency information to an ascii file. Write
list of all elements adjacent to each element.
File format:
elem_number ean_num e1 e2 ... en
Option: keepatt - write file and add node attribute ean_num (number of elements adjacent to each node)
Option: attonly - do not write file, add node attribute ean_num, a dummy argument is still required in the file_name field
dump/gmv/file-name/[mesh-object]/[ascii
| binary]
Write a file to be read by the graphics program GMV.
The defaults are binary and current mesh object.
dump/stor/file-name/[mesh-object]/[scalar|vector|both|area_scalar|area_vector|area_both]/[delatt,keepatt|keepatt_area]Same syntax as dump/fehm except the only output is the FEHM sparse matrix coefficient file (file-name.stor).
dump/fehm/file_name/[cmo_name[scalar|vector|both|area_scalar|area_vector|area_both]/[delatt,keepatt|keepatt_area]
Write out a series of files for the FEHM flow and transport code. The
file_name is the file root name for:
file_name.fehm ( see dump/cord/... command)
file_name_material.zone ( see dump/zone_imt/... command)
file_name_outside.zone (see dump/zone_outside/... command)
file_name_outside.area (see dump/zone_outside/... command)
file_name_interface.zone ( output of FEHM zone format files of nodes
along an interface )
file_name-multi_mat.zone ( output of FEHM zone format files of multi-material
connections )
file_name.stor ( output of FEHM format file with geometric coefficient
matrix, these are the Voronoi (control volume) area and volume associated
with each node and the sparce matrix structure.
dump/geofest/file-name/[mesh-object]
Write a file to be read by the GeoFEST, Geophysical
Finite Element Simulation Tool . The output file is ascii.
dump/tecplot/file-name/[mesh-object]
Write a file to be read by the Tecplot graphics package. The output file is ascii. Only node attributes are output, element attributes are ignored and not output. Tecplot does not support prism or pyrimide element types so they are written as eight node, degenerate hex elements. The ioflag parameter is used to control if the node attributes are output or not is the AVS ioflag. The expected suffix for the file name is '.plt'. If a name is given without the .plt suffix, a suffix, .plt is added. Output is ascii. This output format does not support output of a mesh with nodes but zero elements. If there are zero elements, a header is written but node coordinate information is not output.
EXAMPLE:
dump / gmv /file_name.gmv/cmo_name/
dump / gmv /file_name.gmv/cmo_name/ascii
dump / tecplot /file_name.plt/cmo_name
dump / LaGriT /file_name.lg/-all-/binary
dump / avs /file_name.inp/cmo_name
dump / avs /file_name.inp/cmo_name/1 0 0 0 (output only node coordinates)
dump / avs /file_name.inp/cmo_name/1 1 0 0 (output node coordinates
and element connectivity)
dump / avs2 /file_name.inp/cmo_name/1 1 1 0 (output node coordinates,
element connectivity and node attributes)
dump / avs /file_name.inp/cmo_name/0 0 0 1 (output element attributes)
dump / avs /file_name.inp/cmo_name/0 0 2 2 (output node and element attributes without node numbers as first column of output)
dump / stor /file_name/cmo_name/asciic / / alternate_scalar
dump / zone_outside /file_name/cmo_name/keepatt_area
dump / stor /file_name/cmo_name/ascii/area_scalar
dump / zone_outside_minmax /file_name/cmo_name
Click
here for demos