Contact

Class Contact()

Contact(parent='MODEL', name='Contact_n', label='Contact_n', active=True, contact_type='IMPACT',
coulomb_friction='OFF', force_loc='ELEM_CENTER', create_zero_sensor=False, r_value=0.01, create_hmax_sensor=False,
contact_hmax=0.0001, stiffness=1000, exponent=2.1, damping=0.1, dmax=0.1, penalty=5000, rest_coeff=0.8,
normal_trans_vel=1, use_aug_formulation=True, i_bulk_modulus=160000, j_bulk_modulus=160000, 
i_shear_modulus=160000, j_shear_modulus=160000, i_layer_depth=1000, j_layer_depth=1000, mat_exponent=2.1, 
mat_damping=1, b1=None, b2=None, ig=None, jg=None, ig_material_inside=[False], jg_material_inside=[False], 
mu_static=0.2, mu_dynamic=0.1, stiction_trans_vel=1, friction_trans_vel=1.5)

Contacts add a contact force between multiple graphics where the graphics represent the bodies' outer surfaces.

Keyword Arguments

Argument	Data Type	Description	Default
name	String	The variable name.	Contact_n, for next available integer n.
label	String	The descriptive label.	Contact_n, for next available integer n.
parent	Object	The parent.	MODEL
active	Boolean	Used to activate or deactivate this entity.	True
contact_type	Enum	The contact type. One of "IMPACT", "POISSON", "USER" or "VOLUME".	"IMPACT"
coulomb_friction	Enum	The type of coulomb friction. One of OFF, ON, DYNAMIC_ONLY or USER.	"OFF"
force_loc	Enum	The location at which force is computed. One of ELEM_CENTER or NODE.	"ELEM_CENTER"
create_zero_sensor	Bool	When TRUE, it creates a zero crossing Sensor to accurately capture the time of first contact for a model containing contact elements. This is useful in getting realistic contact forces without having to run the entire simulation at a small step size. To do this, the sensor monitors the contact force for a contact pair in the model. As soon as contact is first detected, the zero crossing action is triggered.	False
r_value	Double	Max step size scale factor. Defaults to 0.01. * create_hmax_sensor (Bool) : When TRUE, specifies the action that the zero crossing Sensor is to undertake when it detects contact (in other words, a zero crossing). The action, in this case, is to reduce the maximum step size the integrator can take.	False
contact_hmax	Double	New maximum step size. Defaults to 0.0001. * stiffness (Double) : Applicable for contact_type IMPACT. Specifies the value of the stiffness associated with the contact force.	1000
exponent	Double	Applicable for contact_type IMPACT. Specifies the value of the exponent for stiffness.	2.1
damping	Double	Applicable for contact_type IMPACT. Specifies the value of the damping coefficient.	0.1
dmax	Double	Applicable for contact_type IMPACT. Specifies the value of the maximum penetration depth before full damping is applied.	0.1
penalty	Double	Determines the local stiffness properties between materials. Larger values lead to reduced penetration between two bodies. Used with the Poisson method of normal force calculation.	5000
rest_coeff	Double	The value representing the energy loss between the two bodies in contact. A value of one represents no energy loss and a perfectly elastic contact. Used with the Poisson method of normal force calculation.	0.8
normal_trans_vel	Double	The normal transition velocity.	1
use_aug_formulation	Bool	Used for the ADAMS solvermode only, to use the augmented Lagrangian formulation.	True
i_bulk_modulus	Double	Bulk modulous of I Body material.	160000
j_bulk_modulus	Double	Bulk modulous of JBody material.	160000
i_shear_modulus	Double	Shear modulous of I Body material.	160000
j_shear_modulus	Double	Shear modulous of J Body material.	160000
i_layer_depth	Double	Depth of material layer of the I Body to be considered for contact force.	1000
j_layer_depth	Double	Depth of material layer of the J Body to be considered for contact force.	1000
mat_exponent	Double	The exponent of the force deformation characteristic of the contact interface. Defaults to 2.1 * mat_damping (Double) : The coefficient of damping used to calculate the damping force.	1
b1	Body	The first body in the contact force definition.	None
b2	Body	The second body in the contact force definition.	None
ig	Graphic	The python handles of graphic entities on the first body to be used for the contact force. Defaults to None. * jg (Graphic) : The varname of graphic entities on the second body to be used for the contact force.	None
ig_material_inside	Bool	List of booleans which indicate whether there is material inside for every graphic associated with body 1.	[False]
jg_material_inside	Bool	List of booleans which indicate whether there is material inside for every graphic associated with body 2.	[False]
mu_static	Double	The coefficient of friction when the slip velocity is less than stiction_trans_vel.	0.2
mu_dynamic	Double	The coefficient of friction when the slip velocity is greater than friction_trans_vel. Defaults to 0.1 * stiction_trans_vel (Double) : The value where the coefficient of friction becomes ^mu_dynamic^. When the slip velocity is between stiction_trans_vel and friction_trans_vel, the coefficient of friction is in transition between the two.	1
friction_trans_vel	Double	The value where the coefficient of friction becomes mu_dynamic. When the slip velocity is between stiction_trans_vel and friction_trans_vel, the coefficient of friction is in transition between the two.	1.5
usr_sub	Function	The expression passed to the user dll for normal force value. When using solver expressions, Templex syntax (within ``) is used and all variables are enclosed in braces {} and the rest is treated as literal.	'USER()'
local_funcname	String	The function/subroutine name for normal force value.	'CNFSUB'
use_local_dll	Bool	Uses a local function instead of default for normal force if True.	False
local_dll	File	The path of the local dll for normal force which has the local_funcname.	''
local_func_type	Enum	The type of the user subroutine of normal force. One of DLL, PYTHON or MATLAB.	'DLL'
friction_usr_sub	Function	The expression passed to the user dll for friction force value. When using solver expressions, Templex syntax (within ``) is used and all variables are enclosed in braces {} and the rest is treated as literal.	'USER()'
friction_local_funcname	String	The function/subroutine name for friction force value.	'CFFSUB'
friction_use_local_dll	Bool	Uses a local function instead of default for friction force if True.	False
friction_local_dll	File	The path of the local dll for normal force which has the local_funcname.	''
friction_local_func_type	Enum	The type of the user subroutine of friction force. One of DLL, PYTHON or MATLAB.	'DLL'

Readonly Properties

Argument	Data Type	Description	Default
user	Bool	Is True when 'contact_type' is "USER" else False.	False
friction_user	Bool	Is True when 'coulomb_friction' is "USER" else False.	False