ADD [ZONE] zone [FROM] FILE file [UNITS units] |
The parameter units is one of the following: METERS(M) (default), INCHES(IN), FEET(FT), CENTIMETERS(CM), or MILLIMETERS(MM).
CANCEL - Cancel pending changes
CANCEL |
Causes any pending grid or boundary condition changes that have not yet been written to the files to be discarded. Changes are normally written whenever a ZONE or BOUNDARY command with a non-null zone or boundary is issued.
DO/ENDDO - Perform commands for a range of zones
DO {[ZONE] zone1 [TO] [ZONE] {zone2|MAX} | ALL} [[STEP] inc] commands ENDDO |
The DO ... ENDDO structure allows the user to perform a series of commands simultaneously for a range of zones from zone1 to zone2, incrementing as specified (default increment is 1). Any valid commands - except FILE, FLOWFILE, ADD, REPLACE, or SWITCH|GRAPHICS - may be entered through a command file or in text mode. GMAN will loop through the specified zones and perform the given commands.
EXIT | QUIT - Terminate session
EXIT | QUIT |
Terminates the GMAN session. Any pending changes are written to the file.
FILE - Specify file(s) to process
FILE file [CGD|MDA|FDA|ZDF|Z2M|Z2C|HESS] [coord] [index] [UNITS units] |
The FILE command specifies the name of the grid file(s) to process. With the exception of Common Grid files, the file name file must be entered without a suffix. The format of the input file(s) may be specified by using one of the following parameters:
CGD | Common Grid (suffix .cgd) file. | ||
MDA | Mesh Direct Access (MDA) file, with suffix .mda. If the corresponding Zone coupling Direct Access (ZDA) file does not exist, any command that would reference boundary condition data will cause the ZDA file to be created. | ||
FDA | FANSI Direct Access (FDA) file, with suffix .fda. | ||
ZDF | Zone Definition File (ZDF), with suffix .zdf. The file will first be converted to a Common Grid file, then processed. | ||
Z2C | Same as ZDF. | ||
Z2M | Zone Definition File (ZDF), with suffix .zdf. The file will first be converted to a Mesh Direct Access (MDA) file, then processed. If the corresponding Zone coupling Direct Access (ZDA) file does not exist, any command that would reference boundary condition data will cause the ZDA file to be created. | ||
HESS | ??, with suffix .hes. The file will first be converted to an FANSI Direct Access (FDA) file, then processed. |
If a file type is not specified using one of the above parameters, the following process is used, in the order listed, to determine the file to use.
If a Zone Definition File (ZDF) is being processed, the input parameters coord, index, and units may be used to remap the computational coordinates and/or indices, and to assign units.
coord | [+|-]X|Y|Z [+|-]X|Y|Z [+|-]X|Y|Z | ||
index | [+|-]I|J|K [+|-]I|J|K [+|-]I|J|K | ||
units | METERS|M | INCHES|IN | FEET|FT | CENTIMETERS|CM | MILLIMETERS|MM |
No checks are made for left-handedness or uniqueness of specification, however. (I.e., specifying the indices as J JJ K does not generate an error message.)
Examples
If the user is reading a ZDF file, and wants to change the sign of the X-coordinate and exchange the Y and Z coordinates in the resulting Common Grid file, the FILE command would be
FILE file Z2C -X Z YThe same usage applies to the coordinate indices. Thus,
FILE file Z2C -I K JBoth operations may be performed at once, as in
FILE file Z2C -X Z Y -I K J
REFERENCE [CONDITION] [LENGTH [val] | MACH [val] | PRESSURE [val] | REYNOLDS [NUMBER] [val] | TEMPERATURE [val]] |
The REFERENCE command sets values which are used for calculating y+ when checking grid quality.
REMAP [+|-]I|J|K [+|-]I|J|K [+|-]I|J|K |
The REMAP command allows the user to change the relationship between the grid indices and the physical coordinates, essentially remapping the indices. The specified index directions represent the existing mapping (i.e., the old coordinate directions), and their order determines the new mapping (i.e., the new coordinate directions). The syntax is thus
REMAP "which old index is new i" "which old index is new j" \ "which old index is new k"Note - in earlier versions of GMAN this command was called INDEX.
Suppose we wish to remap the indices such that the new i direction is the same as the old j direction, the new j direction is the same as the old k direction, and the new k direction is the same as the old −i direction. I.e.,
New | Old | ||
---|---|---|---|
i | j | ||
j | k | ||
k | −i |
The appropriate command would be
REMAP J K -I
REPLACE - Overwrite current zone with one from another file
REPLACE [WITH] [ZONE] zone [FROM] FILE file [UNITS units] |
The REPLACE command lets the user overwrite the current zone with a zone from another Common Grid file. If the new zone is larger than the current zone, it will be necessary to compress the Common Grid file using cfcnvt to recover the space of the original zone.
STATUS - Display status information
STATUS |
The STATUS command displays information about the currently selected file, zone, and boundary.
SUBAREA - Set active range of current face
SUBAREA 2d-range |
The SUBAREA command sets the active range of the current face for boundary coupling.
For a constant i face, 2d-range is specified as
Jm1 Km2 Jn1 Kn2 | ALLwhere m1 and m2 are the minimum values, and n1 and n2 are the maximum values, of the j and k indices defining the desired subarea. The parameters may be specified in any order. Jn1 and/or Kn2 may also be specified as MAX, meaning the maximum value in that direction. If ALL is specified, the subarea is defined as the entire face.
Similarly, for a constant j face, 2d-range is specified as
Im1 Km2 In1 Kn2 | ALLand for a constant k face, 2d-range is specified as
Im1 Jm2 In1 Jn2 | ALL
As an example, to set the subarea on an j face to the range from i = 1 to 20 and k = 5 to 30, you could write
SUBAREA I1 K5 I20 K30
SUBREGION - Set active range of current zone
SUBREGION 3d-range |
The SUBREGION command sets the active range of the current zone.
The parameter 3d-range is specified as
Im1 Jm2 Km3 In1 Jn2 Kn3 | ALLwhere m1, m2, and m3 are the minimum values, and n1, n2, and n3 are the maximum values, of the i, j, and k indices defining the desired subregion. The parameters may be specified in any order. In1, Jn2, and/or Kn3 may also be specified as MAX, meaning the maximum value in that direction. If ALL is specified, the subregion is defined as the entire zone.
As an example, to set the subregion to the range from i = 1 to 10, y = 1 to 20, and k = 5 to 30, you could write
SUBREGION I1 J1 K5 I10 J20 K30
SWITCH|GRAPHICS - Switch to graphics mode
SWITCH|GRAPHICS |
The SWITCH|GRAPHICS command switches from command line mode to graphics mode.
TITLE - Change file or zone title
TITLE [TLMAIN|TLSECONDARY] [TLGLOBAL|TLZONAL] [new_title] |
The TITLE command allows the user to change either the file title or a zone title. If a ZONE command has not been issued then the file title will be modified. If a ZONE command has been issued then the current zone title will be modified.
UPDATE - Update pending changes
UPDATE |
Force an immediate update of any grid or boundary condition changes that have not yet been written to the files.
ZONE zone|NONE |
The ZONE command specifies the zone number to which subsequent commands will apply. Any grid or boundary condition changes that have not yet been written are applied before selecting the new zone. If a zone number is not specified then information about the currently selected zone will be displayed.
If NONE is specified then the current zone selection will be cleared. This is useful if one wishes to issue a TITLE command to change the global title, but has already issued a ZONE command.