Connector#

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

Create connectors#

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.
__init__(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]#

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.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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.