contactgroups

Unless otherwise specified, data names are accessible in level 3 only.

activesuppressed
Returns non-zero if the entity is set inactive, 0 otherwise.
Type: integer
adjust
Returns true if adjust_value is defined, false otherwise.
Type: Boolean
adjust_value
A node set label or a value to adjust the initial positions of the surfaces.
Type: string
attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
color
The 1-64 color of the entity.
Type: integer
color_rgb
The RGB color of the entity.
Type: string
config
The configuration of the entity.
1 - BCTABL1 (for Nastran interface)
501 - ContactPair (for Abaqus interface)
502 - Tie (for Abaqus interface)
Type: unsigned integer
constraint_ratio
True if constraint_ratio_opt is defined, false otherwise.
Type: Boolean
constraint_ratio_value
Applies only when two surfaces with rotational degrees of freedom are tied with an offset, but the NO ROTATION parameter is used.
The fractional distance between the master reference surface and the slave node at which the translational constraint should act. By default, Abaqus will attempt to choose this distance such that the translational constraint acts precisely at the interface.
Type: double
coupled_slave_nodes
True if coupled_slave_nodes_opt is defined, false otherwise.
Type: Boolean
coupled_slave_nodes_opt
Used with surface-surface contact pairs. Abaqus automatically converts most serendipity elements that form a slave surface of a node-surface contact pair into elements with a midface node.
YES - Automatically convert most 3D second-order element types with no midface node (serendipity elements) that form a slave surface of a surface-surface contact pair into elements with a midface node.
NO - Do not add midface nodes to elements underlying the slave surface of a surface-surface contact pair (default).
Type: string
cpset
True if cpset_name is defined, false otherwise.
Type: Boolean
cpset_name
The name of the contact pair set to which the contact pairs being defined should be added. The CPSET name can be used to associate contact pairs with a *CLEARANCE option or with a *CONTACT CONTROLS option, which can be used to adjust algorithmic control parameters. It can also be used with the *CONTACT OUTPUT option to specify the contact pairs for which output database results are desired.
Type: string
cyclic_symmetry
This parameter applies only to Abaqus/Standard analyses.
If true, invokes a constraint between the faces bounding a repetitive sector of a cyclic symmetric structure. Can be used only in conjunction with the *CYCLIC SYMMETRY MODEL option.
Type: Boolean
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
entities
Returns the group entities referred by the contact group. Returns none if no groups are referred.
Type: entity array
extension_zone
True if extension_zone_value is defined, false otherwise.
Type: Boolean
extension_zone_value
The fraction of the end segment or facet edge length by which the master surface is to be extended to avoid numerical roundoff errors associated with contact modelling. The value given must lie between 0.0 and 0.2. The default is 0.1. This parameter affects only node-surface contact.
Type: double
geometric_correction
True if extension_zone_value is defined, false otherwise.
Type: Boolean
hcrit
True if hcrit_value is defined, false otherwise.
Type: Boolean
hcrit_value
The distance by which a point on the slave surface must penetrate the master surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value of HCRIT is half of the length of a characteristic element face on the slave surface. This parameter does not apply to contact pairs that use the finite-sliding, surface-surface contact formulation.
Type: double
id
The ID of the entity.
Type: unsigned integer
include
The ID of the include file the entity is organized in.
Type: entity
includeid
The ID of the include file the entity is organized in.
Type: unsigned integer
internalid
The ID of the entity.
Type: unsigned integer
ls_id
The ID of the referred load step.
Type: entity
mesh_constraint
True if mesh_constraint_opt is defined, false otherwise.
Type: Boolean
mesh_constraint_opt
The name of the method used to enforce the contact constraints.
KINEMATIC - Use the kinematic contact method (default)
PENALTY - Use the penalty contact method
Type: string
minimum_distance
True if minimum_distance_opt is defined, false otherwise.
Type: Boolean
minimum_distance_opt
Used only with the finite-sliding, surface-surface contact formulation.
YES - Automatically activate localized contact damping when nearby surfaces are initially touching at only a single point (default)
NO - Do not activate localized damping
Type: string
name
The name of the entity.
Type: string
no_rotation
If true, the rotation degrees of freedom should not be tied. If this is omitted, any existing rotation degrees of freedom will be tied if applicable, in addition to the translation degrees of freedom.
Type: Boolean
no_thickness
If true, ignore surface thickness effects in the contact calculations. This affects only contact formulations that account for surface thickness by default (it does not affect finite-sliding, node-surface contact).
Type: Boolean
num_group_entities
The number of group entities referenced by the contact group.
Type: unsigned integer
op
True if op_opt is defined, false otherwise.
Type: Boolean
op_opt
ADD - Add new contact pairs to the existing set of contact pairs (default)
DELETE - Remove the contact pairs from the active set of contact pairs
Type: string
outputsuppressed
Returns non-zero if the entity is set "do not export", 0 otherwise.
Type: integer
pick_chk_nset
True if pick_nset is defined, false otherwise.
Type: Boolean
pick_nset
The node set that includes the nodes on the slave surface that will be tied to the master surface. Nodes not included in this node set will not be tied.
Type: entity
position_tol_dist_value
The cut-off distance that is used to determine which nodes on the slave surface are tied to the master surface. The calculation of the distance between the slave and master surface for a particular slave-node depends on factors such as shell element thickness, the setting of the TYPE parameter, and the types of surfaces involved. Slave nodes that do not satisfy the position tolerance are not tied to the master surface. The default value for this tolerance distance depends on the type of formulation and surfaces used in the constraints.
Type: double
property_id
The surface smoothing property defined by *SURFACE SMOOTHING. This affects only surface-surface contact.
Type: entity
small_sliding
If true, indicates that the small-sliding contact formulation, rather than the finite-sliding contact formulation, should be used. This parameter is not allowed with self-contact.
Type: Boolean
smooth
True if smooth_value is defined, false otherwise.
Type: Boolean
smooth_value
The degree of smoothing used for element-based master surfaces in the finite-sliding, node-surface contact formulation. The value given must lie between 0.0 and 0.5. The default is 0.2. This parameter does not affect contact pairs with analytical rigid surfaces or contact formulations other than the finite-sliding, node-surface contact formulation.
Type: double
supplementary_constraints
True if supplementary_constraints_opt is defined, false otherwise.
Type: Boolean
supplementary_constraints_opt
SELECTIVE - Use a selective scheme of supplementary constraints (default)
YES - Add the supplementary contact constraints when applicable
NO - Forgo the supplementary contact constraints
Type: string
surface_interaction_group
The surface interaction group referred by the contact group. Returns none if no group is referred.
Type: entity
surface_interaction_prop
The surface interaction property referred by the contact group. Returns none if no property is referred.
Type: entity
Surface_type
True if type_opt is defined, false otherwise.
Type: Boolean
tie_options
NONE
POSITION TOLERANCE
TIED SET
Type: unsigned integer
tied
If true, indicates that the surfaces of this *CONTACT PAIR are to be tied together for the duration of the simulation. The ADJUST parameter is required when the TIED parameter is used. This parameter is not allowed with self-contact.
Type: Boolean
tracking
True if tracking_opt is defined, false otherwise.
Type: Boolean
tracking_opt
Controls which contact tracking algorithm is used for finite-sliding, surface-surface contact. It has no effect on contact pairs that use other formulations.
Set to PATH (default) to invoke a path-based contact tracking algorithm for finite-sliding, surface-surface contact.
Set to STATE to invoke a state-based contact tracking algorithm for finite-sliding, surface-surface contact.
Type: string
type_opt
Set to NODE TO SURFACE (default) to have the contact constraint coefficients generated according to the interpolation functions at the point where the slave node projects onto the master surface.
Set to SURFACE TO SURFACE to have the contact constraint coefficients generated such that stress accuracy is optimized for the specified surface type pairings. This parameter setting will be ignored for contact pairs that include a node-based surface.
Type: string
weight
True if weight_value is defined, false otherwise.
Type: Boolean
weight_value
The weighting factor for the contact surfaces.
Type: double

Version History

2017.1

2020 - Added new data names adjust, adjust_value, color_rgb, coupled_slave_nodes, coupled_slave_nodes_opt, constraint_ratio, constraint_ratio_value, cpset, cpset_name, cyclic_symmetry, extension_zone, extension_zone_value, geometric_correction, hcrit, hcrit_value, ls_id, mech_constraint, mech_constraint_opt, minimum_distance, minimum_distance_opt, no_rotation, no_thickness, num_group_entities, op, op_opt, pick_chk_nset, pick_nset, position_tol_dist_value, property_id, small_sliding, smooth, smooth_value, supplementary_constraints, supplementary_constraints_opt, surface_interaction_group, surface_interaction_prop, Surface_type, tie_options, tied, tracking, tracking_opt, type_opt, weight and weight_value. Added new config values 501 and 502.