Spatial_grid_output

Contents

Data Structure: Spatial_grid_output
Description	Defines data for output of model data on spatial grid
Usage	Spatial_grid_output NUM=ival where ival is the data structure number

Description

Overview

Spatial_grid_output defines data for output of the current model data on spatial grid.

Active_flag Active flag

Usage

Active_flag

Integer Value

Description

Defines whether the depth update 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 the output grid

Usage

Name

Character Name

Description

Defines the name of the output grid

Grid_assignment Name of the pre-defined grid to be used for output

Usage

Grid_assignment

Character Name

Description

Name of the pre-defined grid to be used for output. Valid grid types are:

• "Mesh" - Values output for the current input mesh (default)

• "Define_Grid_Name" - Name of the input grid specified using Spatial_grid. In this case the data is output on a grid not a mesh or group basis.

File_name Name of file for spatial grid data

Usage

File_name

Character Name

Description

Name of the file for spatial grid data. The file name should be defined without a file extension. The default file name is project_gridname.dat

Stage_name_flag Flag defining whether the stage name should be appended to the output file name

Usage

Stage_name_flag

Integer Value

Description

Flag defining whether the stage name should be appended to the output file name. Valid values are:

• 0 - Do not append stage name (default)

• 1 - Append stage name to output file

Grid_name_flag Flag defining whether the grid name should be appended to the output file name

Usage

Grid_name_flag

Integer Value

Description

Flag defining whether the grid name should be appended to the output file name. Valid values are:

• 0 - Do not append grid name

• 1 - Append grid name (default)

File_format Format of the geometry file

Usage

File_format

Character Name

Description

The format of the output file can be either:

• "hdf" - Output in .hdf file format

• "ASCII" - Output a .spat ASCII file using standard ParaGeo keywords (Default).

Units List of unit names

Usage

Units		IDM=ival
Character Names
where	ival	Number of Spatial grid output units or groups

Description

List of Spatial grid output unit names to be used for Spatial grid output (default all groups)

Group_numbers List of element groups (Optional)

Usage

Group_numbers		IDM=ival
Integer Values
where	ival	Number of Spatial grid output units or groups

Description

List of element groups to be used for Spatial grid output (default all groups)

Groups List of element group names

Usage

Groups		IDM=ival
Character Names
where	ival	Number of Spatial grid output units or groups

Description

List of element groups to be used for Spatial grid output (default all groups)

Element_variables List of element centre variables

Usage

Element_variables		IDM=ival
Character Names
where	ival	Number of element variables

Description

List of element centre variables

Fracture_set Name of the fracture set to be used to output the fracture state

Usage

Fracture_set

Character Name

Description

Name of the fracture set to be used to output the fracture state

Fracture_variables List of nodal variables

Usage

Fracture_variables		IDM=ival
Character Names
where	ival	Number of nodal variables

Description

List of fracture variables for group.

Notes

•The available fracture variables is dependent on the fracture model (see fracture_set for details)

•The fracture orientiation can be defined by defining the components of the fracture direction cosine matrix where

mat_sys_001

Where in 3-D

mat_sys_002

where vz defines the fracture normal direction ( vn ).

and in 2-D

mat_sys_003

where vy defines the fracture normal direction ( vn ).

•Either just the components of vn may be specified or the complete fracture orientation matrix

Element_output_type Output type for element values on a regular grid

Usage

Element_output_type

Character Name

Description

Output type of element/fracture values if the values are output on a regular grid. Valid types are:

• "Point" - Values output at grid points (default)

• "Cell" - Values output at cell centres

Nodal_variables List of nodal variables

Usage

Nodal_variables		IDM=ival
Character Names
where	ival	Number of nodal variables

Description

List of nodal variables for group

Node_output_type Output type for nodal values on a regular grid

Usage

Node_output_type

Character Name

Description

Output type of nodal values if the values are output on a regular grid. Valid types are:

• "Point" - Values output at grid points (default)

• "Cell" - Values output at cell centres

Reference_sets List of reference sets to be output

Usage

Reference_sets		IDM=ival
Character Names
where	ival	Number of reference sets

Description

List of reference sets to be output. The the variables defined on the reference set will be output

Notes

•The variable list for output must contain a varaible only once. Therefore if several reference sets are selected they should contain different variables

Spatial_grids List of spatial grids

Usage

Spatial_grids		IDM=ival
Character Names
where	ival	Number of spatial grids

Description

List of spatial grids for output

Geometry_entity_flag Flag to output the geometry entity number for each element in a group

Usage

Geometry_entity_flag

Integer Value

Description

Flag to output the geometry entity number (2-D: Surface, 3-D: Volume) for each element in a group. Valid types are:

• 0 - Do not output geomtry entity numbers (default)

• 1 - Output geomtry entity numbers

Mesh_topo_format Flag defining output format for mesh topology

Usage

Mesh_topo_format

Integer Value

Description

Flag to define the type of spatial grid format being output. The valid output formats are dependent on the selected File_format and those are: ASCII grids

• 0 - Standard element topology output in a Spatial_grid_group data structure (default)

• 2 - Topology output in grid data (ASCII or HDF5) (This format cannot be read by ParaGeo: i.e. for output only)

• 3 - Element labels only (ASCII or HDF5)

• 4 - Node labels only (ASCII or HDF5)

• 5 - Topology output in grid "mesh_external" type (ASCII only)

HDF grids

• 2 - Topology output in grid data (ASCII or HDF5) (This format cannot be read by ParaGeo: i.e. for output only)

• 3 - Element labels only (ASCII or HDF5)

• 4 - Node labels only (ASCII or HDF5)

Start_time Start time for grid data output

Usage

Start_time

Real Value

Description

Start time for grid data output

End_time End time for grid data output

Usage

End_time

Real Value

Description

End time for grid data output

Increment_time Increment time for grid data output

Usage

Increment_time

Real Value

Description

Increment time for grid data output

Null_value Value identifying that the grid value is not set

Usage

Null_value

Real Value

Description

The Null_value Value identifying that the grid value is not set. In this case any element or node where the mapped value includes a contribution from a null value, then the value for the element or node will not be mapped. The null value can therefore be used to assign values to part of a group.