contactgroups
Unless otherwise specified, data names are accessible in level 3 only.
- activesuppressed
- Returns non-zero if the entity is set inactive, 0 otherwise.
- adjust
- Returns true if adjust_value is defined, false otherwise.
- 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:
- 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:
- adjust_type
- Specifies whether adjust is defined by real value or by infinite value. Valid values are:
- adjust_val
- The adjust value for secondary node with respect to main surface when adjust_type is 1. Valid values are:
- adjust_val_real
- The adjust value for secondary node with respect to main surface when adjust_type is 0.
- adjust_value
- A node set label or a value to adjust the initial positions of the surfaces.
- attributesmax
- The number of attributes owned by this entity.
- auto_shrink
- Defines the resolution of penetration:
- clearance
- Defines the clearance that replaces the initial geometry calculated clearance:
- color
- The 1-64 color of the entity.
- color_rgb
- The RGB color of the entity.
- config
- The configuration of the entity.
- constraint_ratio
- True if constraint_ratio_opt is defined, false otherwise.
- 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.
- constraint_type
- Defines the type of contact constraint:
- constraint_type_explicit
- Defines the type of contact constraint for explicit dynamic analysis:
- coupled_slave_nodes
- True if coupled_slave_nodes_opt is defined, false otherwise.
- coupled_slave_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.
- cpset
- True if cpset_name is defined, false otherwise.
- 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.
- critical_penetration
- The critical penetration value.
- cyclic_symmetry
- This parameter applies only to Abaqus/Standard analyses.
- definedentity
- True if the entity is defined, false otherwise.
- entities
- Returns the contact pairs referred by the contact group. Returns none if no pairs are referred.
- extension_zone
- True if extension_zone_value is defined, false otherwise.
- 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.
- formulation
- Defines the type of contact formulation:
- friction_id
- The ID of the friction assoicated with the contact group.
- geometric_correction
- True if extension_zone_value is defined, false otherwise.
- hcrit
- True if hcrit_value is defined, false otherwise.
- 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.
- id
- The ID of the entity.
- include
- The ID of the include file the entity is organized in.
- includeid
- The ID of the include file the entity is organized in.
- initial_state
- Defines the type of initial contact state:
- initial_state_tol
- Specifies the initial tolerance to determine the initial contact state.
- interference
- Specifies the assumed interference value the main is moved by in the normal direction.
- internalid
- The ID of the entity.
- ls_id
- The ID of the referred load step.
- mesh_constraint
- True if mesh_constraint_opt is defined, false otherwise.
- mesh_constraint_opt
- The name of the method used to enforce the contact constraints.
- minimum_distance
- True if minimum_distance_opt is defined, false otherwise.
- minimum_distance_opt
- Used only with the finite-sliding, surface-surface contact formulation.
- moduleid
- The module ID of the entity.
- name
- The name of the entity.
- 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.
- 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).
- num_group_entities
- The number of group entities referenced by the contact group.
- op
- True if op_opt is defined, false otherwise.
- op_opt
- ADD - Add new contact pairs to the existing set of contact pairs (default)
- outputsuppressed
- Returns non-zero if the entity is set "do not export", 0 otherwise.
- penalty_scale_factor
- Defines the penalty scale factor.
- penalty_scale_factor_explicit
- Defines the penalty scale factor for explicit dynamic analysis.
- pick_chk_nset
- True if pick_nset is defined, false otherwise.
- 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.
- poolid
- The pool number of the entity.
- poolname
- The pool name of the entity.
- 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.
- property_id
- The surface smoothing property defined by *SURFACE SMOOTHING. This affects only surface-surface contact.
- reference_value_ratio
- Defines the mixing ration of reference values.
- 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.
- search_depth
- Defines the search distance on the penetrating side in the normal direction.
- search_gap
- Defines the search distance in the normal direction to detect contact.
- search_width
- Defines the search distance in the in-plane direction to detect contact.
- 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.
- smooth
- True if smooth_value is defined, false otherwise.
- 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.
- solver_id
- The solver ID of the entity.
- solverkeyword
- The name of the solver keyword.
- supplementary_constraints
- True if supplementary_constraints_opt is defined, false otherwise.
- supplementary_constraints_opt
- SELECTIVE - Use a selective scheme of supplementary constraints (default)
- surface_behavior
- Specifies the contact detection:
- surface_interaction_group
- The surface interaction group referred by the contact group. Returns none if no group is referred.
- surface_interaction_prop
- The surface interaction property referred by the contact group. Returns none if no property is referred.
- Surface_type
- True if type_opt is defined, false otherwise.
- tie_options
- NONE
- 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.
- tracking
- True if tracking_opt is defined, false otherwise.
- 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.
- tying_type
- Specifies whther the tying is rigid or not (empty):
- type
- Defines the changing slip property:
- 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.
- use_thickness
- When specified, the gap is corrected by considering the thickness of the shell and membrane elements:
- weight
- True if weight_value is defined, false otherwise.
- weight_value
- The weighting factor for the contact surfaces.
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.
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.