443 lines
17 KiB
Plaintext
Executable File
443 lines
17 KiB
Plaintext
Executable File
.. _dump :
|
|
|
|
|
|
|
|
> **_DUMP_**
|
|
|
|
This command produces an output file from a Mesh Object. Some of the standard
|
|
graphics packages are supported including AVS, GMV and TECPLOT. See below for
|
|
full list of file types that can be written. The list is in alphabetic order
|
|
and describes each valid file_type with syntax and usage.
|
|
|
|
|
|
GENERAL SYNTAX:
|
|
|
|
**dump**/file_type/file_name/[cmo_name]/ The dump command is followed by a word indicating file type. Valid file type kewords are: ** gmv, avs, avs2, chad, coord, datex, elem_adj_node, elem_adj_elem, fehm, geofest, geom, gmv, gocad, lagrit, recolor, stl, stor, tecplot, zone, zone_imt, **and** zone_outside** .
|
|
The file_type is followed by a string to be used as whole or part of file name
|
|
as described below.
|
|
|
|
SHORT SYNTAX:
|
|
|
|
**dump**/ file_name.[**inp | avs | gmv | lg | lagrit | ts | exo** ] / [cmo_name]
|
|
|
|
For common file types, a short form syntax can be used which skips the file
|
|
type designation. The file_type is asssumed from the file_name suffix. The
|
|
following are recognized; AVS (.inp or .avs), Exodus (.exo), GMV (.gmv),
|
|
LaGriT (.lagrit or .lg), and .ts (gocad).
|
|
|
|
|
|
|
|
|
|
FILE TYPES:
|
|
|
|
|
|
**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. For instance, dump/avs/file.inp/cmo_name/1,1,0,0 will
|
|
write the node coordinates and element connectivity, but will not write node
|
|
attributes or element attributes.
|
|
|
|
**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/refere
|
|
nce/dvmac/UCD_Form.htm](http://help.avs.com/Express/doc/help/reference/dvmac/U
|
|
CD_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**** **/** chad **** **/file_name/[cmo_name]/
|
|
|
|
Will output a file nodes, faces, and connectivity for tet, hex, pyr, or pri in
|
|
CHAD format. Writes attributes imt and itp.
|
|
|
|
**dump**** **/** coord**** **/file_name/[cmo_name]/ (See also **dump/fehm** )
|
|
|
|
Will output a single file with node list x,y,z values and element connectivity
|
|
list in FEHM format. Files are written in FEHM format and are described [by
|
|
clicking here for details.](dump/DUMP3.html)
|
|
|
|
The ** coord ** file is one of a set of files written when the **fehm** file
|
|
type is called.
|
|
|
|
|
|
**dump**** **/** datex | simul**** **/file_name/[cmo_name]/
|
|
|
|
Will output a file with Geometry, Element, Region, Location, and Dataset in
|
|
DATEX format.
|
|
|
|
**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 / 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  _place_holder;
|
|
|
|
|
|
** dump / exo** / file_name/ mo_name
|
|
** dump / exo** / file_name/ mo_name / psets / eltsets / facesets
|
|
** dump / exo** / file_name/ mo_name / psets / eltsets / facesets file1 file2 ... filen
|
|
** dump / exodusii ** / file_name/ mo_name
|
|
** dump / exodusII ** / file_name/ mo_name
|
|
|
|
Write a mesh object to a file in the Exodus II format.
|
|
|
|
|
|
**dump / fehm** / file_name_root / cmo_name / [**_delatt_ | keepatt**] _place_holder; _place_holder; [**keepatt_voronoi | keepatt_median**]  _place_holder; _place_holder;
|
|
 _place_holder; _place_holder; _place_holder; _place_holder;&n
|
|
bsp_place_holder;  _place_holder; _place_holder;/ [ **_ascii_ |
|
|
binary** ] / [**_scalar_ | vector | both | area_scalar | area_vector |
|
|
area_both**]
|
|
|
|
 _place_holder; _place_holder; _place_holder; _place_holder;&n
|
|
bsp_place_holder;  _place_holder; _place_holder;/ [**_all_ | graph |
|
|
coefs | none**] / [**hybrid | _nohybrid_ **]
|
|
|
|
|
|
Write out a series of files for the FEHM flow and transport code. The tokens
|
|
after the cmo name are all optional. The default options will
|
|
|
|
delete the outside node attributes and will not add attributes for the outside
|
|
voronoi or median areas.
|
|
|
|
The stor file will be written in ASCII format with scalar coefficient values
|
|
with compression of area coefficient list and indices.
|
|
|
|
[Click here for more details on the files and
|
|
options.](dump/DUMP3.html) _place_holder;
|
|
|
|
|
|
The file_name is used to form the names of the following 7 files:
|
|
|
|
file_name.fehm - coordinates and geometry ( see dump/coord/... command)
|
|
|
|
file_name_material.zone - node imt (material) zone lists ( see
|
|
dump/zone_imt/... command)
|
|
|
|
file_name_outside.zone - node external boundary zone lists (see
|
|
dump/zone_outside/... command)
|
|
|
|
file_name_outside_vor.area - node external boundary area lists (see
|
|
dump/zone_outside/... command)
|
|
|
|
file_name_interface.zone - zone lists for nodes along material interfaces
|
|
|
|
file_name_multi_mat.zone - lists of node pairs connected across material
|
|
interfaces
|
|
|
|
file_name.stor - FEHM format file giving the voronoi (control volume)
|
|
associated with each node and the sparce matrix structure
|
|
|
|
**dump / geofest**/file_name
|
|
|
|
Write a file to be read by the [GeoFEST, Geophysical Finite Element Simulation
|
|
Tool](http://www.openchannelfoundation.org/projects/GeoFEST/)
|
|
. _place_holder; The output file is ascii.
|
|
|
|
|
|
**dump / geom**/file_name
|
|
|
|
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/gmv**/file-name/[mesh-object]/[**_ascii _**| **binary**]
|
|
|
|
Write a file to be read by the graphics program
|
|
[GMV](http://laws.lanl.gov/XCM/gmv/GMVHome.html). _place_holder; The
|
|
defaults are binary and current mesh object.
|
|
 _place_holder;NOTE: _place_holder; For LaGriT versions dated after
|
|
October 1999, use  _place_holder; _place_holder;
|
|
**cmo**/**setatt**//**ipolydat**/**no** _place_holder; _place_holder;
|
|
to reduce file size. This command will keep the polygon data from being
|
|
written to GMV files.
|
|
|
|
|
|
**dump / gocad **/file_name
|
|
|
|
Write a gocad TSURF file. See [ GOCAD TSURF](http://www.connectflow.com/geovis
|
|
age/User/Formats/GocadTsurf.html). _place_holder;
|
|
|
|
**dump / lagrit **/file_name/[cmo_name]/ [**ascii **| **binary**]
|
|
|
|
Write a LaGriT restart file that contains geometry and mesh object
|
|
information. _place_holder; 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. 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.
|
|
|
|
 _place_holder; **dump / recolor**/file_name
|
|
|
|
|
|
This command writes the existing **colormap** to the specified
|
|
file. _place_holder; (See **[colormap](COLORMAP.html)** command)
|
|
|
|
|
|
**dump / stl **/file_name
|
|
|
|
Output in STL, stereo lithography format. This is only supported for triangle
|
|
mesh objects.
|
|
|
|
|
|
**dump / stor** / file_name_root / cmo_name / [ **_ascii_ | binary** ] /
|
|
 _place_holder; _place_holder; _place_holder; _place_holder;&n
|
|
bsp_place_holder;  _place_holder; _place_holder;/ [**_scalar_ | vector
|
|
| both | area_scalar | area_vector | area_both**]
|
|
|
|
 _place_holder; _place_holder; _place_holder; _place_holder;&n
|
|
bsp_place_holder;  _place_holder; _place_holder;/ [**_all_ | graph |
|
|
coefs | none**] / [**hybrid | _nohybrid_ **]
|
|
|
|
|
|
Same syntax as **dump/fehm** except the only output is the FEHM sparse matrix
|
|
coefficient STOR file file_name.stor.
|
|
|
|
File can be written in ascii or binary (fortran unformatted platform
|
|
dependent). The area coefficient values can be written as scalar or vector.
|
|
|
|
The compression default is all which will compress both the list of area
|
|
coefficients and the indices. The coefs compression, or none compression both
|
|
use and older algorithm and will result in larger files and may take longer to
|
|
run.
|
|
|
|
The ** stor ** file is one of a set of files written when the **fehm** file
|
|
type is called.
|
|
|
|
|
|
[Click here for further explanation of options.](dump/DUMP3.html)
|
|
|
|
[Click here for the STOR file format.](../STOR_Form.html)
|
|
|
|
|
|
|
|
**dump / tecplot **/file_name
|
|
|
|
Write a file to be read by the Tecplot graphics package. _place_holder;
|
|
The output file is ascii. Only node attributes are output, element attributes
|
|
are ignored and not output. Tecplot does not support prism or pyramid 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.
|
|
|
|
|
|
**dump** / **zone** /file_name/[cmo_name] / [**_delatt_ | keepatt**] _place_holder; _place_holder; [**_keepatt_voronoi_ | keepatt_median**]
|
|
|
|
Write out a set of fehm format zone files for the mesh object nodes. These
|
|
include zones for mesh materials and the external faces of the mesh as
|
|
described below. The **keepatt** option will keep node attributes that tag
|
|
nodes on external mesh boundaries (see zone_outside). The **delatt** option
|
|
will delete the outside attributes if they exist (the are removed by default).
|
|
The area attributes for outside nodes can be created with the
|
|
**keepatt_voronoi** or **keepatt_median** options (see zone_outside).
|
|
|
|
|
|
Files are written in FEHM format and are described in the dump/fehm command
|
|
[by clicking here for details.](dump/DUMP3.html)
|
|
|
|
|
|
The file_name is used to create names for the following 5 files:
|
|
|
|
file_name_material.zone - node imt (material) zone lists ( see
|
|
dump/zone_imt/... command)
|
|
|
|
file_name_outside.zone - node external boundary zone lists (see
|
|
dump/zone_outside/... command)
|
|
|
|
file_name_outside_vor.area or file_name_outside_med.area - node external
|
|
boundary area lists (see dump/zone_outside/... command)
|
|
|
|
file_name_interface.zone - zone lists for nodes along material interfaces, 0
|
|
length file if mesh is single material
|
|
|
|
file_name_multi_mat.zone - lists of node pairs connected across material
|
|
interfaces, 0 length file if mesh is single material
|
|
|
|
|
|
|
|
**dump** / **zone_imt** /file_name/[cmo_name] / [ imt_value ] _place_holder; _place_holder;
|
|
|
|
Will output only one file with name file_name_material.zone. It is written in
|
|
FEHM zone format and are described [by clicking here for
|
|
details.](dump/DUMP3.html)
|
|
|
|
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.
|
|
|
|
([For options to output PSET's as ZONE/ZONN files see: pset/zone](PSET.html))
|
|
|
|
The ** zone_imt ** file is one of a set of files written when the **fehm**
|
|
file type is called.
|
|
|
|
|
|
**dump** / **zone_outside** | **zone_outside_minmax** /file_name/[cmo_name] /
|
|
 _place_holder; _place_holder; _place_holder; _place_holder;
|
|
[**_delatt_ | keepatt**] _place_holder; [**_keepatt_voronoi_ |
|
|
keepatt_median**]
|
|
|
|
|
|
Write fehm zone format files that list the outside node list and the
|
|
associated outside area list.
|
|
|
|
|
|
There are two files written:
|
|
|
|
|
|
1. file_name_outside.zone is a node list for each of 6 possible external
|
|
boundaries.
|
|
|
|
If keepatt is specified, then 6 node based attributes are added to the mesh
|
|
object with the names top, bottom, left_w, right_e, back_n, and front_s. A
|
|
node can occur in multiple zones. For instance, a node located on a top corner
|
|
of the mesh can be found in zones for top, front_s, and left_w.
|
|
|
|
1 = top = top = positive z direction (0,0,1)
|
|
|
|
2 = bottom = bottom = negative z direction (0,0,-1)
|
|
|
|
3 = left_w = left or west = negative x direction (-1,0,0)
|
|
|
|
4 = front_s = front or south = negative y direction (0,-1,0)
|
|
|
|
5 = right_e = right or east = positive x direction (1,0,0)
|
|
|
|
6 = back_n = back or north = positive y direction (0,1,0)
|
|
|
|
|
|
2. file_name_outside_vor.area is a list of Voronoi area vectors
|
|
(Ax_i,Ay_i,Az_i) associated with each external node. It is written to match
|
|
the node lists as written in the outside.zone file. Along with each outside
|
|
zone tag (such as top), there is a sum of each vector for that zone. For
|
|
applications such as infiltration, the z component (each 3rd value) would be
|
|
used from the top zone list.
|
|
|
|
|
|
00001 top Sum VORONOI vectors: 0.5000000E+00 0.5000000E+00 0.5000000E+00
|
|
nnum
|
|
3
|
|
-2.500000000000E-01 -2.500000000000E-01 2.500000000000E-01 2.500000000000E-01 0.000000000000E+00 1.250000000000E-01
|
|
0.000000000000E+00 2.500000000000E-01 1.250000000000E-01
|
|
|
|
|
|
|
|
|
|
If the keyword keepatt_voronoi is specified, three node attributes (xn_varea,
|
|
yn_varea, zn_varea) representing the voronoi area are added.
|
|
|
|
If the keyword keepatt_median is specified, three node attributes (xn_marea,
|
|
yn_marea, zn_marea) representing the median area are added and the file name
|
|
will be file_name_outside_med.area. Note that the old version file name
|
|
file_name_outside.area has area vectors computed with the median strategy.
|
|
|
|
|
|
The option **zone_outside_minmax** is used to find the min and max external
|
|
node along each row and column of the regular grid. [Click here for image
|
|
](../../images/zone_outside.png) showing difference between the default and
|
|
the minmax options for outside nodes.
|
|
|
|
|
|
These **zone_outside** files are part of a set of files written when the
|
|
**zone** or **fehm** file type is called. The fehm zone format and
|
|
descriptions are _place_holder; [in the **dump/fehm** command
|
|
details.](dump/DUMP3.html)
|
|
|
|
|
|
|
|
EXAMPLES:
|
|
|
|
**dump **/ gmv /file_name.gmv/cmo_name/
|
|
**dump **/ gmv /file_name.gmv/cmo_name/ascii
|
|
|
|
**dump **/ file_name.gmv / cmo_name
|
|
|
|
**dump **/ tecplot /file_name.plt/cmo_name
|
|
|
|
**dump **/ lagrit /file_name.lg/-all-/binary
|
|
|
|
**dump**/file_name.inp/cmo_name
|
|
**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 **/ 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** / avs2 /file_name.inp/cmo_name/1 1 1 0 (output node coordinates, element connectivity and node attributes)
|
|
|
|
**dump** / fehm /file_root/cmo_name/ (write ascii compressed STOR file and full set of fehm input files)
|
|
**dump** / stor /file_root/cmo_name/ (write ascii compressed STOR file)
|
|
**dump** / stor /file_root/cmo_name/ binary (write unformatted compressed STOR file - platform dependent)
|
|
**dump **/ stor /file_name/cmo_name/ascii/area_scalar
|
|
|
|
**dump** / zone_outside /file_root/cmo_name/keepatt (write outside node zones and voronoi areas, keep outside attributes)
|
|
**dump** / zone_outside /file_root/cmo_name/keepatt_voronoi (write outside node zones and keep Voronoi area attributes)
|
|
**dump** / zone_outside_minmax /file_root/cmo_name (write outside nodes at minmax extent of each column)
|
|
|
|
**dump** / zone /file_root/cmo_name/ delatt keepatt_voronoi (write all FEHM zone and area files, delete the outside attributes and keep the voronoi area attributes)
|
|
|
|
**dump**/ exo / file_name / cmo_name
|
|
Write generic exodus output without any sets.
|
|
|
|
**dump**/ exo / file_name / cmo_name / psets
|
|
Write exodus output with point sets only.
|
|
|
|
**dump**/ exo / file_name / cmo_name / / eltsets
|
|
Write exodus output with element sets only.
|
|
|
|
**dump**/ exo / file_name / cmo_name / / / facesets
|
|
Write exodus output with face sets only. The facesets are internally
|
|
calculated and defined. Note that the algorithm is computationally expensive
|
|
and can take a long time to finish.
|
|
|
|
**dump**/ exo / file_name / cmo_name / / / facesets file1,file2,...,filen
|
|
Write exodus output with face sets only. The face sets are imported from
|
|
file1, file2, ..., filen.
|
|
|
|
**dump**/ exo / file_name / cmo_name / psets / eltsets / facesets file1,file2,...,filen
|
|
Write exodus output with all psets, element sets, and face sets. The face sets
|
|
are imported from file1, file2, ..., filen.
|
|
|
|
|
|
|
|
|
|
[Click here for demos](../main_dump.html)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|