Connector#

A connector describes the relative motions between two points. A connector also describes the behavior associated with the relative motion.

Create connectors#

ConnectorSection.ConnectorDamage(coupling: SymbolicConstantType = 'UNCOUPLED', criterion: SymbolicConstantType = 'FORCE', initiationTemperature: BooleanType = 0, initiationPotentialOperator: SymbolicConstantType = 'SUM', initiationPotentialExponent: float = 2, initiationDependencies: int = 0, evolution: BooleanType = 1, evolutionType: SymbolicConstantType = 'MOTION_TYPE', softening: SymbolicConstantType = 'LINEAR', useAffected: BooleanType = 0, degradation: SymbolicConstantType = 'MAXIMUM', evolutionTemperature: BooleanType = 0, evolutionDependencies: int = 0, evolutionPotentialOperator: SymbolicConstantType = 'SUM', evolutionPotentialExponent: float = 2, initiationPotentials: ConnectorPotentialArray | None = None, evolutionPotentials: ConnectorPotentialArray | None = None, initiationTable: tuple = (), evolutionTable: tuple = (), affectedComponents: tuple = (), components: tuple = ())[source]#

This method creates a connector damage behavior option for a ConnectorSection object.

Parameters:
coupling

A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

criterion

A SymbolicConstant specifying the damage initiation criterion to be used. Possible values are FORCE, MOTION, and PLASTIC_MOTION. The default value is FORCE.

initiationTemperature

A Boolean specifying whether the initiation data depend on temperature. The default value is OFF.

initiationPotentialOperator

A SymbolicConstant specifying the contribution operator for the initiation potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is only if *coupling*=COUPLED and if *criterion*=FORCE or MOTION.

initiationPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the initiation potential definition. The default value is 2.0.This argument is applicable only if *coupling*=COUPLED, when *initiationPotentialOperator*=SUM, and when *criterion*=FORCE or MOTION.

initiationDependencies

An Int specifying the number of field variable dependencies for the initiation data. The default value is 0.

evolution

A Boolean specifying whether damage evolution data will be used. The default value is ON.

evolutionType

A SymbolicConstant specifying the type of damage evolution to be specified. Possible values are MOTION_TYPE and ENERGY_TYPE. The default value is MOTION_TYPE.This argument is applicable only if *evolution*=ON.

softening

A SymbolicConstant specifying the damage evolution law to be specified. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.This argument is applicable only if *evolution*=ON and when *evolutionType*=MOTION_TYPE.

useAffected

A Boolean specifying whether or not affectedComponents will be specified. If useAffected*=OFF, then only the components of relative motion specified by *components will undergo damage. The default value is OFF.This argument is applicable only if *evolution*=ON.

degradation

A SymbolicConstant specifying the contribution of each damage mechanism when more than one damage mechanism is defined. Possible values are MAXIMUM and MULTIPLICATIVE. The default value is MAXIMUM.This argument is applicable if *evolution*=ON.

evolutionTemperature

A Boolean specifying whether the evolution data depend on temperature. The default value is OFF.This argument is applicable only if *evolution*=ON.

evolutionDependencies

An Int specifying the number of field variable dependencies for the evolution data. The default value is 0.This argument is applicable only if *evolution*=ON.

evolutionPotentialOperator

A SymbolicConstant specifying the contribution operator for the evolution potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if *coupling*=COUPLED, when *evolution*=ON, when *evolutionType*=MOTION_TYPE, and when *criterion*=FORCE or MOTION.

evolutionPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the evolution potential definition. The default value is 2.0.This argument is applicable only if *coupling*=COUPLED, when *evolution*=ON, when *evolutionPotentialOperator*=SUM, when *evolutionType*=MOTION, and when *criterion*=FORCE or MOTION.

initiationPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution. This member can be specified only if *coupling*=COUPLED and if *criterion*=FORCE or MOTION.

evolutionPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution). This member can be specified only if *coupling*=COUPLED, if *evolution*=ON, if *evolutionType*=MOTION, and if *criterion*=FORCE or MOTION.

initiationTable

A sequence of sequences of Floats specifying the initiation properties. The default value is an empty sequence.Items in the initiationTable data are described below.

evolutionTable

A sequence of sequences of Floats specifying the evolution properties. The default value is an empty sequence.Items in the evolutionTable data are described below. This argument is only applicable if *evolution*=ON.

affectedComponents

A sequence of Ints specifying the components of relative motion that will be damaged. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. This argument is applicable only if *evolution*=ON and *useAffected*=ON. The default value is an empty sequence.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. This argument can be specified only if *coupling*=UNCOUPLED. The default value is an empty sequence.

Returns:
A ConnectorDamage object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamage
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamage
ConnectorSection.ConnectorDamping(behavior: SymbolicConstantType = 'LINEAR', coupling: SymbolicConstantType = 'UNCOUPLED', dependencies: int = 0, temperatureDependency: BooleanType = 0, frequencyDependency: BooleanType = 0, table: tuple = (), independentComponents: tuple = (), components: tuple = ())[source]#

This method creates a connector damping behavior option for a ConnectorSection object.

Parameters:
behavior

A SymbolicConstant specifying if the damping behavior is linear or nonlinear. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.

coupling

A SymbolicConstant specifying whether the damping behavior is coupled between the connector’s components of relative motion. If *behavior*=LINEAR, then possible values are UNCOUPLED and COUPLED. If *behavior*=NONLINEAR, then possible values are UNCOUPLED, COUPLED_POSITION, and COUPLED_MOTION. Possible values are UNCOUPLED, COUPLED, COUPLED_POSITION, and COUPLED_MOTION. The default value is UNCOUPLED.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if *behavior*= LINEAR and *coupling*=UNCOUPLED. The default value is OFF.

table

A sequence of sequences of Floats specifying damping properties. Items in the table data are described below. The default value is an empty sequence.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector damping data. This argument is applicable only if *behavior*=NONLINEAR and *coupling*=COUPLED_POSITION or COUPLED_MOTION. When this argument is applicable, at least one value must be specified. Only available components can be specified. The default value is an empty sequence.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. The default value is an empty sequence.

Returns:
A ConnectorDamping object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamping
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamping
ConnectorSection.ConnectorElasticity(behavior: SymbolicConstantType = 'LINEAR', coupling: SymbolicConstantType = 'UNCOUPLED', dependencies: int = 0, temperatureDependency: BooleanType = 0, frequencyDependency: BooleanType = 0, table: tuple = (), independentComponents: tuple = (), components: tuple = ())[source]#

This method creates a connector elasticity behavior option for a ConnectorSection object.

Parameters:
behavior

A SymbolicConstant specifying whether the elastic behavior is linear, nonlinear, or rigid. Possible values are LINEAR, NONLINEAR, and RIGID. The default value is LINEAR.

coupling

A SymbolicConstant specifying whether the elastic behavior is coupled between the connector’s components of relative motion. If *behavior*=LINEAR, then possible values are UNCOUPLED and COUPLED. If *behavior*=NONLINEAR, then possible values are UNCOUPLED, COUPLED_POSITION, and COUPLED_MOTION. Possible values are UNCOUPLED, COUPLED, COUPLED_POSITION, and COUPLED_MOTION. The default value is UNCOUPLED.This argument is not applicable if *behavior*=RIGID.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0.This argument is not applicable if *behavior*=RIGID.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.This argument is not applicable if *behavior*=RIGID.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if *behavior*=LINEAR and *coupling*=UNCOUPLED. The default value is OFF.This argument is not applicable if *behavior*=RIGID.

table

A sequence of sequences of Floats specifying elasticity properties. Items in the table data are described below. This argument is not applicable if *behavior*=RIGID. The default value is an empty sequence.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector elasticity data. This argument is applicable only if *behavior*=NONLINEAR and *coupling*=COUPLED_POSITION or COUPLED_MOTION. If this argument is applicable, at least one value must be specified. Only available components can be specified. The default value is an empty sequence.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. The default value is an empty sequence.

Returns:
A ConnectorElasticity object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorElasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorElasticity
ConnectorSection.ConnectorFailure(releaseComponent: SymbolicConstantType = 'ALL', minMotion: float | None = None, maxMotion: float | None = None, minForce: float | None = None, maxForce: float | None = None, components: tuple = ())[source]#

This method creates a connector failure behavior option for a ConnectorSection object.

Parameters:
releaseComponent

The SymbolicConstant ALL or an Int specifying the motion components that fail. If an Int is specified, only that motion component fails when the failure criteria are satisfied. If *releaseComponent*=ALL, all motion components fail. The default value is ALL.

minMotion

None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

maxMotion

None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

minForce

None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

maxForce

None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. The default value is an empty sequence.

Returns:
A ConnectorFailure object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFailure
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFailure
ConnectorSection.ConnectorFriction(frictionModel: SymbolicConstantType = 'PREDEFINED', slipStyle: SymbolicConstantType = 'SPECIFY', tangentDirection: int | None = None, stickStiffness: float | None = None, componentType: SymbolicConstantType = 'NO_INDEPENDENT_COMPONENTS', slipDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, useContactForceComponent: BooleanType = 0, contactForceStyle: SymbolicConstantType = 'COMPONENT_NUMBER', contactForceComponent: int = 0, forcePotentialOperator: SymbolicConstantType = 'SUM', forcePotentialExponent: float = 2, connectorPotentials: ConnectorPotentialArray | None = None, table: tuple = (), independentComponents: tuple = ())[source]#

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.

Parameters:
frictionModel

A SymbolicConstant specifying the desired frictional response model. Possible values are PREDEFINED and USER_CUSTOMIZED. The default value is PREDEFINED.

slipStyle

A SymbolicConstant 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

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

None or a Float 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

A SymbolicConstant 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 OFF.This argument applies only if *frictionModel*=USER_CUSTOMIZED.

temperatureDependency

A Boolean specifying whether the table data depend on temperature. The default value is OFF.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 OFF.This argument applies only if *frictionModel*=USER_CUSTOMIZED.

contactForceStyle

A SymbolicConstant 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*=ON.

contactForceComponent

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

forcePotentialOperator

A SymbolicConstant 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 Float 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 ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if *frictionModel*=USER_CUSTOMIZED, and if *slipStyle*=COMPUTE.

table

A sequence of sequences of Floats 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

A sequence of Ints 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.

Returns:
A ConnectorFriction object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFriction
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFriction
ConnectorSection.ConnectorLock(lockingComponent: SymbolicConstantType = 'ALL', minMotion: float | None = None, maxMotion: float | None = None, minForce: float | None = None, maxForce: float | None = None, components: tuple = ())[source]#

This method creates a connector lock behavior option for a ConnectorSection.

Parameters:
lockingComponent

The SymbolicConstant ALL or an Int specifying the motion components that are locked. If an Int is specified, only that motion component is locked when the locking criteria are satisfied. If *lockingComponent*=ALL, all motion components are locked. The default value is ALL.

minMotion

None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

maxMotion

None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

minForce

None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

maxForce

None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. The default value is an empty sequence.

Returns:
A ConnectorLock object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorLock
import odbConnectorBehavior
odbConnectorBehavior.ConnectorLock
ConnectorSection.ConnectorPlasticity(coupling: SymbolicConstantType = 'UNCOUPLED', isotropic: BooleanType = 1, isotropicType: SymbolicConstantType = 'TABULAR', isotropicTemperature: BooleanType = 0, isotropicDependencies: int = 0, kinematic: BooleanType = 0, kinematicType: SymbolicConstantType = 'HALF_CYCLE', kinematicTemperature: BooleanType = 0, kinematicDependencies: int = 0, forcePotentialOperator: SymbolicConstantType = 'SUM', forcePotentialExponent: float = 2, connectorPotentials: ConnectorPotentialArray | None = None, isotropicTable: tuple = (), kinematicTable: tuple = (), components: tuple = ())[source]#

This method creates a connector plasticity behavior option for a ConnectorSection object.

Parameters:
coupling

A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

isotropic

A Boolean specifying whether isotropic hardening data will be used. The default value is ON.If isotropic*=OFF, then *kinematic must be specified as ON.

isotropicType

A SymbolicConstant specifying the type of isotropic hardening to be specified. Possible values are TABULAR and EXPONENTIAL_LAW. The default value is TABULAR.This argument is applicable only if *isotropic*=ON.

isotropicTemperature

A Boolean specifying whether the isotropic data depend on temperature. The default value is OFF.This argument is applicable only if *isotropic*=ON.

isotropicDependencies

An Int specifying the number of field variable dependencies for the isotropic data. The default value is 0.This argument is applicable only if *isotropic*=ON.

kinematic

A Boolean specifying whether kinematic hardening data will be used. The default value is OFF.If kinematic*=OFF, then *isotropic must be specified as ON.

kinematicType

A SymbolicConstant specifying the type of kinematic hardening to be specified. Possible values are HALF_CYCLE, STABILIZED, and PARAMETERS. The default value is HALF_CYCLE.This argument is applicable only if *kinematic*=ON.

kinematicTemperature

A Boolean specifying whether the kinematic data depend on temperature. The default value is OFF.This argument is applicable only if *kinematic*=ON.

kinematicDependencies

An Int specifying the number of field variable dependencies for the kinematic data. The default value is 0.This argument is applicable only if *kinematic*=ON.

forcePotentialOperator

A SymbolicConstant 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 *coupling*=COUPLED.

forcePotentialExponent

A Float 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 *coupling*=COUPLED and if *forcePotentialOperator*=SUM.

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if *coupling*=COUPLED.

isotropicTable

A sequence of sequences of Floats specifying isotropic plasticity properties. Items in the isotropicTable data are described below. This argument is applicable only if *isotropic*=ON. The default value is an empty sequence.

kinematicTable

A sequence of sequences of Floats specifying kinematic plasticity properties. Items in the kinematicTable data are described below. This argument is applicable only if *kinematic*=ON. The default value is an empty sequence.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. This argument can be specified only if *coupling*=UNCOUPLED. The default value is an empty sequence.

Returns:
A ConnectorPlasticity object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorPlasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorPlasticity
ConnectorSection.ConnectorPotential(componentStyle: SymbolicConstantType = 'COMPONENT_NUMBER', componentNumber: int = 0, sign: SymbolicConstantType = 'POSITIVE', scaleFactor: float = 1, positiveExponent: float = 2, shiftFactor: float = 0, hFunction: SymbolicConstantType = 'ABS')[source]#

This method creates a connector potential object to be used in conjunction with an allowable connector behavior option.

Parameters:
componentStyle

A SymbolicConstant specifying whether a component number or the name of the DerivedComponent object will be used in the contribution. Possible values are COMPONENT_NUMBER and DERIVED_COMPONENT. The default value is COMPONENT_NUMBER.

componentNumber

An Int specifying the component number used in the contribution. This argument is applicable only if componentStyle*=COMPONENT_NUMBER. Possible values are 1 ≤≤ *componentNumber ≤≤ 6. Only available components can be specified. The default value is 0.

sign

A SymbolicConstant specifying the sign of the contribution. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

scaleFactor

A Float specifying the scaling factor for the contribution. The default value is 1.0.

positiveExponent

A Float specifying the positive exponent for the contribution. The default value is 2.0.This argument is ignored if the potential operator of the invoking behavior option is set to MAXIMUM.

shiftFactor

A Float specifying the shift factor for the contribution. The default value is 0.0.

hFunction

A SymbolicConstant specifying the H function of the contribution: either absolute value, Macauley bracket, or the identity function. Possible values are ABS, MACAULEY, and IDENTITY. The default value is ABS.The value of IDENTITY can be used only if *positiveExponent*=1.0 and the potential exponent of the invoking behavior option is also 1.0 (i.e., the potential operator of the invoking behavior option must be SUM).

Returns:
A ConnectorPotential object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].ConnectorPotential
session.odbs[name].sections[name].behaviorOptions[i].ConnectorPotential
ConnectorSection.ConnectorStop(minMotion: float | None = None, maxMotion: float | None = None, components: tuple = ())[source]#

This method creates a connector stop behavior option for a ConnectorSection object.

Parameters:
minMotion

None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

maxMotion

None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤≤ components ≤≤ 6. Only available components can be specified. The default value is an empty sequence.

Returns:
A ConnectorStop object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorStop
import odbConnectorBehavior
odbConnectorBehavior.ConnectorStop
ConnectorSection.DerivedComponent()[source]#

This method creates a DerivedComponent object.

Returns:
A DerivedComponent object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
ConnectorSection.TangentialBehavior(formulation: SymbolicConstantType = 'PENALTY', slipRateDependency: BooleanType = 0, pressureDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, exponentialDecayDefinition: SymbolicConstantType = 'COEFFICIENTS', shearStressLimit: float | None = None, maximumElasticSlip: SymbolicConstantType = 'FRACTION', fraction: float | None = None, absoluteDistance: float | None = None, table: tuple = ())[source]#

This method creates a TangentialBehavior object.

Parameters:
formulation

A SymbolicConstant specifying the friction coefficient formulation. Possible values are PENALTY and EXPONENTIAL_DECAY. The default value is PENALTY.

slipRateDependency

A Boolean specifying whether the data depend on slip rate. The default value is OFF.

pressureDependency

A Boolean specifying whether the data depend on contact pressure. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variables for the data. The default value is 0.

exponentialDecayDefinition

A SymbolicConstant specifying the exponential decay definition for the data. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.

shearStressLimit

None or a Float specifying no upper limit or the friction coefficient shear stress limit. The default value is None.

maximumElasticSlip

A SymbolicConstant specifying the method for modifying the allowable elastic slip. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.This argument applies only to Abaqus/Standard analyses.

fraction

A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension. The default value is 10–4.This argument applies only to Abaqus/Standard analyses.

absoluteDistance

None or a Float specifying the absolute magnitude of the allowable elastic slip. The default value is None.This argument applies only to Abaqus/Standard analyses.

table

A sequence of sequences of Floats specifying the tangential properties. Items in the table data are described below. The default value is an empty sequence.

Returns:
A TangentialBehavior object. .

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
DerivedComponent.CDCTerm(intrinsicComponents: tuple, table: tuple, termOperator: SymbolicConstantType = 'RSS', termSign: SymbolicConstantType = 'POSITIVE', localDependency: BooleanType = 0, indepCompType: SymbolicConstantType = 'POSITION', indepComponents: tuple = (), tempDependency: BooleanType = 0, fieldDependencies: int = 0) CDCTerm[source]#

This method creates a CDCTerm object.

Parameters:
intrinsicComponents

A sequence of Ints specifying the components of relative motion for which the contributing term is defined. Possible values are 1 ≤≤ intrinsicComponents ≤≤ 6. Only available components can be specified if the DerivedComponent object is being referenced by a Potential object. This is not the case if the DerivedComponent object is referenced by a ConnectorFriction object directly. The default value is an empty sequence.

table

A sequence of sequences of Floats specifying components numbers and temperature and field values. Each sequence of the table data specifies:The first intrinsic component number.If applicable, the second intrinsic component number.Etc.If applicable, the first independent component number.If applicable, the second independent component number.Etc.If applicable, the temperature value.If applicable, the value of the first field variable.If applicable, the value of the second field variable.Etc.The default value is an empty sequence.

termOperator

A SymbolicConstant specifying the method for combining contributing terms: square root of a sum of the squares, direct sum, or Macauley sum. Possible values are RSS, SUM, and MACAULEY. The default value is RSS.

termSign

A SymbolicConstant specifying the overall sign for the contributing term. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

localDependency

A Boolean specifying whether the table data depend on either components of relative position or components of constitutive relative motion. The default value is OFF.

indepCompType

A SymbolicConstant specifying whether localDependency refers to components of relative position or components of constitutive relative motion. Possible values are POSITION and MOTION. The default value is POSITION.The indepCompType argument applies only if *localDependency*=ON.

indepComponents

A sequence of Ints specifying the independent components included in the derived component definition. Possible values are 1 ≤≤ indepComponents ≤≤ 6. Only available components can be specified. The indepComponents argument applies only if *localDependency*=ON. The default value is an empty sequence.

tempDependency

A Boolean specifying whether the table data depend on temperature. The default value is OFF.

fieldDependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CDCTerm object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent

Object features#

CDCTerm#

class CDCTerm(intrinsicComponents: tuple, table: tuple, termOperator: SymbolicConstantType = 'RSS', termSign: SymbolicConstantType = 'POSITIVE', localDependency: BooleanType = 0, indepCompType: SymbolicConstantType = 'POSITION', indepComponents: tuple = (), tempDependency: BooleanType = 0, fieldDependencies: int = 0)[source]#

The CDCTerm object is used to create contributing terms for a DerivedComponent object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i]
mdb.models[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i]
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i]
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i]
session.odbs[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i]
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i]
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i]
Attributes:
options: ConnectorOptions

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

Methods

ConnectorOptions([useBehRegSettings, ...])

This method creates a connector options object to be used in conjunction with an allowable connector behavior option, derived component term, or connector section.

setValues()

This method modifies the CDCTerm object.

ConnectorOptions(useBehRegSettings: BooleanType = 1, regularize: BooleanType = 1, defaultTolerance: BooleanType = 1, regularization: float = 0, defaultRateFactor: BooleanType = 1, rateFactor: float = 0, interpolation: SymbolicConstantType = 'LINEAR', useBehExtSettings: BooleanType = 1, extrapolation: SymbolicConstantType = 'CONSTANT') ConnectorOptions[source]#

This method creates a connector options object to be used in conjunction with an allowable connector behavior option, derived component term, or connector section.

Parameters:
useBehRegSettings

A Boolean specifying whether or not to use the behavior-level settings for regularization options. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

regularize

A Boolean specifying whether or not the tabular data will be regularized. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF. The default value is ON.

defaultTolerance

A Boolean specifying whether or not the analysis default regularization tolerance will be used. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF and *regularize*=ON. The default value is ON.

regularization

A Float specifying the regularization increment to be used. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF, *regularize*=ON, and *defaultTolerance*=OFF. The default value is 0.03.

defaultRateFactor

A Boolean specifying whether or not the analysis default rate filter factor will be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. The default value is ON.

rateFactor

A Float specifying the rate filter factor to be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. This argument is also applicable only if *defaultRateFactor*=OFF. The default value is 0.9.

interpolation

A SymbolicConstant specifying the type of interpolation increment to be used on rate-dependent tabular data. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. Possible values are LINEAR and LOGARITHMIC. The default value is LINEAR.

useBehExtSettings

A Boolean specifying whether or not to use the behavior-level settings for extrapolation options. The default value is ON.

extrapolation

A SymbolicConstant specifying the extrapolation technique to be used. This argument is applicable only if *useBehExtSettings*=OFF. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

Returns:
A ConnectorOptions object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.CDCTerm
mdb.models[name].sections[name].behaviorOptions[i].derivedComponent.CDCTerm
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.CDCTerm
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.CDCTerm
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.CDCTerm
session.odbs[name].sections[name].behaviorOptions[i].derivedComponent.CDCTerm
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.CDCTerm
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.CDCTerm
setValues()[source]#

This method modifies the CDCTerm object.

Raises:
ValueError.

CDCTermArray#

class CDCTermArray(iterable=(), /)[source]#

Methods

findAt

ConnectorBehaviorOption#

class ConnectorBehaviorOption[source]#

The ConnectorBehaviorOption object is the abstract base type for other ConnectorBehaviorOption objects. The ConnectorBehaviorOption object has no explicit constructor. The members of the ConnectorBehaviorOption object are common to all objects derived from the ConnectorBehaviorOption.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]
Attributes:
connectorPotentials: ConnectorPotentialArray

A ConnectorPotentialArray object.

derivedComponent: DerivedComponent

A DerivedComponent object.

evolutionPotentials: ConnectorPotentialArray

A ConnectorPotentialArray object.

initiationPotentials: ConnectorPotentialArray

A ConnectorPotentialArray object.

initiationOptions: ConnectorOptions

A ConnectorOptions object.

isotropicOptions: ConnectorOptions

A ConnectorOptions object.

kinematicOptions: ConnectorOptions

A ConnectorOptions object.

options: ConnectorOptions

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

tangentialBehavior: TangentialBehavior

A TangentialBehavior object

Methods

ConnectorOptions([useBehRegSettings, ...])

This method creates a connector options object to be used in conjunction with an allowable connector behavior option, derived component term, or connector section.

DerivedComponent()

This method creates a DerivedComponent object.

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

ConnectorOptions(useBehRegSettings: BooleanType = 1, regularize: BooleanType = 1, defaultTolerance: BooleanType = 1, regularization: float = 0, defaultRateFactor: BooleanType = 1, rateFactor: float = 0, interpolation: SymbolicConstantType = 'LINEAR', useBehExtSettings: BooleanType = 1, extrapolation: SymbolicConstantType = 'CONSTANT') ConnectorOptions[source]#

This method creates a connector options object to be used in conjunction with an allowable connector behavior option, derived component term, or connector section.

Parameters:
useBehRegSettings

A Boolean specifying whether or not to use the behavior-level settings for regularization options. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

regularize

A Boolean specifying whether or not the tabular data will be regularized. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF. The default value is ON.

defaultTolerance

A Boolean specifying whether or not the analysis default regularization tolerance will be used. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF and *regularize*=ON. The default value is ON.

regularization

A Float specifying the regularization increment to be used. This argument is applicable only for an Abaqus/Explicit analysis and only if *useBehRegSettings*=OFF, *regularize*=ON, and *defaultTolerance*=OFF. The default value is 0.03.

defaultRateFactor

A Boolean specifying whether or not the analysis default rate filter factor will be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. The default value is ON.

rateFactor

A Float specifying the rate filter factor to be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. This argument is also applicable only if *defaultRateFactor*=OFF. The default value is 0.9.

interpolation

A SymbolicConstant specifying the type of interpolation increment to be used on rate-dependent tabular data. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. Possible values are LINEAR and LOGARITHMIC. The default value is LINEAR.

useBehExtSettings

A Boolean specifying whether or not to use the behavior-level settings for extrapolation options. The default value is ON.

extrapolation

A SymbolicConstant specifying the extrapolation technique to be used. This argument is applicable only if *useBehExtSettings*=OFF. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

Returns:
A ConnectorOptions object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
DerivedComponent() DerivedComponent[source]#

This method creates a DerivedComponent object.

Returns:
A DerivedComponent object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
TangentialBehavior(formulation: SymbolicConstantType = 'PENALTY', slipRateDependency: BooleanType = 0, pressureDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, exponentialDecayDefinition: SymbolicConstantType = 'COEFFICIENTS', shearStressLimit: float | None = None, maximumElasticSlip: SymbolicConstantType = 'FRACTION', fraction: float | None = None, absoluteDistance: float | None = None, table: tuple = ()) TangentialBehavior[source]#

This method creates a TangentialBehavior object.

Parameters:
formulation

A SymbolicConstant specifying the friction coefficient formulation. Possible values are PENALTY and EXPONENTIAL_DECAY. The default value is PENALTY.

slipRateDependency

A Boolean specifying whether the data depend on slip rate. The default value is OFF.

pressureDependency

A Boolean specifying whether the data depend on contact pressure. The default value is OFF.

temperatureDependency

A Boolean specifying whether the data depend on temperature. The default value is OFF.

dependencies

An Int specifying the number of field variables for the data. The default value is 0.

exponentialDecayDefinition

A SymbolicConstant specifying the exponential decay definition for the data. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.

shearStressLimit

None or a Float specifying no upper limit or the friction coefficient shear stress limit. The default value is None.

maximumElasticSlip

A SymbolicConstant specifying the method for modifying the allowable elastic slip. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.This argument applies only to Abaqus/Standard analyses.

fraction

A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension. The default value is 10–4.This argument applies only to Abaqus/Standard analyses.

absoluteDistance

None or a Float specifying the absolute magnitude of the allowable elastic slip. The default value is None.This argument applies only to Abaqus/Standard analyses.

table

A sequence of sequences of Floats specifying the tangential properties. Items in the table data are described below. The default value is an empty sequence.

Returns:
A TangentialBehavior object.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior

ConnectorBehaviorOptionArray#

class ConnectorBehaviorOptionArray(iterable=(), /)[source]#

Methods

findAt

ConnectorDamage#

class ConnectorDamage(coupling: SymbolicConstantType = 'UNCOUPLED', criterion: SymbolicConstantType = 'FORCE', initiationTemperature: BooleanType = 0, initiationPotentialOperator: SymbolicConstantType = 'SUM', initiationPotentialExponent: float = 2, initiationDependencies: int = 0, evolution: BooleanType = 1, evolutionType: SymbolicConstantType = 'MOTION_TYPE', softening: SymbolicConstantType = 'LINEAR', useAffected: BooleanType = 0, degradation: SymbolicConstantType = 'MAXIMUM', evolutionTemperature: BooleanType = 0, evolutionDependencies: int = 0, evolutionPotentialOperator: SymbolicConstantType = 'SUM', evolutionPotentialExponent: float = 2, initiationPotentials: ConnectorPotentialArray | None = None, evolutionPotentials: ConnectorPotentialArray | None = None, initiationTable: tuple = (), evolutionTable: tuple = (), affectedComponents: tuple = (), components: tuple = ())[source]#

The ConnectorDamage object defines damage behavior for one or more components of a connector’s relative motion. The ConnectorDamage object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The table data for this object are:
Table data for *initiationTable*:
If *criterion*=FORCE, then each sequence of the table data specifies the following:
    - Lower (compression) limiting force or moment. Use -1.0E+36 to indicate an unspecified lower limit.
    - Upper (tension) limiting force or moment. Use 1.0E+36 to indicate an unspecified upper limit. At least one
  limit, lower or upper, must be specified.
    - 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 *criterion*=MOTION, then each sequence of the table data specifies the following:
    - Lower (compression) limiting connector constitutive relative displacement or rotation. Use -1.0E+36 to
  indicate an unspecified lower limit.
    - Upper (tension) limiting connector constitutive relative displacement or rotation. Use 1.0E+36 to indicate an
  unspecified upper limit. At least one limit, lower or upper, must be specified.
    - 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 *criterion*=PLASTIC_MOTION, then each sequence of the table data specifies the following:
    - Relative equivalent Plastic displacement/rotation at which damage will be initiated.
    - Mode-mix ratio (only if *coupling*=COUPLED).
    - Relative equivalent Plastic displacement/rotation rate.
    - 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.
Table data for *evolutionTable*:
If *evolutionType*=MOTION and *softening*=LINEAR, then each sequence of the table data specifies the following:
    - Post-initiation equivalent relative Plastic motion at ultimate failure if *criterion*=PLASTIC_MOTION.
  Otherwise, post-initiation constitutive relative motion (displacement/rotation) at ultimate failure.
    - Mode-mix ratio (only if *coupling*=COUPLED and *criterion*=PLASTIC_MOTION).
    - 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 *evolutionType*=MOTION and *softening*=EXPONENTIAL, then each sequence of the table data specifies the following:
    - Post-initiation equivalent relative Plastic motion at ultimate failure if *criterion*=PLASTIC_MOTION.
  Otherwise, post-initiation constitutive relative motion (displacement/rotation) at ultimate failure.
    - Exponential law parameter.
    - Mode-mix ratio (only if *coupling*=COUPLED and *criterion*=PLASTIC_MOTION).
    - 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 *evolutionType*=MOTION and *softening*=TABULAR, then each sequence of the table data specifies the following:
    - Damage variable (cannot be less than 0 or greater than 1).
    - Post-initiation equivalent relative Plastic motion if *criterion*=PLASTIC_MOTION. Otherwise, post-initiation
  constitutive relative motion (displacement/rotation).
    - Mode-mix ratio (only if *coupling*=COUPLED and *criterion*=PLASTIC_MOTION).
    - 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 *evolutionType*=ENERGY, then each sequence of the table data specifies the following:
    - Total energy dissipated by damage at ultimate failure.
    - Mode-mix ratio (only if *coupling*=COUPLED and *criterion*=PLASTIC_MOTION).
    - 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.

The corresponding analysis keywords are:

  • CONNECTOR DAMAGE INITIATION

Attributes:
initiationOptions: ConnectorOptions

A ConnectorOptions object specifying the ConnectorOptions used to define tabular options for the damage initiation table.

evolutionOptions: ConnectorOptions

A ConnectorOptions object specifying the ConnectorOptions used to define tabular options for the damage evolution table.

Methods

setValues()

This method modifies the ConnectorDamage object.

setValues()[source]#

This method modifies the ConnectorDamage object.

Raises:
ValueError.

ConnectorDamping#

class ConnectorDamping(type: SymbolicConstantType = 'VISCOUS', behavior: SymbolicConstantType = 'LINEAR', coupling: SymbolicConstantType = 'UNCOUPLED', dependencies: int = 0, temperatureDependency: BooleanType = 0, frequencyDependency: BooleanType = 0, table: tuple = (), independentComponents: tuple = (), components: tuple = ())[source]#

The ConnectorDamping object defines damping behavior for one or more components of a connector’s relative motion. The ConnectorDamping object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The table data for this object are:

- If *behavior*=LINEAR and *coupling*=UNCOUPLED, then each sequence of the table data specifies the following:
    - Damping coefficient (force or moment per relative velocity).
    - Frequency (cycles/time), if the data depend on frequency.
    - 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 *behavior*=NONLINEAR and *coupling*=UNCOUPLED, then each sequence of the table data specifies the following:
    - Force or moment.
    - Relative displacement or rotation.
    - 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 *behavior*=LINEAR and *coupling*=COUPLED, the table data specify the symmetric portion of the damping matrix
for the specified components followed by any temperature data and then any field data. For example, if
components 2, 3, and 5 are specified, the table portion of the command is as follows:
table=( (C22C22, C23C23, C25C25, C33C33, C35C35, C55C55,), )
The following items should then be specified as comma-separated data:
    - 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 *behavior*=NONLINEAR and *coupling*=COUPLED_POSITION or COUPLED_MOTION, each sequence of the table data
specifies the following:
    - Force or moment for the directions in the *components* list.
    - Relative velocity for the directions in the *components* list.
    - Relative position or angle for the first *independentComponents* direction if *coupling*=COUPLED_POSITION.
  Relative displacement or rotation for the first *independentComponents* direction if *coupling*=COUPLED_MOTION.
    - Relative position or angle for the second *independentComponents* direction if *coupling*=COUPLED_POSITION.
  Relative displacement or rotation for the second *independentComponents* direction if *coupling*=COUPLED_MOTION.
    - Etc. up to the Nth *independentComponents* direction.
    - 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.

The corresponding analysis keywords are:

  • CONNECTOR DAMPING

Attributes:
options: ConnectorOptions

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

Methods

setValues()

This method modifies the ConnectorDamping object.

setValues()[source]#

This method modifies the ConnectorDamping object.

Raises:
ValueError.

ConnectorElasticity#

class ConnectorElasticity(behavior: SymbolicConstantType = 'LINEAR', coupling: SymbolicConstantType = 'UNCOUPLED', dependencies: int = 0, temperatureDependency: BooleanType = 0, frequencyDependency: BooleanType = 0, table: tuple = (), independentComponents: tuple = (), components: tuple = ())[source]#

The ConnectorElasticity object defines elastic behavior for one or more components of a connector’s relative motion. The ConnectorElasticity object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The table data for this object are:

- If *behavior*=LINEAR and *coupling*=UNCOUPLED, then each sequence of the table data specifies the following:
    - Elastic stiffness (per each specified force/moment component).
    - Frequency (cycles/time), if the data depend on frequency.
    - 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 *behavior*=NONLINEAR and *coupling*=UNCOUPLED, then each sequence of the table data specifies the following:
    - Force or moment.
    - Relative displacement or rotation.
    - 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 *behavior*=LINEAR and *coupling*=COUPLED, the table data specify the symmetric portion of the elastic stiffness matrix for the specified components followed by any temperature data and then any field data. For example, if components 2, 3, and 5 are specified, the table portion of the command is as follows:
table=( (D22D22, D23D23, D25D25, D33D33, D35D35, D55D55,),
)
The following items should then be specified as comma-separated data:
    - 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 *behavior*=NONLINEAR and *coupling*=COUPLED_POSITION or COUPLED_MOTION, each sequence of the table data specifies the following:
    - Force or moment for the directions in the *components* list.
    - Relative position or angle for the first *independentComponents* direction if *coupling*=COUPLED_POSITION. Relative displacement or rotation for the first *independentComponents* direction if *coupling*=COUPLED_MOTION.
    - Relative position or angle for the second *independentComponents* direction if *coupling*=COUPLED_POSITION. Relative displacement or rotation for the second *independentComponents* direction if *coupling*=COUPLED_MOTION.
    - Etc. up to the Nth *independentComponents* direction.
    - 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.

The corresponding analysis keywords are:

  • CONNECTOR ELASTICITY

Attributes:
options: ConnectorOptions

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

Methods

setValues()

This method modifies the ConnectorElasticity object.

setValues()[source]#

This method modifies the ConnectorElasticity object.

Raises:
ValueError.

ConnectorFailure#

class ConnectorFailure(releaseComponent: SymbolicConstantType = 'ALL', minMotion: float | None = None, maxMotion: float | None = None, minForce: float | None = None, maxForce: float | None = None, components: tuple = ())[source]#

The ConnectorFailure object defines failure criteria for one or more components of a connector’s relative motion. The ConnectorFailure object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The corresponding analysis keywords are:

  • CONNECTOR FAILURE

Methods

setValues()

This method modifies the ConnectorFailure object.

setValues()[source]#

This method modifies the ConnectorFailure object.

Raises:
ValueError.

ConnectorFriction#

class ConnectorFriction(frictionModel: SymbolicConstantType = 'PREDEFINED', slipStyle: SymbolicConstantType = 'SPECIFY', tangentDirection: int | None = None, stickStiffness: float | None = None, componentType: SymbolicConstantType = 'NO_INDEPENDENT_COMPONENTS', slipDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, useContactForceComponent: BooleanType = 0, contactForceStyle: SymbolicConstantType = 'COMPONENT_NUMBER', contactForceComponent: int = 0, forcePotentialOperator: SymbolicConstantType = 'SUM', forcePotentialExponent: float = 2, connectorPotentials: ConnectorPotentialArray | None = None, table: tuple = (), independentComponents: tuple = ())[source]#

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.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The corresponding analysis keywords are:

  • CONNECTOR FRICTION

Attributes:
tangentialBehavior: TangentialBehavior

A TangentialBehavior object.

derivedComponent: 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=ON, and if contactForceStyle=DERIVED_COMPONENT.

options: ConnectorOptions

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

Methods

setValues()

This method modifies the ConnectorFriction object.

setValues()[source]#

This method modifies the ConnectorFriction object.

Raises:
ValueError.

ConnectorLock#

class ConnectorLock(lockingComponent: SymbolicConstantType = 'ALL', minMotion: float | None = None, maxMotion: float | None = None, minForce: float | None = None, maxForce: float | None = None, components: tuple = ())[source]#

The ConnectorLock object defines locking criteria for one or more available components of a connector’s relative motion. The ConnectorLock object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The corresponding analysis keywords are:

  • CONNECTOR LOCK

Methods

setValues()

This method modifies the ConnectorLock object.

setValues()[source]#

This method modifies the ConnectorLock object.

Raises:
ValueError.

ConnectorOptions#

class ConnectorOptions(useBehRegSettings: BooleanType = 1, regularize: BooleanType = 1, defaultTolerance: BooleanType = 1, regularization: float = 0, defaultRateFactor: BooleanType = 1, rateFactor: float = 0, interpolation: SymbolicConstantType = 'LINEAR', useBehExtSettings: BooleanType = 1, extrapolation: SymbolicConstantType = 'CONSTANT')[source]#

The ConnectorOptions object is used to define various options for connector behaviors. It can be used only in conjunction with CDCTerm, ConnectorDamage, ConnectorDamping, ConnectorElasticity, ConnectorFriction, and ConnectorPlasticity objects. Because the ConnectorDamage object contains two separate ConnectorOptions repositories (one for damage initiation and one for damage evolution), there are two ConnectorOptions constructors associated with that behavior—initiationOptions and evolutionOptions. The ConnectorPlasticity object also contains two separate ConnectorOptions repositories (one for isotropic hardening and one for kinematic hardening), so there are two ConnectorOptions constructors associated with that behavior—isotropicOptions and kinematicOptions.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i].options
mdb.models[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i].options
mdb.models[name].sections[name].behaviorOptions[i].evolutionOptions
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i].options
mdb.models[name].sections[name].behaviorOptions[i].initiationOptions
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i].options
mdb.models[name].sections[name].behaviorOptions[i].isotropicOptions
mdb.models[name].sections[name].behaviorOptions[i].kinematicOptions
mdb.models[name].sections[name].behaviorOptions[i].options
import odbSection
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i].options
session.odbs[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i].options
session.odbs[name].sections[name].behaviorOptions[i].evolutionOptions
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i].options
session.odbs[name].sections[name].behaviorOptions[i].initiationOptions
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i].options
session.odbs[name].sections[name].behaviorOptions[i].isotropicOptions
session.odbs[name].sections[name].behaviorOptions[i].kinematicOptions
session.odbs[name].sections[name].behaviorOptions[i].options

The corresponding analysis keywords are:

  • CONNECTOR BEHAVIOR
    • CONNECTOR DAMAGE INITIATION

    • CONNECTOR DAMAGE EVOLUTION

    • CONNECTOR DAMPING

    • CONNECTOR DERIVED COMPONENT

    • CONNECTOR ELASTICITY

    • CONNECTOR FRICTION

    • CONNECTOR PLASTICITY

Methods

setValues()

This method modifies the ConnectorOptions object.

setValues()[source]#

This method modifies the ConnectorOptions object.

Raises:
ValueError.

ConnectorPlasticity#

class ConnectorPlasticity(coupling: SymbolicConstantType = 'UNCOUPLED', isotropic: BooleanType = 1, isotropicType: SymbolicConstantType = 'TABULAR', isotropicTemperature: BooleanType = 0, isotropicDependencies: int = 0, kinematic: BooleanType = 0, kinematicType: SymbolicConstantType = 'HALF_CYCLE', kinematicTemperature: BooleanType = 0, kinematicDependencies: int = 0, forcePotentialOperator: SymbolicConstantType = 'SUM', forcePotentialExponent: float = 2, connectorPotentials: ConnectorPotentialArray | None = None, isotropicTable: tuple = (), kinematicTable: tuple = (), components: tuple = ())[source]#

The ConnectorPlasticity object defines Plastic behavior for one or more components of a connector’s relative motion. The ConnectorPlasticity object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The table data for this object are:
Table data for *isotropicTable*:
If *isotropicType*=TABULAR, then each sequence of the table data specifies the following:
    - Equivalent yield force or moment defining the size of the elastic range.
    - Equivalent relative Plastic motion.
    - Equivalent relative Plastic motion rate.
    - 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 *isotropicType*=EXPONENTIAL_LAW, then each sequence of the table data specifies the following:
    - Equivalent force or moment defining the size of the elastic range at zero Plastic motion.
    - Isotropic hardening parameter QinfQinf.
    - Isotropic hardening parameter bb.
    - 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.
Table data for *kinematicTable*:
If *kinematicType*=HALF_CYCLE, then each sequence of the table data specifies the following:
    - Yield force or moment.
    - Connector relative Plastic motion.
    - 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 *kinematicType*=STABILIZED, then each sequence of the table data specifies the following:
    - Yield force or moment.
    - Connector relative Plastic motion.
    - Connector relative constitutive motion range.
    - 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 *kinematicType*=PARAMETERS, then each sequence of the table data specifies the following:
    - Yield force or moment at zero relative Plastic motion.
    - Kinematic hardening parameter CC.
    - Kinematic hardening parameter γγ. Set γγ=0 to specify linear Ziegler kinematic hardening.
    - 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.

The corresponding analysis keywords are:

  • CONNECTOR PLASTICITY
    • CONNECTOR HARDENING

    • CONNECTOR POTENTIAL

Attributes:
isotropicOptions: ConnectorOptions

A ConnectorOptions object specifying the ConnectorOptions used to define tabular options for the isotropic hardening table.

kinematicOptions: ConnectorOptions

A ConnectorOptions object specifying the ConnectorOptions used to define tabular options for the kinematic hardening table.

Methods

setValues()

This method modifies the ConnectorPlasticity object.

setValues()[source]#

This method modifies the ConnectorPlasticity object.

Raises:
ValueError.

ConnectorPotential#

class ConnectorPotential(componentStyle: SymbolicConstantType = 'COMPONENT_NUMBER', componentNumber: int = 0, sign: SymbolicConstantType = 'POSITIVE', scaleFactor: float = 1, positiveExponent: float = 2, shiftFactor: float = 0, hFunction: SymbolicConstantType = 'ABS')[source]#

The ConnectorPotential object is used to define a restricted set of mathematical functions to represent yield or limiting surfaces in the space spanned by connector available components. It can be used only in conjunction with ConnectorDamage, ConnectorFriction, and ConnectorPlasticity objects. Because the ConnectorDamage object contains two separate ConnectorPotential repositories (one for damage initiation and one for damage evolution), there are two ConnectorPotential constructors associated with that behavior—IniPotential and EvoPotential.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i]
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i]
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i]
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i]
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i]

The corresponding analysis keywords are:

  • CONNECTOR POTENTIAL

Attributes:
derivedComponent: DerivedComponent

A DerivedComponent object specifying the DerivedComponent used in the contribution. This argument is applicable only if componentStyle=DERIVED_COMPONENT.

Methods

DerivedComponent()

This method creates a DerivedComponent object.

setValues()

This method modifies the ConnectorPotential object.

DerivedComponent() DerivedComponent[source]#

This method creates a DerivedComponent object.

Returns:
A DerivedComponent object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].ConnectorPotential
session.odbs[name].sections[name].behaviorOptions[i]            .ConnectorPotential
setValues()[source]#

This method modifies the ConnectorPotential object.

Raises:
ValueError.

ConnectorPotentialArray#

class ConnectorPotentialArray(iterable=(), /)[source]#

Methods

findAt

ConnectorStop#

class ConnectorStop(minMotion: float | None = None, maxMotion: float | None = None, components: tuple = ())[source]#

The ConnectorStop object defines connector stops for one or more components of a connector’s relative motion. The ConnectorStop object is derived from the ConnectorBehaviorOption object.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

The corresponding analysis keywords are:

  • CONNECTOR STOP

Methods

setValues()

This method modifies the ConnectorStop object.

setValues()[source]#

This method modifies the ConnectorStop object.

Raises:
ValueError.

DerivedComponent#

class DerivedComponent[source]#

A DerivedComponent object describes user-customized components for use in defining ConnectorFriction and Potential objects.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent
mdb.models[name].sections[name].behaviorOptions[i].derivedComponent
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent
import odbSection
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent
session.odbs[name].sections[name].behaviorOptions[i].derivedComponent
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent

The corresponding analysis keywords are:

  • CONNECTOR DERIVED COMPONENT

Attributes:
cdcTerms: CDCTermArray

A CDCTermArray object.

Methods

CDCTerm(intrinsicComponents, table[, ...])

This method creates a CDCTerm object.

setValues()

This method modifies the DerivedComponent object.

CDCTerm(intrinsicComponents: tuple, table: tuple, termOperator: SymbolicConstantType = 'RSS', termSign: SymbolicConstantType = 'POSITIVE', localDependency: BooleanType = 0, indepCompType: SymbolicConstantType = 'POSITION', indepComponents: tuple = (), tempDependency: BooleanType = 0, fieldDependencies: int = 0) CDCTerm[source]#

This method creates a CDCTerm object.

Parameters:
intrinsicComponents

A sequence of Ints specifying the components of relative motion for which the contributing term is defined. Possible values are 1 ≤≤ intrinsicComponents ≤≤ 6. Only available components can be specified if the DerivedComponent object is being referenced by a Potential object. This is not the case if the DerivedComponent object is referenced by a ConnectorFriction object directly. The default value is an empty sequence.

table

A sequence of sequences of Floats specifying components numbers and temperature and field values. Each sequence of the table data specifies:The first intrinsic component number.If applicable, the second intrinsic component number.Etc.If applicable, the first independent component number.If applicable, the second independent component number.Etc.If applicable, the temperature value.If applicable, the value of the first field variable.If applicable, the value of the second field variable.Etc.The default value is an empty sequence.

termOperator

A SymbolicConstant specifying the method for combining contributing terms: square root of a sum of the squares, direct sum, or Macauley sum. Possible values are RSS, SUM, and MACAULEY. The default value is RSS.

termSign

A SymbolicConstant specifying the overall sign for the contributing term. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

localDependency

A Boolean specifying whether the table data depend on either components of relative position or components of constitutive relative motion. The default value is OFF.

indepCompType

A SymbolicConstant specifying whether localDependency refers to components of relative position or components of constitutive relative motion. Possible values are POSITION and MOTION. The default value is POSITION.The indepCompType argument applies only if *localDependency*=ON.

indepComponents

A sequence of Ints specifying the independent components included in the derived component definition. Possible values are 1 ≤≤ indepComponents ≤≤ 6. Only available components can be specified. The indepComponents argument applies only if *localDependency*=ON. The default value is an empty sequence.

tempDependency

A Boolean specifying whether the table data depend on temperature. The default value is OFF.

fieldDependencies

An Int specifying the number of field variable dependencies. The default value is 0.

Returns:
A CDCTerm object.
Raises:
ValueError and TextError.

Notes

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
setValues()[source]#

This method modifies the DerivedComponent object.

Raises:
ValueError.

TangentialBehavior#

class TangentialBehavior(formulation: SymbolicConstantType = 'PENALTY', slipRateDependency: BooleanType = 0, pressureDependency: BooleanType = 0, temperatureDependency: BooleanType = 0, dependencies: int = 0, exponentialDecayDefinition: SymbolicConstantType = 'COEFFICIENTS', shearStressLimit: float | None = None, maximumElasticSlip: SymbolicConstantType = 'FRACTION', fraction: float | None = None, absoluteDistance: float | None = None, table: tuple = ())[source]#

The TangentialBehavior object specifies tangential behavior for a connector friction behavior option.

Notes

This object can be accessed by:

import section
mdb.models[name].sections[name].behaviorOptions[i].tangentialBehavior
import odbSection
session.odbs[name].sections[name].behaviorOptions[i].tangentialBehavior

The table data for this object are:

  • If *formulation*=PENALTY, the table data specify the following:
    • Friction coefficient in the slip direction, μμ.

    • Slip rate, if the data depend on slip rate.

    • Contact pressure, if the data depend on contact pressure.

    • 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 *formulation*=EXPONENTIAL_DECAY and *exponentialDecayDefinition*=COEFFICIENTS, the table data specify the following:
    • Static friction coefficient, μsμs.

    • Kinetic friction coefficient, μkμk.

    • Decay coefficient, dcdc.

  • If *formulation*=EXPONENTIAL_DECAY and *exponentialDecayDefinition*=TEST_DATA, the table data specify the following:
    • Static coefficient of friction.

    • Dynamic friction coefficient measured at the reference slip rate, ˙γ2γ˙2.

    • Reference slip rate, ˙γ2γ˙2, used to measure the dynamic friction coefficient.

    • Kinetic friction coefficient, μ∞μ∞. This value corresponds to the asymptotic value of the friction coefficient at infinite slip rate, ˙γ∞γ˙∞.

The corresponding analysis keywords are:

  • FRICTION

Methods

setValues()

This method modifies the TangentialBehavior object.

setValues()[source]#

This method modifies the TangentialBehavior object.