History_surface

Contents

Data Structure: History_surface
Description	History data for surfaces (lines 2-D, surfaces 3-D)
Usage	History_surface NUM=ival where ival is the data structure number

Description

Overview

The History_surface data structure allows creation of time history sets of results associated with a group of entities that define a surface (i.e. a group of lines in 2-D or a group of surfaces in 3-D). The time history data is written as an ASCII file in comma delimited column format to:

datafile_number.hdh

where datafile is the data file name for the model and number is the history set number.

Notes

•Several History_surface data structures may be specified and additional sets may be added during the analysis

•History_point and History_surface data structures use the same file type for output so that a unique history set number must be specified; i.e. History_point and History_surface data structures with the same number is not permitted.

Examples

demonstrating the usage of History_surface include:

•Civan_2d3n_001.dat

•elts_2d4n_013c.dat

•matp_2d4n_005.dat

Active_flag History surface active flag

Usage

Active_flag

Integer Value

Description

Defines whether the history surface set is active. Generally not required as it is set by default. Valid values are:

•-1 - Deactivate and remove if defined

• 0 - Not defined

• 1 - Defined and active

Name Name of history set

Usage

Name

Character Name

Description

Name of surface history set (maximum 32 characters)

Output_frequency_increment Increment output frequency

Usage

Output_frequency_increment

Integer Value

Description

The number of time steps between each output to the history file.

Notes

•If both incremental output frequency Output_frequency_increment and Output_frequency_time are specified then both will be used

•Output will always be performed at the end of a control step

Output_frequency_time Time output frequency

Usage

Output_frequency_time

Real Value

Description

The time between each output to the history file

Notes

•If both incremental output frequency Output_frequency_increment and Output_frequency_time are specified then both will be used

•Output will always be performed at the end of a control step

Lines List of lines

Usage

Lines		IDM=ival
Integer Values
where	ival	Number of lines forming surface in 2-D

Description

List of lines defining the history surface in 2-D

Surfaces List of Surfaces

Usage

Surfaces		IDM=ival
Integer Values
where	ival	Number of surfaces forming surface in 3-D

Description

List of Surfaces defining the history surface in 3-D

Geometry_sets List of geometry sets defining history surface

Usage

Geometry_sets		IDM=ival
Character Names
where	ival	Number of geometry sets

Description

The Geometry_sets keyword assigns the history surface to all lines (2-D) and surfaces (3-D) in the specified geometry sets

Average_values List of average values

Usage

Average_values		IDM=ival
Character Names
where	ival	Number of average variables

Description

Labels defining the average values that may be output to the history file. Valid labels are:

• Pore_nod - Average pore pressure for the surface in porous flow field

• Disp_x - Average displacement in X direction

• Disp_y - Average displacement in Y direction

• Disp_z - Average displacement in Z direction

• Strs_xx - Average XX-component of stress

• Strs_yy - Average YY-component of stress

• Strs_zz - Average ZZ-component of stress

• Strs_xy - Average XY-component of stress

• Strs_yz - Average YZ-component of stress

• Strs_zx - Average ZX-component of stress

• C_strsnm - Contact Normal Total stress

• C_strsne - Contact Normal Effective stress

• C_strstn - Contact Tangential stress

• C_nrm_pn - Contact Normal Stiffness

• C_nrm_gn - Contact Normal Penetration

• C_tng_pn - Contact Tangential Stiffness

• C_slip_f - Contact Slip Stick

• C_frict - Contact Friction Coefficient

• C_cohes - Contact Cohesion

• C_sl_cum - Contact Cumulative Slip

• C_sl_net - Contact Net Slip

• C_sl_max - Contact Max. Net Slip

• C_adh_pn - Contact Adhesion Penalty

• C_adh_sr - Contact Adhesion Stress

• C_adh_yd - Contact Adhesion Strength

• C_gn_max - Contact Maximum Gap

• C_qprat - Contact Effective Stress Ratio

• C_pslip - Contact Nonlinear (Plastic) Slip

• C_apert - Contact Aperture

• C_apr_0 - Contact Initial Aperture (only applicable to Aperture_model 2)

• C_width - Contact Width

• C_tfl_co - Contact Tangential Conductivity

Sum_values List of sum values

Usage

Sum_values		IDM=ival
Character Names
where	ival	Number of sum variables

Description

Labels defining the summed values that may be output to the history file. Valid labels are:

•None at present

Integration_values List of integration values

Usage

Integration_values		IDM=ival
Character Names
where	ival	Number of sum variables

Description

Labels defining the Integrated values that may be output to the history file. Valid labels are:

• Fluvol - Fluid volume passing through the surface. When Fluvol is specified three values are output:

• Fluvol_inc - The incremental fluid volume since the last history output

• Fluvol_tot - The total fluid volume passing through the surface

• Fluflx - The current average fluid flow rate though the surface

Output_point_flag Flag for output all point values on the surface

Usage

Output_point_flag

Integer Value

Description

Flag for output all point values on the surface. Valid values are:

• 0 - Do not output values

• 1 - Output values at every history output

•-1 - Output values at end of a stage

Point_values List of additional point output data.

Usage

Point_values		IDM=ival
Character Names
where	ival	Number of geometry sets

Description

List of additional point output data. Valid values are:

• "Coord_x" - X-ordinate of node

• "Coord_y" - Y-ordinate of node

• "Coord_z" - Z-ordinate of node

• "Depth" - Depth of node

Contact_point_values List of contact point output values

Usage

Contact_point_values		IDM=ival
Character Names
where	ival	Number of geometry sets

Description

List of contact point output values. Valid values are:

• Coord_x - X-ordinate of node

• Coord_y - Y-ordinate of node

• Coord_z - Z-ordinate of node

• Depth - Depth of node

• C_strsnm - Contact Normal Total stress

• C_strsne - Contact Normal Effective stress

• C_strstn - Contact Tangential stress

• C_nrm_pn - Contact Normal Stiffness

• C_nrm_gn - Contact Normal Penetration

• C_tng_pn - Contact Tangential Stiffness

• C_slip_f - Contact Slip Stick

• C_frict - Contact Friction Coefficient

• C_cohes - Contact Cohesion

• C_sl_cum - Contact Cumulative Slip

• C_sl_net - Contact Net Slip

• C_sl_max - Contact Max. Net Slip

• C_adh_pn - Contact Adhesion Penalty

• C_adh_sr - Contact Adhesion Stress

• C_adh_yd - Contact Adhesion Strength

• C_gn_max - Contact Maximum Gap

• C_qprat - Contact Effective Stress Ratio

• C_pslip - Contact Nonlinear (Plastic) Slip

• C_apert - Contact Aperture

• C_apr_0 - Contact Initial Aperture (only applicable to Aperture_model 2)

• C_width - Contact Width

• C_tfl_co - Contact Tangential Conductivity

Output_name_flag Flag defining name of output file

Usage

Output_name_flag

Integer Value

Description

Flag for output all point values on the surface. Valid values are:

• 0 - Include a history file number in output file name (default)

• 1 - Include set name in output file name

Output_topology_flag Flag defining where the topology for the surface should be output

Usage

Output_topology_flag

Integer Value

Description

Flag defining where the topology for the surface should be output. Valid values are:

• 0 - Do not output topology (default)

• 1 - Output topology

Contact_state_flag Flag defining where points not in contact should be output

Usage

Contact_state_flag

Integer Value

Description

Flag defining where points not in contact should be output. Valid values are:

• 0 - Do not output data for points not in contact (default)

• 1 - Output data for all points with targets