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_to_clearance
Specification to avoid elements to collapse while moving their nodes by the adjust function. This is ignored if adjust is not mentioned. Valid values are:
yes
no
Type: string
adjust_to_interference
Specification to avoid elements to collapse while moving their nodes by the adjust function. This is ignored if adjust is not mentioned. Valid values are:
yes
no
Type: string
adjust_type
Specifies whether adjust is defined by real value or by infinite value. Valid values are:
0 - Real number
1 - Infinite value
Type: integer
adjust_val
The adjust value for secondary node with respect to main surface when adjust_type is 1. Valid values are:
yes
Type: string
adjust_val_real
The adjust value for secondary node with respect to main surface when adjust_type is 0.
Type: double
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
auto_shrink
Defines the resolution of penetration:
Yes
No
Type: string
clearance
Defines the clearance that replaces the initial geometry calculated clearance:
Type: double
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 - Nastran BCTABL1
501 - Abaqus *ContactPair
502 - Abaqus *Tie
601 - ADVC $ContactPair
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 main reference surface and the secondary 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
constraint_type
Defines the type of contact constraint:
Lagrange
Penalty
Type: string
constraint_type_explicit
Defines the type of contact constraint for explicit dynamic analysis:
Kinematic
Penalty
Type: string
coupled_secondary_nodes
True if coupled_secondary_nodes_opt is defined, false otherwise.
Type: Boolean
coupled_secondary_nodes_opt
Used with surface-surface contact pairs. Abaqus automatically converts most serendipity elements that form a secondary 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 secondary surface of a surface-surface contact pair into elements with a midface node.
NO - Do not add midface nodes to elements underlying the secondary 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
critical_penetration
The critical penetration value.
Type: double
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 contact pairs referred by the contact group. Returns none if no pairs 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 main 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
film_id
The ID of the physical quantity defined as a heat convection coefficient or a film coefficient. By this specification, the contact property becomes a heat convection contact.
Type: entity
formulation
Defines the type of contact formulation:
NodeToSegment
SegmentToSegment
Type: string
friction_id
The ID of the friction assoicated with the contact group.
Type: entity
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 secondary surface must penetrate the main 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 secondary 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
initial_state
Defines the type of initial contact state:
Auto
Close
Open
Type: string
initial_state_tol
Specifies the initial tolerance to determine the initial contact state.
Type: double
interference
Specifies the assumed interference value the main is moved by in the normal direction.
Type: double
internalid
The ID of the entity.
Type: unsigned integer
internalname
The internal name of the entity.
Type: string
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
moduleid
The module ID of the entity.
Type: integer
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
penalty_scale_factor
Defines the penalty scale factor.
Type: double
penalty_scale_factor_explicit
Defines the penalty scale factor for explicit dynamic analysis.
Type: double
pick_chk_nset
True if pick_nset is defined, false otherwise.
Type: Boolean
pick_nset
The node set that includes the nodes on the secondary surface that will be tied to the main surface. Nodes not included in this node set will not be tied.
Type: entity
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
position_tol_dist_value
The cut-off distance that is used to determine which nodes on the secondary surface are tied to the main surface. The calculation of the distance between the secondary and main surface for a particular secondary-node depends on factors such as shell element thickness, the setting of the TYPE parameter, and the types of surfaces involved. Secondary nodes that do not satisfy the position tolerance are not tied to the main 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
reference_value_ratio
Defines the mixing ration of reference values.
Type: double
search_angle
Defines the search angle between the outbound normal vector of the main surface and the inbound normal vector of the secondary surface, in radians.
Type: double
search_depth
Defines the search distance on the penetrating side in the normal direction.
Type: double
search_gap
Defines the search distance in the normal direction to detect contact.
Type: double
search_width
Defines the search distance in the in-plane direction to detect contact.
Type: double
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 main 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
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
solvername
The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
Type: string
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_behavior
Specifies the contact detection:
NoSeparation
Separation
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
tying_type
Specifies whther the tying is rigid or not (empty):
Rigid
Type: string
type
Defines the changing slip property:
FiniteSliding
NotSliding
ShearTying
SmallTying
Tying
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 secondary node projects onto the main 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
use_thickness
When specified, the gap is corrected by considering the thickness of the shell and membrane elements:
No
Yes
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_secondary_nodes, coupled_secondary_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.

2020.1 - Added new data names adjust_to_clearance, adjust_to_interference, adjust_type, adjust_val, adjust_val_real, auto_shrink, clearance, constraint_type, constraint_type_explicit, critical_penetration, formulation, friction_id, initial_state, initial_state_tol, interference, penalty_scale_factor, penalty_scale_factor_explicit, reference_value_ratio, search_angle, search_depth, search_gap, search_width, solverkeyword, surface_behavior, tying_type, type and use_thickness. Added new config value 601.

2021.1 - Added new data names moduleid, poolid, poolname, and solver_id.

2021.2 - Added new data names film_id, internalname, and solvername.