[UP] [TOP] [HOME]

Included Data page

This is the Next >> page accessed in WizGen from the User-defined keywords page or by selecting the Goto... button for Choose which data files are included from the Contents page.

The relevant input data blocks created via FileGen should be included in the TransGen project runfile (i.e. <project>.TGDATA).  Additional data may also be included at this stage.

NOTE:- If the current TransGen Project is opened for the first time in "Flexible project" mode, the Included Data page will initially be blank as shown below. However, if it has already been worked on as a "Basic project" which has been upgraded to a "Flexible project", the Included Data page will automatically show the data files added previously.



Adding Data Files

1. To add a data file, click on the top Browse... button to open a file selection window, shown below.

2. Navigate to the <project>_INPUT directory (e.g. F64_New_INPUT) and click on a file, e.g. COORD.DATA to select it.

3. Click on OK to load the selected file into the Included Data window of WizGen.

4. Repeat to add all other files.





Data to include

In order to load and view a model, the data associated with the following Eclipse keywords MUST be in the first two files added to the Included Data page of WizGen:-
  • COORD                            - to define the map position of the cell corners

  • ZCORN                             - to define the depth of the cell corners


  • Additionally, in order to view cell and fault properties and to generate transmissibility multipliers, the data associated with the following keywords are required:-
  • PERMX and PERMY     - to define cell permeabilities

  • NTG or TGVS or both     - to define the shale content of the cells

  • MULTX and MULTY      - to import grid-block-based transmissibility multipliers from Eclipse (new to TransGen version 3 - see section on Including Transmissibility Multipliers from Eclipse for details)


  • To run the Two-Phase Flow module, the data associated with the following keyword must also be included:-
  • SATNUM                         - to access a set of relative permeability and capillary pressure curves for each cell in the model


  • Other possible data files to include are those associated with keywords that modify the data arrays (ADD, COPY, EQUALS, MULTIPLY) if these are present in the original Eclipse run file to ensure TransGen uses the same data as Eclipse.

    Similarly, if any of keywords that control which cells are active (i.e. ACTNUM, MINPV, MINPVV, PORO) are present in the Eclipse run file, these should also be included to ensure TransGen identifies the same cell/cell connections as Eclipse.

    Optionally, the data files associated with the keywords PERMZ, FAULTS, TGWELL, TGSTRLNE, MULTZ , TGXSECT can be added for visualisation purposes.

    If you are proposing to calculate any Fault Seal Potential measure using Shale definition based on the TGSHALE keyword (see Shale definition setting on the Fault Seal Potential Variables page), the file containing the TGSHALE keyword and associated data (values for every cell with 1 representing a shale cell and 0 a non-shale cell) must be included on this page of WizGen Heavy.

  • User-defined Cell Property file(s)

  • Once appropriate User-defined keywords have been defined, user-defined cell properties can be included in the TransGen run in exactly the same way as standard grid-block properties (e.g. NTG, PERMX, TGVS).

    The include file for a user-defined Cell Property file with the keyword cell_property1 in a 300 grid-block model might be:-

    cell_property1
    100*0.02
    100*23
    100*0.1
    /

    This file can then be attached to the TransGen run on the Included Data page of WizGen in the same way as the other files. If values of a user-defined cell property are read into TransGen (rather than calculated in a plugin) it is essential that values are included for each cell in the model. If there are 100 cells in the model, there must be 100 values provided with the keyword or TransGen will stop with an error message.

    If you are proposing to use the Two-phase module, a source of across-fault flow rates must be included. To calculate the across-fault flow rates from a grid of cell pressures, the relevant Cell Property keyword (e.g. CELL_PRESSURE) must be declared on the User-defined keywords page and the associated data file loaded by adding it to the Included Data page.

    The Cell Pressure input file (e.g. cell_pressure.txt) should include a grid of cell pressures where the units are bars (METRIC), psi (FIELD) or atm (LAB).

    Example:-

    CELL_PRESSURE
    --at 2 years, using PDO U.
    265.23  264.91    266.45  266.19    266.16  265.78    265.69  265.58
    265.51  265.24    265.14  266.75    298.17  302.67    304.21  305.56
    306.7   307.81   309.13   310.6    312.16  313.78    315.23  316.04
    330.31  330.31    330.31  330.31    330.31  330.31    330.31  330.31
    330.31  330.31    330.31  330.31    330.31  330.31    330.31  330.31
    ...
    278.24  277.72    277.21  276.78    276.46  276.27    276.19  276.27
    276.53  276.94    277.61  278.53    279.57  280.61    281.56  282.36
    282.91  283.01    282.65  281.98    281.11  280.1 278.95 277.59
    276.06  274.51    273.05  271.66    270.31  268.91    267.7   266.84
    265.89  264.77    263.86  262.83    262.45  262.52    262.74  337.77
    /

  • User-defined Connection Property file(s)

  • Once appropriate User-defined keywords have been defined, user-defined connection properties can be imported into the TransGen model. The format for the imported connection data is based on that used to export connection data using the TGXRPT keyword, i.e. each line of data in the file refers to one connection, contains 7 items and is terminated by a slash (/). The total list of connections is then terminated by another slash.

    The line:

    I1 J1 K1 I2 J2 K2 value /

    therefore refers to a faulted connection between cells (I1, J1, K1) and (I2, J2, K2) and an include file for a user-defined connection CON_PROP1 might look like:-

    CON_PROP1
    1 1 2 2 1 5 0.7453 /
    1 1 2 2 1 6 0.67 /
    1 1 2 2 1 7 0.112 /
    /

    Both neighbour and non-neighbour connections can be included in the file; TransGen only discriminating between these connection types when outputting the EDITTNNC, TRANX and TRANY Eclipse include files. If the user-defined connection file contains reference to non-existent or unfaulted connections (i.e. connections between grid-blocks without explicit displacements across them defined in the ZCORN file) they are ignored by TransGen and a warning message is issued.

    It is not required that all faulted connections have data values associated with them when using a new user-defined connection keyword; if a connection does not have a value specified in the input, the value for that connection defaults to -1.0, the value assigned to "undefined" connections.

    NOTE:- User-defined connection properties are only stored as connection averages within TransGen, i.e. as c.user_defined_connection. Whereas most other connection properties calculated by TransGen are stored both as connection vertex properties (e.g. v.fsp1) and as average connection properties (e.g. c.thick).

    Similarly if you are proposing to use the Two-phase module, a source of across-fault flow rates must be included. If the source of across-fault flow rates is via a user-defined fault property, i.e. a single value of across-fault flow rate (Darcy velocity) loaded for each connection, the relevant Connection Property keyword (e.g. DARCY_VEL) must be declared on the User-defined keywords page and the associated data file loaded by adding it to the Included Data page.

    The Darcy Velocity input file (e.g. darcy_vel.txt) should include the following data with a positive value for the Darcy Velocity signifying a flow from cell I1 J1 K1 to cell I2 J2 K2 and a negative value indicating flow from cell I2 J2 K2 to cell I1 J1 K1 and the units of across-fault Darcy velocity in metres/day (METRIC), ft/day (FIELD) or cm/hour (LAB).

    Example:-

    DARCY_VEL
    ---I1  J1  K1  I2  J2  K2  VALUE
    1   7    1   2    7   4    -0.001894186    /
    1   7    1   2    7   5    -0.003168526    /
    1   7    1   2    7   6    -0.00079227 /
    1   7    1   2    7   7    -0.001143496    /
    1   7    2   2    7   5    -0.002235422    /
    1   7    2   2    7   6    -0.000294127    /
    1   7    2   2    7   7    -0.00055016 /
    1   7    2   2    7   8    -0.000810556    /
    1   7    3   2    7   6    0.000233575 /
    1   7    3   2    7   7    6.15184E-05 /
    ...
    36  111   20   36   112  12    -0.064336965    /
    36  111   20   36   112  13    -0.071158179    /
    36  111   20   36   112  14    -0.079036781    /
    36  111   20   36   112  15    -0.086137624    /
    36  111   20   36   112  16    -0.101391355    /
    /




    Data to include when using the new Fault Trace and Zone functionality

    If you are licensed to use the new TG version 3.2 functionality and have toggled the Include fault drag and hierarchical zone effects option "on" (via the Title page of WizGen), files containing the following new keywords and associated data can be included on this page.

  • TGTHROW - to define the location and throws of new user-defined fault traces (i.e. to include additional sub-resolution traces) in the model.

  • TGFZONE - to include new user-defined fault zone(s) in the model.

  • TGDRAG - to manually define throw modifications on any or all fault traces (system or user-defined) in the model.

  • TGTRACE - to include up to 10 user-defined trace properties for any or all fault traces (system or user-defined) in the model.


  • In the example shown below the first eight files include data on the cell geometries and cell properties, while the final four files include the new trace-related keywords and associated user-defined data.

    HINT:- Fault traces are automatically recognised by ViewGen from the geometry of the input model. These fault traces contained explicitly in the parent model geometry (termed system traces) do NOT need to be included as data files. Similarly each system trace has, by default, a single fault zone associated with it which can then have structure applied via the Hierarchical fault zone definition page of WizGen.




    When all the relevant  files have been added, click on the Next>> button to view/edit Miscellaneous Options page.

    Alternatively, click on the << Back button to return to the User-defined keywords page to view/edit the layout of the input data, the number of Rows, Columns and Layers in the current project and the Units setting.

    Or click on the Contents button to access the Contents page to view/edit any of the current TGDATA file settings, inspect the project's TGDATA file and/or inspect the log generated by last ViewGen calculation.

    Click on Save to save any modifications made to the current TGDATA runfile.
    Click on Quit to exit from WizGen with or without saving the any changes to the TGDATA runfile.


    Including Transmissibility Multipliers from Eclipse



    [UP] [TOP] [HOME]