9.0          ELEMENT DATA

 

9.1          Element Control Information

 

9.1.1       Define a Group of Elements

 

DEFINE_ELEMENT_GROUP

 

 

            DEFINE_ELEMENT_GROUP        name = " <string>" etc...

 

 

The elements may be read in groups. An element group is a collection of finite elements which model the same governing balance equation(s) within a region. This command must precede the element group data, and defines the element group control parameters as follows.

 

Note  Variable Name                   Type     Default      Description

 

          Name                                 string      [none]       Element group name.  Name must be
                                                                                       enclosed in quotation marks.

 

(1)      Group_number                 integer       [*]          Element group number (optional)

                                                                                       (Only active if Ndeath > Nbirth)

 

(2)      Multi_processing                 list         [off]        Multi-processing option

               on / off                             

 

           Element_type                      list        [none]       Element type

               continuum

               interface

               structural

               nodal

 

           Element_shape                    list        [none]       Element shape

               eight_node_brick

               twenty_node_brick

               six_node_wedge

               fifteen_node_wedge

               four_node_tetra

               ten_node_tetra

               four_node_quad

               eight_node_quad

               nine_node_quad

               three_node_tri

               six_node_tri

               two_node_line

               three_node_line

               one_node

 

 

 

                                                                                                                                               (cont’d)

 

(cont’d)

 

Note  Variable Name                      Type       Default       Description

 

           Element_name                        list         [none]        Element name:

 

• Continuum Type Elements

           QDC_Solid                                                                 See Section 9.2.0.1

           QDC_Fluid                                                                 See Section 9.2.0.2

           QDC_Stokes                                                               See Section 9.2.0.3

           QDC_Transport                                                          See Section 9.2.0.4

           QDC_Helmoltz                                                           See Section 9.2.0.5

           QDC_Ale                                                                    See Section 9.2.0.6

           QDC_Thermal                                                            See Section 9.2.0.7

           QDC_Heat                                                                  See Section 9.2.0.8

           QDC_Transport                                                          See Section 9.2.0.9

           QDC_Charge                                                              See Section 9.2.0.10

           QDC_Porous                                                              See Section 9.2.0.11

           QDC_Darcy                                                                See Section 9.2.0.12

           QDC_Pressure                                                            See Section 9.2.0.13

           cmi_QDCA                                                                 See Section 9.2.0.14

           QDC_MFlow                                                              See Section 9.2.0.15

           QDCP_Mixed                                                             See Section 9.2.0.16

           cmi_QDCS                                                                 See Section 9.2.0.17

           cmi_QDCP_Pressure                                                  See Section 9.2.0.18

           cmi_QDCZ                                                                 See Section 9.2.0.19

           Multi_Phase_Heat                                                      See Section 9.2.0.20

           QDC_Laplace                                                             See Section 9.2.0.21

           QDC_Stream                                                              See Section 9.2.0.22

           QDC_Level                                                                See Section 9.2.0.23

 

• Structural Type Elements

           Linear_Truss                                                               See Section 9.3.0.1.1

           Nonlinear_Truss                                                          See Section 9.3.0.1.2

           Linear_Beam                                                               See Section 9.3.0.2.1

           Nonlinear_Beam                                                         See Section 9.3.0.2.2

           Plate                                                                            See Section 9.3.0.3.1

           Shell_Plate                                                                  See Section 9.3.0.3.2

           Shell_Bilinear                                                              See Section 9.3.0.3.3

           Membrane                                                                   See Section 9.3.0.4

 

• Interface Type Elements

           Interface_Surface                                                       See Section 9.4

           Contact_Surface                                                         See Section 9.5

           Slide_Line                                                                   See Section 9.6

           Slide_Coulomb                                                           See Section 9.7

           Contact_Plane                                                             See Section 9.8

           Crack_Xfem                                                               See Section 9.9

           Level_Xfem                                                                See Section 9.10

           Multi_Point_Constraint                                              See Section 9.11

 

 

 

                                                                                                                                               (cont’d)

 

(cont’d)

 

Note  Variable Name                         Type    Default       Description

 

 

• Nodal Type Elements

           Nodal_Mass                                                                See Section 9.11.1

           Nodal_Damping                                                         See Section 9.11.2

           Nodal_Spring                                                              See Section 9.11.3

           Nodal_Reaction                                                          See Section 9.12

           Nodal_Link                                                                 See Section 9.13

           Nodal_Penalty                                                            See Section 9.14

           Nodal_Transmitting                                                    See Section 9.15

 

 

           Number_of_output_sets        integer      [0]           Number of field output histories

 

           Spatial_output                           list        [on]          Spatial field output

               on / off                                                                  

 

(3)      Material_model                       string    [none]        Name of material model to apply to

                                                                                             this element group.  Name must be

                                                                                          enclosed in quotation marks.

 

(4)      Number_of_material_sets      integer      [1]           Number of material sets  1

                                                                                             (Only required if material_model

                                                                                               is not specified.)

 

           Number_of_geometric_sets   integer      [0]           Number of geometric sets

 

(5)      Number_of_phases                integer      [1]           Number of fluid phases

 

(5)      Number_of_components       integer      [1]           Number of components

 

 

 

EXAMPLE

            Define_Element_Group  /

                  name = "group_name"  /

                  group_number = 1  /

                  element_type = continuum  /

                  element_shape = four_node_quad  /

                  material_model = "dummy" /

                  element_name = QDC_Porous  /

                        analysis_type = axisymmetric  /

                        strain_displacement = bbar_mean  /

                        number_of_output_sets = 1

 

Notes/

(1)        The element group number ("Neg") may be specified. If not specified, then Neg=Neg+1, where Neg is the number of the last element group entered.

 

(2)        This option allows multiprocessing of elemental arrays (e.g., using PVM and/or vectoriz­ations options).

 

(3)        The material model's name must have been previously defined by the command DEFINE_MATERIAL_MODEL (see Section 10.0.1).  Option restricted to continuum and structural type elements.

 

(4)        This option allows the material data to be specified within the element group data.

 

(5)        Only applicable to multi-phase problems.

 

 

 

9.1.2       Define a Region

 

DEFINE_REGION

 

 

            DEFINE_REGION        name = "<string>"     element_type = ... , etc...

 

 

A region is a collection of elements within the finite element mesh.  Each region describes a spatial domain within the problem.  Within a region, several element groups may be specified to model different governing balance equation(s) (e.g., by specifying that both the solid equation QDC_Solid, and the scalar diffusion equation QDC_Pressure be active within a region to model a saturated porous medium).  If within a region more than one equation type is specified, then each corresponding element group must be assigned to a different solution stagger (see Section 2.1).  After defining a region, the required governing equations within the region must be defined by specifying one or more element groups (see Section 9.1.2.1).

 

Note  Variable Name                   Type     Default      Description

 

            Name                               string      [none]       Region name.  Name must be enclosed

                                                                                       in quotation marks.

 

            Element_type                     list        [none]       Element type

                 continuum

                 structural

 

            Element_shape                   list        [none]       Element shape

                 eight_node_brick

                 twenty_node_brick

                 six_node_wedge

                 fifteen_node_wedge

                 four_node_tetra

                 ten_node_tetra

                 four_node_quad

                 eight_node_quad

                 nine_node_quad

                 three_node_tri

                 six_node_tri

                 two_node_line

                 three_node_line

                 one_node

 

            Analysis_type                    list       [plane]       Analysis type:

                 one_dimensional                                            One-dimensional

                 plane                                                             Two-dimensional / plane strain

                 axisymmetric                                                 Axisymmetric

                 three_dimensional                                         Three-dimensional

 

 

 

                                                                                                                                               (cont’d)

(cont’d)

 

Note Variable Name                    Type     Default      Description

 

(1)     Multi_processing                  list         [off]        Multi-processing option

              on / off                               

 

         Number_of_output_sets    integer       [0]          Number of field output histories

 

         Spatial_output                      list         [on]         Spatial field output

              on / off                                                            

 

(2)     Material_model                  string      [none]       Name of material model to apply to

                                                                                       this region.  Name must be

                                                                                       enclosed in quotation marks.

 

(3)     Number_of_material_sets integer       [1]          Number of material sets  1

                                                                                       (Only required if material_model

                                                                                         is not specified.)

 

(4)      Number_of_phases             integer         [1]           Number of fluid phases

 

(4)      Number_of_components    integer         [1]           Number of components

 

 

 

EXAMPLE

            Define_Region  /

                  name = "region_name"  /

                  element_type = continuum  /

                  element_shape = four_node_quad  /

                  analysis_type = axisymmetric  /

                  number_of_output_sets = 1  /

                  material_model = "dummy"

 

                  Element_Group  /

                        name = "stress_equation"  /

                        element_name = QDC_solid  /

                        strain_displacement = bbar_mean 

 

                  Element_Group  /

                        name = "pressure_equation"  /

                        element_name = QDC_pressure 

 

Notes/

(1)        This option allows multiprocessing of elemental arrays (e.g., using PVM and/or vectorizations options).

 

(2)        The material model's name must have been previously defined by the command DEFINE_MATERIAL_MODEL (see Section 10.0.1).  Option restricted to continuum and structural type elements.

 

 

(3)        This option allows the material data to be specified within the region.

 

(4)        Only applicable to multi-phase problems.

 

9.1.2.1       Element Group

 

ELEMENT_GROUP

 

 

            ELEMENT_GROUP        name = "<string>"     group_number = neg , etc...

 

 

The command is used to specify a governing balance equation(s) within a region.

 

Note  Variable Name                   Type     Default      Description

 

           Name                                 string      [none]       Element group name.  Name must be
                                                                                       enclosed in quotation marks.

 

(1)      Group_number                 integer       [*]          Element group number (optional)

 

           Element_name                     list        [none]       Element name:

 

• Continuum Type Elements

           QDC_Solid                                                                 See Section 9.2.0.1

           QDC_Fluid                                                                 See Section 9.2.0.2

           QDC_Stokes                                                               See Section 9.2.0.3

           QDC_Transport                                                          See Section 9.2.0.4

           QDC_Helmoltz                                                           See Section 9.2.0.5

           QDC_Ale                                                                    See Section 9.2.0.6

           QDC_Thermal                                                            See Section 9.2.0.7

           QDC_Heat                                                                  See Section 9.2.0.8

           QDC_Transport                                                          See Section 9.2.0.9

           QDC_Charge                                                              See Section 9.2.0.10

           QDC_Porous                                                              See Section 9.2.0.11

           QDC_Darcy                                                                See Section 9.2.0.12

           QDC_Pressure                                                            See Section 9.2.0.13

           cmi_QDCA                                                                 See Section 9.2.0.14

           QDC_MFlow                                                              See Section 9.2.0.15

           QDCP_Mixed                                                             See Section 9.2.0.16

           cmi_QDCS                                                                 See Section 9.2.0.17

           cmi_QDCP_Pressure                                                  See Section 9.2.0.18

           cmi_QDCZ                                                                 See Section 9.2.0.19

           Multi_Phase_Heat                                                      See Section 9.2.0.20

           QDC_Laplace                                                             See Section 9.2.0.21

           QDC_Stream                                                              See Section 9.2.0.22

           QDC_Level                                                                See Section 9.2.0.23

 

 

 

                                                                                                                                               (cont’d)

 

 

(cont’d)

 

Note  Variable Name                   Type     Default      Description

 

 

• Structural Type Elements

           Linear_Truss                                                               See Section 9.3.0.1.1

           Nonlinear_Truss                                                          See Section 9.3.0.1.2

           Linear_Beam                                                               See Section 9.3.0.2.1

           Nonlinear_Beam                                                         See Section 9.3.0.2.2

           Plate                                                                            See Section 9.3.0.3.1

           Shell_Plate                                                                  See Section 9.3.0.3.2

           Shell_Bilinear                                                              See Section 9.3.0.3.3

           Membrane                                                                   See Section 9.3.0.4

 

 

Notes/

 

(1)               The element group number ("Neg") may be specified.  If not specified, then Neg=Neg+1, where Neg is the number of the last element group entered.