Spatial_state_set

Contents

Data Structure: Spatial_state_set
Description	Spatial variation state
Usage	Spatial_state_set NUM=ival where ival is the data structure number

Description

Overview

The Spatial_state_set data structure defines the assignment of spatial variations to element and state variables. If a file containing the spatial variation grid needs to be read, the data structure Include must be used indicating the file name. If the mesh of the current application and the mesh of the spatial grid differ, an interpolation operation will be used to map the spatial variation of the variables. The Spatial_state_set data structure may be used in order to define the volumetric strain and maximum strain direction in order to perform a directional decompaction during restoration.

Name Name of the spatial state set

Usage

Name

Character Name

Description

Name of the spatial state set (Maximum of 32 characters)

Spatial_variation Name of the spatial variation to be used to assign the material state

Usage

Spatial_variation

Character Name

Description

Name of the spatial variation to be used to assign the material state

Spatial_variation_number Number ID of the spatial variation to be used to assign the material state

Usage

Spatial_variation_number

Integer Value

Description

Number ID of the spatial variation to be used to assign the material state

Spatial_grid Name of the spatial grid to be used to assign the material state

Usage

Spatial_grid

Character Name

Description

Name of the spatial grid to be used to assign the material state.

Spatial_grid_number Number ID of the spatial grid to be used to assign the material state

Usage

Spatial_grid_number

Integer Value

Description

Number ID of the spatial grid to be used to assign the material state.

Group_numbers List of element group numbers for assignment of the spatial state (optional)

Usage

Group_numbers		IDM=ival
Integer Values
where	ival	Number of groups

Description

List of element groups by number for assignment of the spatial state. If neither Group_numbers nor Groups are defined the spatial state set will be used to define the variable state for all groups.

Groups List of element group names for assignment of the spatial state (optional)

Usage

Groups		IDM=ival
Character Names
where	ival	Number of groups

Description

List of element groups by name for assignment of the spatial state. If neither Group_numbers nor Groups are defined the spatial state set will be used to define the variable state for all groups.

Element_variables List of element variables

Usage

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

Description

List of element variables that will be assigned a state.

Element_variable_assignment List of element variable assignments

Usage

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

Description

List of names of variables defined in the spatial variation/grid that are equivalent to the ParaGeo state variable names defined using Element_variables. For example ParaGeo element variable "Porosity" could be assigned a variable defined in the grid as "Phi" in Element_variable_assignment. If Element_variable_assignment is not defined then it is assumed that the ParaGeo element variable and the spatial variation/grid variable names are identical.

Notes

•The material orientiation for orthotropic materials 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

State_variables List of nodal variables

Usage

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

Description

List of state variables that will be assigned a state.

State_variable_assignment List of state variable assignments

Usage

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

Description

List of names of variables defined in the spatial variation/grid that are equivalent to the ParaGeo state variable names defined using State_variables. For example ParaGeo state variable "P_strnXX" (plastic strain in the X direction) could be assigned a variable defined in the grid as "P_XX" in State_variable_assignment. If State_variable_assignment is not defined then it is assumed that the ParaGeo state variable and the spatial variation/grid variable names are identical.

Nodal_variables List of nodal or point variables

Usage

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

Description

List of nodal or point variables defined in the grid as "Nodal_variables" or "Point_variables" that will be assigned a state.

Nodal_variable_assignment List of nodal variable assignments

Usage

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

Description

List of names of variables defined in the spatial variation/grid that are equivalent to the ParaGeo nodal variable names defined using Nodal_variables. For example ParaGeo nodal variable "Temp_nod" (nodal temperature) could be assigned a variable defined in the grid as "T_nodal" in Nodal_variable_assignment. If Nodal_variable_assignment is not defined then it is assumed that the ParaGeo nodal variable and the spatial variation/grid variable names are identical.

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

Usage

Fracture_set

Character Name

Description

Name of the fracture set to be used to assign 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 to be assigned a state.

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

Fracture_variable_assignment List of state variable assignments

Usage

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

Description

List of names of variables defined in the spatial variation/grid that are equivalent to the ParaGeo fracture variable names defined using Fracture_variables. For example ParaGeo fracture variable "F_space" (fracture spacing) could be assigned a variable defined in the grid as "Frac_Spac" in Fracture_variable_assignment. If Fracture_variable_assignment is not defined then it is assumed that the ParaGeo fracture variable and the spatial variation/grid variable names are identical.

Decompaction_flag Flag to indicate that directional decompaction initialisation should be performed

Usage

Decompaction_flag

Integer Value

Description

Flag to indicate that directional decompaction initialisation should be performed. Valid values are:

• 0 - No directional decompaction initialisation

• 1 - Initialise directional decompaction

Mapping_type Type of the mapping for spatial grid

Usage

Mapping_type

Character Name

Description

Type of the mapping for spatial grid :

• "Default" - 2D to 2D or 3D to 3D mapping

• "3d_to_2d" - 3D grid to 2D mesh mapping

Reference_location_3d_grid Reference location in 3D grid

Usage

Reference_location_3d_grid		IDM=ival
Real Values
where	ival	Number of dimensions for 3D grid reference

Description

Reference location (X, Y and Z coordinates) in the 3D grid. The values from the 3D grid will be mapped to the 2D mesh after appliying the rotation defined by the assigned Coordinate_system and performing a translation so that the Reference_location_3d_grid is located to the specified Reference_location_mesh point.

Reference_location_mesh Reference location in 2D mesh

Usage

Reference_location_mesh		IDM=ival
Real Values
where	ival	Number of dimensions for 2D mesh reference

Description

Defines the reference location (X and Y coordinates) in 2D mesh. The values from the 3D grid will be mapped to the 2D mesh after appliying the rotation defined by the assigned Coordinate_system and performing a translation so that the Reference_location_3d_grid is located to the specified Reference_location_mesh point.

The default values are X =0.0 Y =0.0

Coordinate_system Coordinate system number

Usage

Coordinate_system

Integer Value

Description

The Coordinate_system keyword is used to assign a coordinate system (by its ID number)to the 3D grid.