57.7 ConnectorFriction object

The ConnectorFriction object defines Coulomb-like or hysteretic friction behavior for one or more components of a connector's relative motion.

The ConnectorFriction object is derived from the ConnectorBehaviorOption object.

Access

sectionApi.sections()[name].behaviorOptions(i)

57.7.1 ConnectorFriction(...)

This method creates a connector friction behavior option for a ConnectorSection object. Depending upon the arguments provided, the friction behavior can be Coulomb-like or hysteretic in nature.

Path

sectionApi.sections()[name].ConnectorFriction

Prototype

odb_ConnectorFriction&
ConnectorFriction(const odb_String& frictionModel,
   const odb_String& slipStyle,
   odb_Union tangentDirection,
   odb_Union stickStiffness,
   const odb_String& componentType,
   bool slipDependency,
   bool temperatureDependency,
   int dependencies,
   bool useContactForceComponent,
   const odb_String& contactForceStyle,
   int contactForceComponent,
   const odb_String& forcePotentialOperator,
   double forcePotentialExponent,
   const odb_SequenceConnectorPotential& connectorPotentials,
   const odb_SequenceSequenceDouble& table,
   const odb_SequenceInt& independentComponents);

Required arguments

None.

Optional arguments

frictionModel

An odb_String specifying the desired frictional response model. Possible values are "PREDEFINED" and "USER_CUSTOMIZED". The default value is "PREDEFINED".

slipStyle

An odb_String specifying the method of indicating the slip direction: either specified or computed based upon the force potential data. Possible values are "SPECIFY" and "COMPUTE". The default value is "SPECIFY".
This argument is applicable only if frictionModel="USER_CUSTOMIZED".

tangentDirection

The string "NONE" or an Int specifying the direction for which the frictional behavior is specified. Possible values are 1 tangentDirection 6, indicating an available component of relative motion. This argument applies only if frictionModel="USER_CUSTOMIZED" and if slipStyle="SPECIFY". The default value is "NONE".

stickStiffness

The string "NONE" or a Double specifying the stick stiffness associated with the frictional behavior in the direction specified by tangentDirection. If this argument is omitted, Abaqus computes an appropriate number for the stick stiffness. The default value is "NONE".

componentType

An odb_String specifying the type of the independentComponents. Possible values are "POSITION", "MOTION", and "NO_INDEPENDENT_COMPONENTS". The default value is "NO_INDEPENDENT_COMPONENTS".

slipDependency

A Boolean specifying whether the table data depend on accumulated slip. The default value is false.
This argument applies only if frictionModel="USER_CUSTOMIZED".

temperatureDependency

A Boolean specifying whether the table data depend on temperature. The default value is false.
This argument applies only if frictionModel="USER_CUSTOMIZED".

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.
This argument applies only if frictionModel="USER_CUSTOMIZED".

useContactForceComponent

A Boolean specifying whether the contact force component will be defined. The default value is false.
This argument applies only if frictionModel="USER_CUSTOMIZED".

contactForceStyle

An odb_String specifying the method of indicating the contact force component direction: either specified or computed based on upon a DerivedComponent. Possible values are "COMPONENT_NUMBER" and "DERIVED_COMPONENT". The default value is "COMPONENT_NUMBER".
This argument is applicable only if frictionModel="USER_CUSTOMIZED" and if useContactForceComponent=true.

contactForceComponent

An Int specifying the contact force component direction. This argument applies only if frictionModel="USER_CUSTOMIZED", if useContactForceComponent=true, and if contactForceStyle="COMPONENT_NUMBER". The default value is 0.

forcePotentialOperator

An odb_String specifying the contribution operator for the force potential contributions. Possible values are "SUM" and "MAXIMUM". The default value is "SUM".
This argument is applicable only if frictionModel="USER_CUSTOMIZED" and if slipStyle="COMPUTE".

forcePotentialExponent

A Double specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.
This argument is applicable only if frictionModel="USER_CUSTOMIZED", if slipStyle="COMPUTE", and if forcePotentialOperator="SUM".

connectorPotentials

A sequence of ConnectorPotential objects specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if frictionModel="USER_CUSTOMIZED", and if slipStyle="COMPUTE".

table

An odb_SequenceSequenceDouble specifying friction properties. The default value is an empty sequence.
If frictionModel="PREDEFINED", each sequence of the table data specifies:
If applicable, the first geometric scaling constant relevant to frictional interactions.
Etc., up to as many geometric scaling constants as are associated with this connection type.
Internal contact force/moment generating friction in the first predefined slip direction.
If applicable, internal contact force/moment generating friction in the second predefined slip direction.
Connector constitutive relative motion in the direction specified by independentComponent.
Accumulated slip in the first predefined slip direction, if the data depend on accumulated slip.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.

If frictionModel="USER_CUSTOMIZED", each sequence of the table data specifies:
Effective radius of the cylindrical or spherical surface over which frictional slip occurs in the connector associated with frictional effects in the direction specified by tangentDirection. This radius is relevant only if the connection type includes an available rotational component of relative motion and tangentDirection="SLIP_DIRECTION".
Internal contact force/moment generating friction in the direction specified by tangentDirection.
Connector constitutive relative motion in the direction specified by independentComponent.
Accumulated slip in the direction specified by tangentDirection, if the data depend on accumulated slip.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.

independentComponents

An odb_SequenceInt specifying the independent components. Possible values are 1 independentComponents 6. In addition, each independent component value must be unique. The independentComponents argument applies only if frictionModel="USER_CUSTOMIZED". Only available components can be specified. The default value is an empty sequence.

Return value

A ConnectorFriction object.

Exceptions

ValueError and TextError.

57.7.2 setValues(...)

This method modifies the ConnectorFriction object.

Required arguments

None.

Optional arguments

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

Return value

None

Exceptions

ValueError.

57.7.3 Members

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

In addition, the ConnectorFriction object can have the following members:

Prototype

odb_TangentialBehavior tangentialBehavior() const;
odb_DerivedComponent derivedComponent() const;
odb_ConnectorOptions options() const;

tangentialBehavior

A TangentialBehavior object.

derivedComponent

A DerivedComponent object specifying the DerivedComponent used to compute the contact force component direction. This argument applies only if frictionModel="USER_CUSTOMIZED", if useContactForceComponent=true, and if contactForceStyle="DERIVED_COMPONENT".

options

A ConnectorOptions object specifying the ConnectorOptions used to define tabular options for this ConnectorBehaviorOption.

57.7.4 Corresponding analysis keywords

*CONNECTOR FRICTION, *FRICTION, *CONNECTOR POTENTIAL, *CONNECTOR DERIVED COMPONENT