gcgen#

Mapdl.gcgen(option='', featureangle='', edgekey='', splitkey='', selopt='', **kwargs)[source]#

Creates contact elements for general contact.

APDL Command: GCGEN

Parameters:
option

Option to be performed.

NEW - Create a new general contact definition. This option removes all existing

general contact elements and generates new elements with new section IDs. Any existing GCDEF specifications, general contact SECTYPE/SECDATA data, and general contact element types are also removed. If no general contact elements or data exist, this option behaves the same as Option = UPDATE.

UPDATE - Generate general contact elements on newly added (or selected) base elements.

Newly generated contact elements are assigned new Section IDs. Existing general contact elements remain with their previously assigned section IDs and element attributes. Existing GCDEF and SECTYPE/SECDATA general contact data are respected. (This is the default option.)

DELETE - Remove all existing general contact elements. Existing GCDEF specifications,

general contact SECTYPE/SECDATA data, and general contact element types are also removed.

SELECT - Select all existing general contact elements.

featureangle

Angle tolerance for determining feature edges (EdgeKEY) and general surfaces (SplitKey). Default = 42 degrees.

edgekey

Key that controls creation of general contact line elements (CONTA177) on base shell element perimeter edges and/or base solid element feature edges. See Understanding FeatureANGLE for an explanation of the feature edge criteria.

0 - Exclude feature edges and shell perimeter edges (default).

1 - Include feature edges only.

2 - Include shell perimeter edges only.

3 - Include both feature edges and shell perimeter edges.

splitkey

Key that controls how section IDs and contact element type IDs are assigned to surfaces.

SPLIT - Assign a different section ID and contact element type ID for every general

surface of the selected base elements (default). See Understanding FeatureANGLE for an explanation of the split criteria. Different section IDs are assigned to top and bottom surfaces of 2-D beam and 3-D shell bodies. This allows different GCDEF specifications for different portions of the assembly.

PART - Assign a different section ID and contact element type ID for every general

surface which covers a physical part. Compared to the SPLIT option, this option produces fewer unique section IDs, which can make it easier to specify interactions via GCDEF. However, it may also result in a less accurate and/or less efficient solution.

selopt

Key that controls which base elements are considered for general contact.

ATTACH - Use a recursive adjacency selection to obtain complete physical parts, starting

from the selected base elements, before generating general contact elements (default).

SELECT - Use only the initially selected base elements to generate general contact

elements.

Notes

GCGEN creates general contact elements on the exterior faces of selected base elements. The base elements can be 2-D or 3-D solids, 2-D beams (top and bottom), or 3-D shells (top and bottom). The contact element types can be CONTA172, CONTA174, and/or CONTA177, depending upon the types of base elements in the model and the specified GCGEN options. General contact elements are identified by a real constant ID equal to zero.

You can control contact interactions between specific general contact surfaces that could potentially be in contact by using the GCDEF command. See General Contact in the Contact Technology Guide for more information on the overall procedure to create general contact.

Understanding FeatureANGLE

The exterior facets of the selected base solid and shell elements are divided into subsets based on the angle between the normals of neighboring faces. On a flat or smooth surface, adjacent exterior element faces have normals that are parallel or nearly parallel; that is, the angle between the adjacent normals is near zero degrees.

When the angle between the normals of two adjacent faces is greater than FeatureANGLE, the two faces are considered to be on two separate surfaces (SplitKey = SPLIT). The edge between the faces may be convex or concave. A convex (or outside) edge is considered to be a feature edge and may be affected by the EdgeKEY setting. For more information, see Feature Angle (FeatureANGLE) in the Contact Technology Guide.