Encyclopaedia Index
------ Logical; default=F; group 8 ---- -
When GALA is set to T, the pressure-correction equation is driven by residuals derived directly from the volume flow rates. This can be highly beneficial when the substantial derivative of density is zero, as it is at material discontinuities of incompressible fluids.
GALA can be used in the modelling of the movement of a water wave, for at the water-air interface the substantial derivative of density is zero. Supplementary FORTRAN coding is required in GROUND that tracks the location of the interface and sets the density field to accord with it.
If volume sources exist ( ie the substantial derivative of density is non-zero ), eg at flame fronts, or because of changes of porosity, appropriate coding must be supplied by the user in Section 7 of Group 8 of GROUND.
----------- PIL Graphics command ---- -
The syntax is : GCLEAR
This clears the graphics stack, and allows a new picture to be built.
------------- PIL Graphics command ---- -
The syntax is : GDOM(I1,I2,J1,J2,K1,K2,ICOL,IDASH)
This draws a domain outline over the limits set in colour ICOL and dash type IDASH.
------------ PIL Graphics command ---- -
The syntax is : GDRAW
This draws the current picture - Note that the results of any PIL graphics commands (except VIEW) are not drawn on the screen until a GDRAW command has been received.
Inside the MENU environment, GDRAW can put the picture in various windows:
| GDRAW | puts the current picture in the full screen window |
| GDRAW(MONITOR) | puts the current picture in the monitor window |
| GDRAW(NOTICE) | puts the current picture in the notice window |
| GDRAW(LOGO) | puts the current picture in the CHAM logo window. |
GDRAW(NOTICE) and GDRAW(LOGO) are for two-dimensional drawings: they draw only PTEXT and PLINE, and ignore GTEXT and GLINE etc.
------ Logical; default=F; group 19 --- -
GENK....= T activates the inclusion of all spatial derivatives of velocity in the generation function in subroutine GXSQUR called from GXGENK called from GREX. See DUDX for related information. In BFC cases, subroutine GXGENB is called to compute the full generation term instead of GXSQUR.
------------ Advanced PIL command --- -
The syntax is : GETCOV(NAME,PHI,CO,VAL)
GETCOV returns the COefficient and VALue for the variable PHI in the patch NAME. CO and VAL can be any valid PIL real variables.See also PATCH and COVAL.
------------ Advanced PIL command --- -
The syntax is : GETOUT(PHI,CT1,CT2,CT3,CT4,CT5,CT6)
GETOUT returns the arguments of OUTPUT for variable PHI into 6 valid PIL character variables or elements of character arrays. Values are returned as Y or N.
------------ Advanced PIL command --- -
The syntax is : GETPTC(NAME,TYPE,IXF,IXL,IYF,IYL,IZF,IZL,ITF,ITL)
GETPTC returns the type and limits of patch name NAME. TYPE can be any valid PIL real and the limits can be any valid PIL integers.
------------ Advanced PIL command --- -
The syntax is : GETSOL(PHI,CT1,CT2,CT3,CT4,CT5,CT6)
GETSOL returns the arguments of SOLUTN for variable PHI into 6 valid PIL character variables or elements of character arrays. Values are returned as Y or N.
------------ PIL Graphics command ---- -
The syntax is : GGRID(PLANE,IP,L1,L2,L3,L4,ICOL,IDASH)
This draws a section of grid on the selected plane in colour ICOL and dash type IDASH. The PLANE can be X, Y or Z. IP is the plane number, and the in-plane limits L1-L4 are;
for plane X - J1,J1,K1,K2
Y - I1,I2,K1,K2
Z - I1,I2,J1,J2
If the colour index ICOL is less than or equal to zero, it has the following functions:
| ICOL = | 0 draws outlines and region boundaries in different colours; |
| ICOL = | -1 highlights the current region in the X direction; |
| ICOL = | -2 highlights the current region in the Y direction; |
| ICOL = | -3 highlights the current region in the Z direction; |
| ICOL = | -4 draws region boundaries only. |
If IDASH is greater than or equal to 10, the dash type will be IDASH-10 and labels will be shown on regions.
------------ PIL Graphics command ---- -
The syntax is : GLINE(I1,J1,K1,I2,J2,K2,ICOL,IDASH)
GLINE draws a grid line between the points (I1,J1,K1) and (I2,J2,K2) in colour ICOL and dash type IDASH.
-------------- Command --------------- -
GLIST....Command to list grid-generation elements.
Options are: GLIST(P) List all points
GLIST(L) List all lines
GLIST(F) List all frames
See GSET for instructions on how to create points, lines and frames.
-------------- Advanced PIL command --- -
The syntax of this construct is as follows:
GOTO label1 . . LABEL label1
Restrictions are:
----------- PIL Graphics command ---- -
The syntax is : GPATCH(NAME,ICOL,IDASH[,GRID])
This draws the outline of the named patch in colour ICOL and dash type IDASH. If the patch name is ALL, then all patches will be drawn. By default patches are drawn in outline, but the optional parameter GRID causes the grid on the patch surface to be drawn as well.
If the NAME is prefixed by an asterisk '*', the patch name will not appear.
----- Integer; Default=0 ------------ -
Read only.
Satellite only, error flag for PIL graphic operations.
------------ PIL Graphics command ---- -
GPROJ....Command to draw the projection of a PATCH on a specified grid plane.
Format: GPROJ(Patch_name, dir, ipl, icol, idash)
arguments: dir X, Y or Z, ipl the number of the X, Y or Z plane on which the projection is made, icol the colour index, itype the line type index (0 for solid line, 1 and upwards for dashed lines).
Note that the patch name is not displayed with the projection.
---- Command; group 6 --------------- -
The syntax is : GRDCHK(PLANE,LOC1[,LOC2][,NOPLOT])
This command performs a BFC-grid orthogonality check on an I,J or K plane, as specified by PLANE. LOC1 is the number of the first plane to be checked, and LOC2 is an optional parameter showing the last plane to be checked. Thus :
GRDCHK(I,1) - checks I plane 1; and
GRDCHK(K,3,NZ-1) - checks K planes 3 through to NZ-1
For each plane specified, the minimum angle in each cell is calculated, and displayed by colouring the cells in the range from blue to red, where red denotes 90 degrees, and blue 0 degrees. The optional last parameter NOPLOT disables the graphical display.
The angle calculated is 90 minus the angle between a line joining adjacent cell centres, and the normal to the cell-face separating them. This is done for each of the four faces on the plane, and the smallest angle is chosen. Fully orthogonal cells will have angles of 90 degrees. If any cells have angles below ANGMIN, their indices are displayed.
See ANGMIN for details.
-------------------------------------- -
Real flag; value=1.0E20.
GREAT....A large number, used in EARTH. Do not re-set. The default value may be re-set during installation to suit the precision of the computer.
GRSP1 is an integer index, usable in subroutines called from GROUND, for accessing the 2D array of values, pertaining to the current IZ-slab, of: values of anything the user determines. In order to provide storage for the array indexed by GRSP1, subroutine MAKE must be called from Group 1, section 1 of GROUND. Similar indices are GRSP2, GRSP3, ... , GRSP10. These indices are reserved for use in GROUND and are guaranteed not to be used in any way in GREX or the GX suite.
When the character > is the first character of a patch name, and the second, third, fourth and fifth characters are the name of a stored (or solved) variable, a source is created which is equal to:
CO * (VAL * S - PHI) where S is the local value of the above-mentioned stored variable and PHI is the local value of the variable to which the source is applied.
For example, the following statements in a Q1 file:
PATCH(>W1,CELL,NY/4+1,NY/2,NZ/4+1,NZ/2,1,LSTEP)
COVAL(>W1,V1,1.0E3,-1.0)
will provide a source of V1 which equals 1.0E3*(- W1 - V1) .
This will tend to make V1 equal to - W1 .
------------ PIL Graphics command ---- -
The syntax is : GTEXT(TEXT,I1,J1,K1,ICOL)
GTEXT writes the specified TEXT characters at the specified position (I1,J1,K1) in colour ICOL.
------- Advanced PIL command -------- -
GTPARG Command used to get the parameters of existing PATCHes and COVALs
Options are:
GTPARG(patch_name, N, ct1, it1, ct2, it2) This command:-
sets ct1=N if the patch does not exist, and no values are returned to it1,ct2,it2, sets ct1=Y if the patch exists, returns the patch number to it1, returns the patch type to ct2 in character form, returns zero to it2 (ie not used at present).
GTPARG(patch_name, X, ct1, it1, ct2, it2)
returns to ct1 and ct2 the symbols #, $ or % to signify that region numbers have been used for setting the X limits, returns to it1 and it2 the region (or cell) numbers, ct1 or ct2 will be blank if no symbols were used (ie X limits are cell numbers). The string :ct1::it1:,:ct2::it2: will therefore reconstruct the original setting of X limits for the patch.
GTPARG(patch_name, Y, ct1, it1, ct2, it2) returns to ct1, it1, ct2, it2 the symbols and numbers used for the Y limits of the patch.
GTPARG(patch_name, Z, ct1, it1, ct2, it2) returns to ct1, it1, ct2, it2 the symbols and numbers used for the Z limits of the patch.
GTPARG(patch_name, T, ct1, it1, ct2, it2) returns to ct1, it1, ct2, it2 the symbols and numbers used for the T (time) limits of the patch.
GTPARG(patch_name, C, variable_name, ct1, ct2) This use of GTPARG will return the COVAL arguments to ct1 (coefficient) and to ct2 (value) for the specified patch and variable name.
In the commands above, ct1 and ct2 are any user-declared PIL character variables, it1 and it2 are any user-declared PIL integer variables.
------------ PIL Graphics command ----
entered into the Q1 file either by manual editing, or by saving into Q1 the settings which have been (implicitly) made in an interactive VR-Editor session. Those made in a VR-Viewer session cannot be saved except by re-entering the VR-Editor before closing.
GVIEW has 1, 2, 3 or 4 arguments as described below.
where value is the View Size parameter, which controls the image zoom.
GXMAKE is a subroutine which may be called in Ground coding, GROUP sections 1 or 3, in order to create storage for variables required by the user.
For details, see PHENC entry FUNCTION ...