25.53 NormalBehavior object

The NormalBehavior object specifies normal behavior for a contact interaction property.

Access
import interaction
mdb.models[name].interactionProperties[name].normalBehavior


25.53.1 NormalBehavior(...)

This method creates a NormalBehavior object.

Path
mdb.models[name].interactionProperties[name].NormalBehavior

Required arguments

None.

Optional arguments

contactStiffness

The SymbolicConstant DEFAULT or a Float specifying the contact stiffness. This argument is valid for pressureOverclosure=LINEAR. This argument is also valid for pressureOverclosure=HARD when constraintEnforcementMethod=AUGMENTED_LAGRANGE or PENALTY. A value of DEFAULT is valid only when the later conditions are met. A value of zero is equivalent to specifying DEFAULT. The default value is DEFAULT.

pressureOverclosure

A SymbolicConstant specifying the pressure-overclosure relationship to be used. Possible values are HARD, EXPONENTIAL, LINEAR, TABULAR, and SCALE_FACTOR. The default value is HARD.

allowSeparation

A Boolean specifying whether to allow separation after contact. The default value is ON.

maxStiffness

None or a Float specifying the maximum stiffness. If maxStiffness=None, there is no upper limit. The default value is None.

table

A sequence of sequences of Floats specifying the normal behavior properties. This argument is valid only for pressureOverclosure=EXPONENTIAL or TABULAR. The items in the table data are described below.

constraintEnforcementMethod

A SymbolicConstant specifying the method for enforcement of the contact constraint. Possible values are DEFAULT, AUGMENTED_LAGRANGE, PENALTY, and DIRECT. The default value is DEFAULT.

overclosureFactor

A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) as a percentage of the minimum element size in the contact region. The default value is 0.0.

overclosureMeasure

A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) directly. The default value is 0.0.

contactStiffnessScaleFactor

A Float specifying scale factor for the penalty stiffness or the geometric scaling of the "base" stiffness. The default value is 1.0.

initialStiffnessScaleFactor

A Float specifying an additional scale factor for the "base" default contact stiffness. The default value is 1.0.

clearanceAtZeroContactPressure

A Float specifying the clearance at which the contact pressure is zero. The default value is 0.0.

stiffnessBehavior

A SymbolicConstant specifying the type of penalty stiffness to be defined. This argument is valid only when constraintEnforcementMethod=PENALTY. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.

stiffnessRatio

A Float specifying the ratio of the initial stiffness divided by the final stiffness. This argument is valid only when stiffnessBehavior=NONLINEAR. Possible values are 0 stiffnessRatio 1. The default value is 0.01.

upperQuadraticFactor

A Float specifying the ratio of the overclosure at the maximum stiffness divided by the characteristic facet length. This argument is valid only when stiffnessBehavior=NONLINEAR. The default value is 0.03.

lowerQuadraticRatio

A Float specifying the ratio of the overclosure at the initial stiffness divided by the overclosure at the maximum stiffness, both relative to the clearance at which the contact pressure is zero. This argument is valid only when stiffnessBehavior=NONLINEAR. Possible values are 0 stiffnessRatio 1. The default value is 0.33333.

Table data

If pressureOverclosure=EXPONENTIAL, the table data specify the following:

  • Pressure at zero clearance, .

  • Clearance at which the contact pressure is zero, .

If pressureOverclosure=TABULAR, the table data specify the following:
  • Pressure.

  • Overclosure.

Return value

A NormalBehavior object.

Exceptions

None.


25.53.2 setValues(...)

This method modifies the NormalBehavior object.

Required arguments

None.

Optional arguments

The optional arguments to setValues are the same as the arguments to the NormalBehavior method.

Return value

None

Exceptions

None.


25.53.3  Members

The NormalBehavior object has members with the same names and descriptions as the arguments to the NormalBehavior method.


25.53.4  Corresponding analysis keywords

*SURFACE BEHAVIOR