Output data and History data

Contents

Output data

Description

Several keywords, sub-keywords and parameters relevant to output of variables in plot files and history sets are defined.

History output of fault data

Usage

*HISTORY FAULT, TIME=Time_increment, STEP=Step_increment, POINT DATA=Yes-or_No,

Description

The *HISTORY FAULT keyword is used to generate ParaGeo History_surface data corresponding to fault surfaces. This allows to output averaged variables at fault surfaces and/or point data of nodes at faults.

Optional Parameters
TIME	Defines the time increment between history outputs. If not defined parameter STEP must be defined.
STEP	Defines the increment in number of steps between history outputs. If STEP=END output will be performed at the end of the current stage. If not defined parameter TIME must be defined.
POINT DATA	Defines whether history output for all nodes on specified fault surfaces should be output or not. Valid options are: - YES (Output point data at each history output) - NO (Default) - END (Output point data at the end of stage only)

Sub-Keywords

List of faults for history output

List of variables to be averaged through the surface

Examples

*HISTORY FAULT, TIME=0.02, POINT DATA=YES

*FAULTS

Fault1, Fault2, Fault3

*AVERAGE VARIABLES

C_strsnm, Cstrstn

1History_surface data will be generated for fault surfaces from Fault1, Fault2 and Fault 3.

2The time increment between each two consecutive history outputs is 0.02 Ma.

3History data for all nodes that belong to the fault surfaces will be output

4Average history for contact normal stress and contact tangential stress will be output.

History output of global data

History output of variables at well path

Usage

*HISTORY LINE, NAME=History_set_name, FILE=File_name, TYPE=Type, TIME=Value, STEP=Value, DISTRIBUTION=Point_distribution_type, POINT DISTANCE=Value, NUMBER POINTS=Value, AVERAGE=Value

Description

The *HISTORY LINE keyword is used to generate ParaGeo History_section_line data structure. This is used to output history of specified variables in a well path that may be non-vertical. The results may be stored in .hdh, .psect, .las and .interp files.

Compulsory Parameters
NAME	Defines a name for the history set.

Optional Parameters
FILE	Defines a name for the file to be output with the history line data. If not defined a default file name will be assigned as "ModelDataFileName_LineSetNumber.hdh"
TYPE	Defines the type of line history set. Valid options are: - General - General path defined via X, Y and Z coordinates (Default) - Vertical - History line with a vertical path - Near Vertical - It is equivalent to a general type of history line but it can also be used to extract formation data (stratigraphy horizons) in order to create 1D models
TIME	Defines the time increment between history outputs. If not defined parameter STEP must be defined.
STEP	Defines the increment in number of steps between history outputs. If STEP=END output will be performed at the end of the current stage. If not defined parameter TIME must be defined.
DISTRIBUTION	Defines how the well path points will be distributed. Valid options are: - AUTO1 Automatic point distribution based on POINT DISTANCE or NUMBER POINTS (for TYPE=Vertical). - AUTO2 Automatic point distribution based on POINT DISTANCE or NUMBER POINTS. Additional points will be inserted adjacent to formation boundaries (for TYPE=Vertical). - POINTS1 Output at points defined via PATH COORDINATES (TYPE=General/Near Vertical) - POINTS2 Output at points defined via PATH COORDINATES (TYPE=General/Near Vertical) and additional points inserted adjacent to formation boundaries.
POINT DISTANCE	Defines the distance between two consecutive points for DISTRIBUTION=AUTO1 and DISTRIBUTION=AUTO2 (for TYPE=Vertical). Note that if NUMBER POINTS is defined it will take precedence over POINT DISTANCE
NUMBER POINTS	The NUMBER POINTS is dependent on the TYPE of history line: - General - Defines the total number of points for the history line - Vertical - Defines the number of points for each group or stratigraphy unit - Near Vertical - Defines the total number of points for the history line Note that if NUMBER POINTS is defined it will take precedence over POINT DISTANCE
AVERAGE	Defines whether averaged state variables with values from adjacent elements to point location should be output or not and which level of adjacent elements should be considered to calculate the averages. Valid options are: - 0 - No average values are output - 1 - Average values calculated from the elements adjacent to the element which contains the point are output (Default).

Sub-Keywords

Output file format

Line history description

Groups for which history data will be output

Formations for which history data will be output

History line path coordinates

History line path plan coordinates

Output of decompaction variables

Output of depth

Output of diagenesis variables

(not available) Output of directional decompaction variables

Output of displacement variables

Output of elastic variables

Output of element variables

Output of fracture variables

Output of hardening variables

Output of hydrostatic pore pressure

Output of plastic variables

(Not implemented) Output of plastic anisotropy variables

Output of pore pressure

Output of poroelastic variables

Output of porous flow variables

Output of porous flow state variables

Output of strain variables

Output of strain invariant variables

Output of stress variables

Output of stress invariant variables

Output of temperature

Output of thermal variables

Output of thermal state variables

Output of velocity variables

Output of viscoplastic variables

Examples

*HISTORY LINE, NAME=Well_1, FILE=Model1_Well1, TYPE=General, TIME=0.05

*OUTPUT FORMAT, HDH=No, PSECT=Yes, LAS=Yes

*PATH COORDINATES

100.0, 100.0, 0.0,

100.0, 100.0, 100.0,

100.0, 100.0, 200.0,

110.0, 105.0, 300.0,

120.0, 110.0, 400.0,

130.0, 150.0, 500.0,

140.0, 150.0, 550.0,

150.0, 150.0, 600.0,

*DISPLACEMENT

Disp_x, Disp_y, Disp_z

*ELEMENT

Porosity, Elt_pore

*PORE PRESSURE

*TEMPERATURE

1A history line set named "Well_1" will be created

2The output file name will be "Model1_Well1"

3The history line type is set to "General". Thus line coordinates must be provided.

4Output of data will be performed every 0.05 Ma

5The history results will be output in both ParaGeo and LAS formats in single files for each output time which will contain the complete history line results

6A non-vertcal line path is defined

7Displacement in X, Y and Z directions will be output

8Element porosity and Pore Pressure will be output

9Temperature and Pore Pressure will be output

History output of variables at Lagrangian points

Usage

*HISTORY POINT, NAME=Point_set_name, FILE=File_name, TIME=Value, STEP=Value, AVERAGE=Value

Description

The *HISTORY POINT keyword is used to generate ParaGeo History_point data structure. By default the point set can contain points in any group in the model. If the points should be confined to specific groups then the *GROUPS sub-keyword should be specified

Compulsory Parameters
NAME	Defines a name for the point set.

Optional Parameters
FILE	Defines a name for the file to be output with the history point data. If not defined a default file name will be assigned as "ModelDataFileName_PointSetNumber.hdh"
TIME	Defines the time increment between history outputs. If not defined parameter STEP must be defined.
STEP	Defines the increment in number of steps between history outputs. If STEP=END output will be performed at the end of the current stage. If not defined parameter TIME must be defined.
AVERAGE	Defines whether averaged state variables with values from adjacent elements to point location should be output or not and which level of adjacent elements should be considered to calculate the averages. Valid options are: - 0 - No average values are output - 1 - Average values calculated from the elements adjacent to the element which contains the point are output (Default).

Sub-Keywords

Output of point coordinates

Output of decompaction variables

Output of depth

Description for point set

Output of diagenesis variables

Output of directional decompaction variables

/ DISPLACEMENTS Output of displacement variables

Output of elastic variables

Output of element variables

Output of fracture variables

Assignment of point set to groups

Output of hardening variables

Output of hydrostatic pore pressure

Definition of point labels

Output of plastic variables

(Not implemented) Output of plastic anisotropy variables

Definition of coordinates for history points

Output of pore pressure

Output of poroelastic variables

Output of porous flow variables

Output of porous flow state variables

Output of strain variables

Output of strain invariant variables

Output of stress variables

Output of stress invariant variables

Output of temperature

Output of thermal variables

Output of thermal state variables

/ VELOCITIES Output of velocity variables

Output of viscoplastic variables

Examples

*HISTORY POINT, NAME=Set_1, TIME=0.05

*GROUPS

Formation0, Formation1

*POINTS

100.0, 100.0, 100.0

200.0, 200.0, 200.0

*LABELS

Point_1, Point_2

*DISPLACEMENT

Disp_x, Disp_y, Disp_z

*ELEMENT

Porosity, Elt_pore

*PORE PRESSURE

*TEMPERATURE

1A history point set named "Set_01" will be created

2Output of data will be performed every 0.05 Ma

3The point set is associated to groups "Formation0" and "Formation1" (this is just informative and has no effect in the simulation)

4Two Lagrangian points will be considered in this point set and their coordinates are provided.

5Displacement in X, Y and Z directions will be output

6Element porosity and Pore Pressure will be output

7Temperature and Pore Pressure will be output

History output of surface data

Usage

*HISTORY SURFACE, NAME=Name_ID, FILE=File_name, TIME=Time_increment, STEP=Step_increment, ACTIVE=Active_or_Disable, POINT DATA=Yes_or_No

Description

The *HISTORY SURFACE keyword is used to generate ParaGeo History_surface data for specified geometry sets. This allows to output averaged variables at Geometry_set surfaces and/or point data of Geometry_set nodes.

Compulsory Parameters
NAME	Defines a name for the history surface set

Optional Parameters
FILE	Defines a file name for the history surface set
TIME	Defines the time increment between history outputs. If not defined parameter STEP must be defined instead.
STEP	Defines the increment in number of steps between history outputs. If STEP=-1 output will be performed at the end of the current stage. If not defined parameter TIME must be defined instead.
APPEND SET NAME	Defines whether the set name is added as a suffix in the output of history file name: - YES - NO (Default)
POINT DATA	Defines whether history output for all nodes on specified fault surfaces should be output or not. Valid options are: - YES (Output point data at each history output) - NO (Default) - END (Output point data at the end of stage only)

Sub-Keywords

List of geometry sets for history output

List of variables to be averaged through the surface

Output data to plot files

Usage

*OUTPUT, TYPE=Node_or_Element, START OUTPUT TIME=Value, END OUTPUT TIME=Value, OUTPUT TIME FACTOR=Value, AVERAGE=Value, DISCRETE=Yes/No

Description

The keyword *OUTPUT is used to specify which variables are going to be output in plot files.

Optional Parameters
TYPE	Defines the type of output variable which can be: - Nodal / Node - Output of variables at nodes - Element - Output of variable values at elements
START OUTPUT TIME	Defines the time at the beginning of the current step/stage in order to set the output times. For example after initialization it may be desirable to set the time so that it coincides with real time (e.g. a case is initialized so that time is 2.0 time units after initialization but then START OUTPUT TIME is set to 2018 at the beginning of the first production stage so that plot files are properly referenced to real time; that is if a plot file is requested every half a year, plot files will be at times 2018.5, 2019, 2019.5, etc.)
END OUTPUT TIME	Defines the "real" time at the end of the current simulation step/stage in order to set the output times. Note that the time duration between START OUTPUT TIME and END OUTPUT TIME may be different than the simulation step/stage process time (e.g. process time for the step/stage may be 1.0 whereas the "real" time may be 5 years). If END OUTPUT TIME is used, START OUTPUT TIME will be required at least for the first simulation step/stage but it may optionally not be specified for subsequent steps/stages if the "real" time is continuous.
OUTPUT TIME FACTOR	Defines a factor to scale outputs to plot files so they are consistent with real time in case time duration in simulation does not correspond to time duration in reality (e.g. stages may have simulation duration of 1.0 year for modelling conveniences but the real time for those stages may be 2.7 years).
AVERAGE	Defines whether averaged state variables with values from adjacent elements to point location should be output or not and which level of adjacent elements should be considered to calculate the averages. Valid options are: - 0 - No average values are output - 1 - Average values calculated from the elements adjacent to the element which contains the point are output (Default).
DISCRETE	Defines whether the variable values at the nodes should be output or not (in which case only the element variable values will be output). Valid options are: - Yes - No (Default)

Sub-Keywords

Output of decompaction variables

Output of diagenesis variables

(Not available) Output of directional decompaction variables

Output of displacement variables

Output of elastic variables

Output of element variables

Output of fracture variables

Output of geometry plot file data

Output of hardening variables

Output of hydrostatic pore pressure

Output of plastic variables

(Not implemented) Output of plastic anisotropy variables

Output of pore pressure

Output of poroelastic variables

Output of porous flow variables

Output of porous flow state variables

Output of strain variables

Output of strain invariant variables

Output of stress variables

Output of stress invariant variables

Output of temperature

Output of thermal variables

Output of thermal state variables

Output of velocity variables

Output of viscoplastic variables

Examples

*OUTPUT

*STRESS

Strs_xx, Strs_yy, Strs_zz, Strs_xy, Strs_yz, Strs_zx

*DISPLACEMENT

Disp_x, Disp_y, Disp_z

*ELEMENT

Porosity, Elt_pore

*PORE PRESSURE

*TEMPERATURE

1Output of specified variables will be performed into the plot files.

2The time and/or step increment for output of plot files is specified in *CONTROLS keyword