MechanicalContactConstraint

under construction:Undocumented Class

The MechanicalContactConstraint has not been documented. The content contained on this page includes the basic documentation associated with a MooseObject; however, what is contained is ultimately determined by what is necessary to make the documentation clear for users.

!syntax description /Constraints/MechanicalContactConstraint

Input Parameters

  • nodal_areaThe nodal area

    C++ Type:std::vector

    Options:

    Description:The nodal area

  • slaveThe slave boundary

    C++ Type:BoundaryName

    Options:

    Description:The slave boundary

  • componentAn integer corresponding to the direction the variable this kernel acts in. (0 for x, 1 for y, 2 for z)

    C++ Type:unsigned int

    Options:

    Description:An integer corresponding to the direction the variable this kernel acts in. (0 for x, 1 for y, 2 for z)

  • master_variableThe variable on the master side of the domain

    C++ Type:std::vector

    Options:

    Description:The variable on the master side of the domain

  • masterThe boundary ID associated with the master side

    C++ Type:BoundaryName

    Options:

    Description:The boundary ID associated with the master side

  • variableThe name of the variable that this constraint is applied to.

    C++ Type:NonlinearVariableName

    Options:

    Description:The name of the variable that this constraint is applied to.

  • boundaryThe master boundary

    C++ Type:BoundaryName

    Options:

    Description:The master boundary

Required Parameters

  • formulationdefaultThe contact formulation

    Default:default

    C++ Type:std::string

    Options:

    Description:The contact formulation

  • tension_release0Tension release threshold. A node in contact will not be released if its tensile load is below this value. No tension release if negative.

    Default:0

    C++ Type:double

    Options:

    Description:Tension release threshold. A node in contact will not be released if its tensile load is below this value. No tension release if negative.

  • al_frictional_force_toleranceThe tolerance of the frictional force for augmented Lagrangian method.

    C++ Type:double

    Options:

    Description:The tolerance of the frictional force for augmented Lagrangian method.

  • connected_slave_nodes_jacobianTrueWhether to include jacobian entries coupling nodes connected to slave nodes.

    Default:True

    C++ Type:bool

    Options:

    Description:Whether to include jacobian entries coupling nodes connected to slave nodes.

  • execute_onLINEARThe list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM.

    Default:LINEAR

    C++ Type:ExecFlagEnum

    Options:NONE INITIAL LINEAR NONLINEAR TIMESTEP_END TIMESTEP_BEGIN FINAL CUSTOM

    Description:The list of flag(s) indicating when this object should be executed, the available options include NONE, INITIAL, LINEAR, NONLINEAR, TIMESTEP_END, TIMESTEP_BEGIN, FINAL, CUSTOM.

  • tangential_toleranceTangential distance to extend edges of contact surfaces

    C++ Type:double

    Options:

    Description:Tangential distance to extend edges of contact surfaces

  • al_penetration_toleranceThe tolerance of the penetration for augmented Lagrangian method.

    C++ Type:double

    Options:

    Description:The tolerance of the penetration for augmented Lagrangian method.

  • penalty1e+08The penalty to apply. This can vary depending on the stiffness of your materials

    Default:1e+08

    C++ Type:double

    Options:

    Description:The penalty to apply. This can vary depending on the stiffness of your materials

  • normal_smoothing_methodMethod to use to smooth normals (edge_based|nodal_normal_based)

    C++ Type:std::string

    Options:

    Description:Method to use to smooth normals (edge_based|nodal_normal_based)

  • capture_tolerance0Normal distance from surface within which nodes are captured

    Default:0

    C++ Type:double

    Options:

    Description:Normal distance from surface within which nodes are captured

  • friction_coefficient0The friction coefficient

    Default:0

    C++ Type:double

    Options:

    Description:The friction coefficient

  • displacementsThe displacements appropriate for the simulation geometry and coordinate system

    C++ Type:std::vector

    Options:

    Description:The displacements appropriate for the simulation geometry and coordinate system

  • disp_zThe z displacement

    C++ Type:std::vector

    Options:

    Description:The z displacement

  • disp_yThe y displacement

    C++ Type:std::vector

    Options:

    Description:The y displacement

  • disp_xThe x displacement

    C++ Type:std::vector

    Options:

    Description:The x displacement

  • normalize_penaltyFalseWhether to normalize the penalty parameter with the nodal area for penalty contact.

    Default:False

    C++ Type:bool

    Options:

    Description:Whether to normalize the penalty parameter with the nodal area for penalty contact.

  • stick_lock_iterations4294967295Number of times permitted to switch between sticking and slipping in a solution before locking node in a sticked state.

    Default:4294967295

    C++ Type:unsigned int

    Options:

    Description:Number of times permitted to switch between sticking and slipping in a solution before locking node in a sticked state.

  • print_contact_nodesFalseWhether to print the number of nodes in contact.

    Default:False

    C++ Type:bool

    Options:

    Description:Whether to print the number of nodes in contact.

  • master_slave_jacobianTrueWhether to include jacobian entries coupling master and slave nodes.

    Default:True

    C++ Type:bool

    Options:

    Description:Whether to include jacobian entries coupling master and slave nodes.

  • normal_smoothing_distanceDistance from edge in parametric coordinates over which to smooth contact normal

    C++ Type:double

    Options:

    Description:Distance from edge in parametric coordinates over which to smooth contact normal

  • non_displacement_variables_jacobianTrueWhether to include jacobian entries coupling with variables that are not displacement variables.

    Default:True

    C++ Type:bool

    Options:

    Description:Whether to include jacobian entries coupling with variables that are not displacement variables.

  • al_incremental_slip_toleranceThe tolerance of the incremental slip for augmented Lagrangian method.

    C++ Type:double

    Options:

    Description:The tolerance of the incremental slip for augmented Lagrangian method.

  • stick_unlock_factor1.5Factor by which frictional capacity must be exceeded to permit stick-locked node to slip again.

    Default:1.5

    C++ Type:double

    Options:

    Description:Factor by which frictional capacity must be exceeded to permit stick-locked node to slip again.

  • modelfrictionlessThe contact model to use

    Default:frictionless

    C++ Type:std::string

    Options:

    Description:The contact model to use

  • orderFIRSTThe finite element order

    Default:FIRST

    C++ Type:MooseEnum

    Options:CONSTANT FIRST SECOND THIRD FOURTH

    Description:The finite element order

Optional Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector

    Options:

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Options:

    Description:Set the enabled status of the MooseObject.

  • use_displaced_meshTrueWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:True

    C++ Type:bool

    Options:

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

References