KEYWORDS

These notes assume that a user of TransGen has some knowledge of using Keywords in Eclipse.

In TransGen, instructions and data are supplied to the calculation and graphics module ViewGen in an instruction text file (<Project>.TGDATA) created via the WizGen module using Keywords.

The Keywords used in the <Project>.TGDATA file include:-

A small subset of the available Eclipse Keywords - to define the data from the Eclipse model to be used in a TransGen run.

New Transgen Keywords - to enter information specific to the calculations performed by TransGen.  All TransGen-specific Keywords start with TG.

Click here for details of the Eclipse data that TransGen requires

Click here for details of the TransGen instruction file.

NOTE:- It is recommended that you use the WizGen module to add all the relevant keywords to the instruction file (<Project>.TGDATA) in the correct order and that you do not attempt to edit the TGDATA manually.

General rules for Keywords in the .TGDATA file

Keyword Order

TransGen requires the keyword order at the top of the file to be:-

TITLE [optional]

DIMENS (or SPECGRID)

TGAXES [optional]

COORD

ZCORN

The final keyword must be:

END

Format of Keywords

A keyword is written on a new line in the instruction file and can be written in upper, lower or mixed case.

Data required by the keyword immediately follows the keyword.  

Comments are allowed between a keyword and any associated data.  

Data

The type and quantity of data required to follow a keyword is specific to the keyword itself and the current input state.  

In general, data input for a keyword is terminated by a forward slash (/).  There must be a space between the data and the slash.

TransGen ignores surplus white-space characters (e.g. new-line, space, tab) when reading keyword data.  Therefore, the two examples given below are equally valid:-

example 1:
DIMENS
    10
20

              30
/

and

example 2:
DIMENS
10 20 30 /

TransGen conforms to the Eclipse method of reading repeat numerical data using the '*' operator. Ten equal values of (for example) porosity can be written as:
PORO
0.2 0.2 0.2 0.2 0.2 0.2 0.2 0.2 0.2 0.2 /

or

PORO
10*0.2 /

Note that there should be no spaces on either side of the '*' operator.

Character data should be enclosed in single quotes.  The exception to this rule is TITLE which reads character data unquoted and does not require a slash (/) to end the character input - in this case the input is restricted to the end of the line.

The most common reason for an instruction file to be rejected by TransGen is the absence of a slash (/) at the end of a data record.  Another common error is the absence of an END statement at the end of the file.


TransGen ignores 'flat' cells with coincident top and bottom surfaces, (ie, identical Z values at the corner positions).  Such planar 'cells'  have no volume, contain no fluid, cannot support any flow, and have no connections to other cells and are also ignored by Eclipse. At unconformities where footwall erosion has occurred, their position contributes no information with respect to the pre-erosion displacement field.  As they have no thickness they contribute no shale  to the SGR computation,.  In models with unconformities a large proportion of the model (80% is not unusual) may consist of such redundant cells.  Such cells are identified and flagged when the ZCORN data is loaded;  later when the property data is read, none  is stored.  This considerably improves memory usage and speed, but does necessitate the geometry to be loaded before property data.  A message reporting the number of 'flat' cells will be present in the log file.

For any faulted active cell, TransGen determines the displacement by finding the position of an 'non-flat' cells in the same layer on the opposite side of the fault.  If an 'non-flat' cell in a corresponding layer does not exist, perhaps because of erosion at an unconformity, TransGen estimates the displacement as best it can, starting by seeking to find the displacement from a layer which exists on both sides of the fault lower down.  A message that displacement have been estimated rather than determined will appear in the log file.

Keywords recognised by TransGen

Click on any keyword listed below for details on the format necessary for recognition within TransGen.

ACTNUM,  ADD,  BOX,  COORD,  COPY,  DIMENS,  EDITNNC,  END,  ENDBOX,  EQUALS,  FAULTS,  FIELD,  INCLUDE,  KRNUM,  LAB,  METRIC,  MINPV,  MINPVV,
MULTIPLY,  MULTX,  MULTY,  MULTZ,  NNC,  NTG,  PERMX,  PERMY,  PERMZ,  PORO,  SATNUM,  SPECGRID,  SWOF,  TGAXES,  TGDRAG,  TGEVS,  TGFSP,  
TGFZONE,  TGKDT,  TGKSE,  TGKST,  TGMETRIC,  TGMINTR,  TGNEWKEY,  TGNNC,  TGNOCALC,  TGPLUGIN,  TGREMNNC,  TGRPT,  TGSGRM,  TGSHALE,  
TGSTRLNE,  TGTDE,  TGTDT,  TGTHROW,  TGTRACE,  TGVOLERR,  TGVS,  TGWELL,  TGXRPT,  TGXSECT,  TGXTRACE,  TITLE,  TRANX,   TRANY,  UNITS,  ZCORN