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, table, termOperator=abaqusConstants.RSS, termSign=abaqusConstants.POSITIVE, localDependency=OFF, indepCompType=abaqusConstants.POSITION, indepComponents=(), tempDependency=OFF, fieldDependencies=0)[source]

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

Note

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]

Public Data Attributes:

options

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

termOperator

square root of a sum of the squares, direct sum, or Macauley sum.

termSign

A SymbolicConstant specifying the overall sign for the contributing term.

localDependency

A Boolean specifying whether the table data depend on either components of relative position or components of constitutive relative motion.

indepCompType

A SymbolicConstant specifying whether localDependency refers to components of relative position or components of constitutive relative motion.

indepComponents

A sequence of Ints specifying the independent components included in the derived component definition.

tempDependency

A Boolean specifying whether the table data depend on temperature.

fieldDependencies

An Int specifying the number of field variable dependencies.

Public Methods:

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

This method creates a CDCTerm object.

setValues(*args, **kwargs)

This method modifies the CDCTerm object.

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.


__init__(intrinsicComponents, table, termOperator=abaqusConstants.RSS, termSign=abaqusConstants.POSITIVE, localDependency=OFF, indepCompType=abaqusConstants.POSITION, indepComponents=(), tempDependency=OFF, fieldDependencies=0)[source]#

This method creates a CDCTerm object.

Note

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
Parameters:
  • intrinsicComponents (tuple) – 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 (tuple) – 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 (SymbolicConstant, default: RSS) – 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 (SymbolicConstant, default: POSITIVE) – A SymbolicConstant specifying the overall sign for the contributing term. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

  • localDependency (Union[AbaqusBoolean, bool], default: OFF) – 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 (SymbolicConstant, default: POSITION) – 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 (tuple, default: ()) – 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the table data depend on temperature. The default value is OFF.

  • fieldDependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

Returns:

A CDCTerm object.

Return type:

CDCTerm

Raises:

ValueError

ConnectorDamage#

class ConnectorDamage(coupling=abaqusConstants.UNCOUPLED, criterion=abaqusConstants.FORCE, initiationTemperature=OFF, initiationPotentialOperator=abaqusConstants.SUM, initiationPotentialExponent=2, initiationDependencies=0, evolution=ON, evolutionType=abaqusConstants.MOTION_TYPE, softening=abaqusConstants.LINEAR, useAffected=OFF, degradation=abaqusConstants.MAXIMUM, evolutionTemperature=OFF, evolutionDependencies=0, evolutionPotentialOperator=abaqusConstants.SUM, evolutionPotentialExponent=2, initiationPotentials=None, evolutionPotentials=None, initiationTable=(), evolutionTable=(), affectedComponents=(), components=())[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.

Note

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

Public Data Attributes:

initiationOptions

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

evolutionOptions

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

coupling

A SymbolicConstant specifying whether or not the behavior is coupled.

criterion

A SymbolicConstant specifying the damage initiation criterion to be used.

initiationTemperature

A Boolean specifying whether the initiation data depend on temperature.

initiationPotentialOperator

A SymbolicConstant specifying the contribution operator for the initiation potential contributions.

initiationPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the initiation potential definition.

initiationDependencies

An Int specifying the number of field variable dependencies for the initiation data.

evolution

A Boolean specifying whether damage evolution data will be used.

evolutionType

A SymbolicConstant specifying the type of damage evolution to be specified.

softening

A SymbolicConstant specifying the damage evolution law to be specified.

useAffected

A Boolean specifying whether or not affectedComponents will be specified.

degradation

A SymbolicConstant specifying the contribution of each damage mechanism when more than one damage mechanism is defined.

evolutionTemperature

A Boolean specifying whether the evolution data depend on temperature.

evolutionDependencies

An Int specifying the number of field variable dependencies for the evolution data.

evolutionPotentialOperator

A SymbolicConstant specifying the contribution operator for the evolution potential contributions.

evolutionPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the evolution potential definition.

initiationPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution.

evolutionPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution).

initiationTable

A sequence of sequences of Floats specifying the initiation properties.

evolutionTable

A sequence of sequences of Floats specifying the evolution properties.

affectedComponents

A sequence of Ints specifying the components of relative motion that will be damaged.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution).

initiationPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution.

initiationOptions

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

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([coupling, criterion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorDamage object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorDamping#

class ConnectorDamping(type=abaqusConstants.VISCOUS, behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=OFF, frequencyDependency=OFF, table=(), independentComponents=(), components=())[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.

Note

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

Public Data Attributes:

options

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

type

A SymbolicConstant specifying if the damping type is viscous or structural.

behavior

A SymbolicConstant specifying if the damping behavior is linear or nonlinear.

coupling

A SymbolicConstant specifying whether the damping behavior is coupled between the connector's components of relative motion.

dependencies

An Int specifying the number of field variable dependencies.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency.

table

A sequence of sequences of Floats specifying damping properties.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector damping data.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([type, behavior, coupling, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorDamping object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorElasticity#

class ConnectorElasticity(behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=OFF, frequencyDependency=OFF, table=(), independentComponents=(), components=())[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.

Note

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

Public Data Attributes:

options

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

behavior

A SymbolicConstant specifying whether the elastic behavior is linear, nonlinear, or rigid.

coupling

A SymbolicConstant specifying whether the elastic behavior is coupled between the connector's components of relative motion.

dependencies

An Int specifying the number of field variable dependencies.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency.

table

A sequence of sequences of Floats specifying elasticity properties.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector elasticity data.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([behavior, coupling, dependencies, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorElasticity object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorFailure#

class ConnectorFailure(releaseComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[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.

Note

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

Public Data Attributes:

releaseComponent

The SymbolicConstant ALL or an Int specifying the motion components that fail.

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

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.

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.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([releaseComponent, minMotion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorFailure object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorFriction#

class ConnectorFriction(frictionModel=abaqusConstants.PREDEFINED, slipStyle=abaqusConstants.SPECIFY, tangentDirection=None, stickStiffness=None, componentType=abaqusConstants.NO_INDEPENDENT_COMPONENTS, slipDependency=OFF, temperatureDependency=OFF, dependencies=0, useContactForceComponent=OFF, contactForceStyle=abaqusConstants.COMPONENT_NUMBER, contactForceComponent=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, table=(), independentComponents=())[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.

Note

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

Public Data Attributes:

tangentialBehavior

A TangentialBehavior object.

derivedComponent

A DerivedComponent object specifying the DerivedComponent used to compute the contact force component direction.

options

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

frictionModel

A SymbolicConstant specifying the desired frictional response model.

slipStyle

either specified or computed based upon the force potential data.

tangentDirection

None or an Int specifying the direction for which the frictional behavior is specified.

stickStiffness

None or a Float specifying the stick stiffness associated with the frictional behavior in the direction specified by tangentDirection.

componentType

A SymbolicConstant specifying the type of the independentComponents.

slipDependency

A Boolean specifying whether the table data depend on accumulated slip.

temperatureDependency

A Boolean specifying whether the table data depend on temperature.

dependencies

An Int specifying the number of field variable dependencies.

useContactForceComponent

A Boolean specifying whether the contact force component will be defined.

contactForceStyle

A SymbolicConstant specifying the method of indicating the contact force component direction: either specified or computed based on upon a DerivedComponent.

contactForceComponent

An Int specifying the contact force component direction.

forcePotentialOperator

A SymbolicConstant specifying the contribution operator for the force potential contributions.

forcePotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the force potential definition.

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

table

A sequence of sequences of Floats specifying friction properties.

independentComponents

A sequence of Ints specifying the independent components.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

derivedComponent

A DerivedComponent object specifying the DerivedComponent used to compute the contact force component direction.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object.

Public Methods:

__init__([frictionModel, slipStyle, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorFriction object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorLock#

class ConnectorLock(lockingComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[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.

Note

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

Public Data Attributes:

lockingComponent

The SymbolicConstant ALL or an Int specifying the motion components that are locked.

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

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.

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.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([lockingComponent, minMotion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorLock object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorPlasticity#

class ConnectorPlasticity(coupling=abaqusConstants.UNCOUPLED, isotropic=ON, isotropicType=abaqusConstants.TABULAR, isotropicTemperature=OFF, isotropicDependencies=0, kinematic=OFF, kinematicType=abaqusConstants.HALF_CYCLE, kinematicTemperature=OFF, kinematicDependencies=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, isotropicTable=(), kinematicTable=(), components=())[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.

Note

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

Public Data Attributes:

isotropicOptions

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

kinematicOptions

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

coupling

A SymbolicConstant specifying whether or not the behavior is coupled.

isotropic

A Boolean specifying whether isotropic hardening data will be used.

isotropicType

A SymbolicConstant specifying the type of isotropic hardening to be specified.

isotropicTemperature

A Boolean specifying whether the isotropic data depend on temperature.

isotropicDependencies

An Int specifying the number of field variable dependencies for the isotropic data.

kinematic

A Boolean specifying whether kinematic hardening data will be used.

kinematicType

A SymbolicConstant specifying the type of kinematic hardening to be specified.

kinematicTemperature

A Boolean specifying whether the kinematic data depend on temperature.

kinematicDependencies

An Int specifying the number of field variable dependencies for the kinematic data.

forcePotentialOperator

A SymbolicConstant specifying the contribution operator for the force potential contributions.

forcePotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the force potential definition.

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

isotropicTable

A sequence of sequences of Floats specifying isotropic plasticity properties.

kinematicTable

A sequence of sequences of Floats specifying kinematic plasticity properties.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

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

kinematicOptions

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

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([coupling, isotropic, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorPlasticity object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorPotential#

class ConnectorPotential(componentStyle=abaqusConstants.COMPONENT_NUMBER, componentNumber=0, sign=abaqusConstants.POSITIVE, scaleFactor=1, positiveExponent=2, shiftFactor=0, hFunction=abaqusConstants.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.

Note

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

Public Data Attributes:

derivedComponent

A DerivedComponent object specifying the DerivedComponent used in the contribution.

componentStyle

A SymbolicConstant specifying whether a component number or the name of the DerivedComponent object will be used in the contribution.

componentNumber

An Int specifying the component number used in the contribution.

sign

A SymbolicConstant specifying the sign of the contribution.

scaleFactor

A Float specifying the scaling factor for the contribution.

positiveExponent

A Float specifying the positive exponent for the contribution.

shiftFactor

A Float specifying the shift factor for the contribution.

hFunction

either absolute value, Macauley bracket, or the identity function.

Public Methods:

__init__([componentStyle, componentNumber, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorPotential object.

DerivedComponent()

This method creates a DerivedComponent object.


ConnectorStop#

class ConnectorStop(minMotion=None, maxMotion=None, components=())[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.

Note

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

Public Data Attributes:

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([minMotion, maxMotion, components])

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

setValues(*args, **kwargs)

This method modifies the ConnectorStop object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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#

class DerivedComponent[source]

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

Note

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

Public Data Attributes:

cdcTerms

A CDCTermArray object.

Public Methods:

__init__()

This method creates a DerivedComponent object.

setValues(*args, **kwargs)

This method modifies the DerivedComponent object.

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

This method creates a CDCTerm object.


TangentialBehavior#

class TangentialBehavior(formulation=abaqusConstants.PENALTY, slipRateDependency=OFF, pressureDependency=OFF, temperatureDependency=OFF, dependencies=0, exponentialDecayDefinition=abaqusConstants.COEFFICIENTS, shearStressLimit=None, maximumElasticSlip=abaqusConstants.FRACTION, fraction=None, absoluteDistance=None, table=())[source]

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

Note

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

Public Data Attributes:

formulation

A SymbolicConstant specifying the friction coefficient formulation.

slipRateDependency

A Boolean specifying whether the data depend on slip rate.

pressureDependency

A Boolean specifying whether the data depend on contact pressure.

temperatureDependency

A Boolean specifying whether the data depend on temperature.

dependencies

An Int specifying the number of field variables for the data.

exponentialDecayDefinition

A SymbolicConstant specifying the exponential decay definition for the data.

shearStressLimit

None or a Float specifying no upper limit or the friction coefficient shear stress limit.

maximumElasticSlip

A SymbolicConstant specifying the method for modifying the allowable elastic slip.

fraction

A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension.

absoluteDistance

None or a Float specifying the absolute magnitude of the allowable elastic slip.

table

A sequence of sequences of Floats specifying the tangential properties.

Public Methods:

__init__([formulation, slipRateDependency, ...])

This method creates a TangentialBehavior object.

setValues(*args, **kwargs)

This method modifies the TangentialBehavior object.


Object features#

CDCTerm#

class CDCTerm(intrinsicComponents, table, termOperator=abaqusConstants.RSS, termSign=abaqusConstants.POSITIVE, localDependency=OFF, indepCompType=abaqusConstants.POSITION, indepComponents=(), tempDependency=OFF, fieldDependencies=0)[source]

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

Note

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]

Public Data Attributes:

options

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

termOperator

square root of a sum of the squares, direct sum, or Macauley sum.

termSign

A SymbolicConstant specifying the overall sign for the contributing term.

localDependency

A Boolean specifying whether the table data depend on either components of relative position or components of constitutive relative motion.

indepCompType

A SymbolicConstant specifying whether localDependency refers to components of relative position or components of constitutive relative motion.

indepComponents

A sequence of Ints specifying the independent components included in the derived component definition.

tempDependency

A Boolean specifying whether the table data depend on temperature.

fieldDependencies

An Int specifying the number of field variable dependencies.

Public Methods:

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

This method creates a CDCTerm object.

setValues(*args, **kwargs)

This method modifies the CDCTerm object.

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.


CDCTermArray#

CDCTermArray[source]

alias of List[CDCTerm]

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.

Note

This object can be accessed by:

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

Public Data Attributes:

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorBehaviorOptionArray#

ConnectorBehaviorOptionArray[source]

alias of List[ConnectorBehaviorOption]

ConnectorDamage#

class ConnectorDamage(coupling=abaqusConstants.UNCOUPLED, criterion=abaqusConstants.FORCE, initiationTemperature=OFF, initiationPotentialOperator=abaqusConstants.SUM, initiationPotentialExponent=2, initiationDependencies=0, evolution=ON, evolutionType=abaqusConstants.MOTION_TYPE, softening=abaqusConstants.LINEAR, useAffected=OFF, degradation=abaqusConstants.MAXIMUM, evolutionTemperature=OFF, evolutionDependencies=0, evolutionPotentialOperator=abaqusConstants.SUM, evolutionPotentialExponent=2, initiationPotentials=None, evolutionPotentials=None, initiationTable=(), evolutionTable=(), affectedComponents=(), components=())[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.

Note

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

Public Data Attributes:

initiationOptions

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

evolutionOptions

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

coupling

A SymbolicConstant specifying whether or not the behavior is coupled.

criterion

A SymbolicConstant specifying the damage initiation criterion to be used.

initiationTemperature

A Boolean specifying whether the initiation data depend on temperature.

initiationPotentialOperator

A SymbolicConstant specifying the contribution operator for the initiation potential contributions.

initiationPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the initiation potential definition.

initiationDependencies

An Int specifying the number of field variable dependencies for the initiation data.

evolution

A Boolean specifying whether damage evolution data will be used.

evolutionType

A SymbolicConstant specifying the type of damage evolution to be specified.

softening

A SymbolicConstant specifying the damage evolution law to be specified.

useAffected

A Boolean specifying whether or not affectedComponents will be specified.

degradation

A SymbolicConstant specifying the contribution of each damage mechanism when more than one damage mechanism is defined.

evolutionTemperature

A Boolean specifying whether the evolution data depend on temperature.

evolutionDependencies

An Int specifying the number of field variable dependencies for the evolution data.

evolutionPotentialOperator

A SymbolicConstant specifying the contribution operator for the evolution potential contributions.

evolutionPotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the evolution potential definition.

initiationPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution.

evolutionPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution).

initiationTable

A sequence of sequences of Floats specifying the initiation properties.

evolutionTable

A sequence of sequences of Floats specifying the evolution properties.

affectedComponents

A sequence of Ints specifying the components of relative motion that will be damaged.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution).

initiationPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution.

initiationOptions

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

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([coupling, criterion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorDamage object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorDamping#

class ConnectorDamping(type=abaqusConstants.VISCOUS, behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=OFF, frequencyDependency=OFF, table=(), independentComponents=(), components=())[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.

Note

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

Public Data Attributes:

options

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

type

A SymbolicConstant specifying if the damping type is viscous or structural.

behavior

A SymbolicConstant specifying if the damping behavior is linear or nonlinear.

coupling

A SymbolicConstant specifying whether the damping behavior is coupled between the connector's components of relative motion.

dependencies

An Int specifying the number of field variable dependencies.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency.

table

A sequence of sequences of Floats specifying damping properties.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector damping data.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([type, behavior, coupling, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorDamping object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorElasticity#

class ConnectorElasticity(behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=OFF, frequencyDependency=OFF, table=(), independentComponents=(), components=())[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.

Note

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

Public Data Attributes:

options

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

behavior

A SymbolicConstant specifying whether the elastic behavior is linear, nonlinear, or rigid.

coupling

A SymbolicConstant specifying whether the elastic behavior is coupled between the connector's components of relative motion.

dependencies

An Int specifying the number of field variable dependencies.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency.

table

A sequence of sequences of Floats specifying elasticity properties.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector elasticity data.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([behavior, coupling, dependencies, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorElasticity object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorFailure#

class ConnectorFailure(releaseComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[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.

Note

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

Public Data Attributes:

releaseComponent

The SymbolicConstant ALL or an Int specifying the motion components that fail.

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

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.

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.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([releaseComponent, minMotion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorFailure object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorFriction#

class ConnectorFriction(frictionModel=abaqusConstants.PREDEFINED, slipStyle=abaqusConstants.SPECIFY, tangentDirection=None, stickStiffness=None, componentType=abaqusConstants.NO_INDEPENDENT_COMPONENTS, slipDependency=OFF, temperatureDependency=OFF, dependencies=0, useContactForceComponent=OFF, contactForceStyle=abaqusConstants.COMPONENT_NUMBER, contactForceComponent=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, table=(), independentComponents=())[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.

Note

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

Public Data Attributes:

tangentialBehavior

A TangentialBehavior object.

derivedComponent

A DerivedComponent object specifying the DerivedComponent used to compute the contact force component direction.

options

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

frictionModel

A SymbolicConstant specifying the desired frictional response model.

slipStyle

either specified or computed based upon the force potential data.

tangentDirection

None or an Int specifying the direction for which the frictional behavior is specified.

stickStiffness

None or a Float specifying the stick stiffness associated with the frictional behavior in the direction specified by tangentDirection.

componentType

A SymbolicConstant specifying the type of the independentComponents.

slipDependency

A Boolean specifying whether the table data depend on accumulated slip.

temperatureDependency

A Boolean specifying whether the table data depend on temperature.

dependencies

An Int specifying the number of field variable dependencies.

useContactForceComponent

A Boolean specifying whether the contact force component will be defined.

contactForceStyle

A SymbolicConstant specifying the method of indicating the contact force component direction: either specified or computed based on upon a DerivedComponent.

contactForceComponent

An Int specifying the contact force component direction.

forcePotentialOperator

A SymbolicConstant specifying the contribution operator for the force potential contributions.

forcePotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the force potential definition.

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

table

A sequence of sequences of Floats specifying friction properties.

independentComponents

A sequence of Ints specifying the independent components.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

derivedComponent

A DerivedComponent object specifying the DerivedComponent used to compute the contact force component direction.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object.

Public Methods:

__init__([frictionModel, slipStyle, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorFriction object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorLock#

class ConnectorLock(lockingComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[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.

Note

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

Public Data Attributes:

lockingComponent

The SymbolicConstant ALL or an Int specifying the motion components that are locked.

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

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.

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.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([lockingComponent, minMotion, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorLock object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorOptions#

class ConnectorOptions(useBehRegSettings=ON, regularize=ON, defaultTolerance=ON, regularization=0, defaultRateFactor=ON, rateFactor=0, interpolation=abaqusConstants.LINEAR, useBehExtSettings=ON, extrapolation=abaqusConstants.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.

Note

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

Public Data Attributes:

useBehRegSettings

A Boolean specifying whether or not to use the behavior-level settings for regularization options.

regularize

A Boolean specifying whether or not the tabular data will be regularized.

defaultTolerance

A Boolean specifying whether or not the analysis default regularization tolerance will be used.

regularization

A Float specifying the regularization increment to be used.

defaultRateFactor

A Boolean specifying whether or not the analysis default rate filter factor will be used.

rateFactor

A Float specifying the rate filter factor to be used.

interpolation

A SymbolicConstant specifying the type of interpolation increment to be used on rate-dependent tabular data.

useBehExtSettings

A Boolean specifying whether or not to use the behavior-level settings for extrapolation options.

extrapolation

A SymbolicConstant specifying the extrapolation technique to be used.

Public Methods:

__init__([useBehRegSettings, regularize, ...])

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(*args, **kwargs)

This method modifies the ConnectorOptions object.


ConnectorPlasticity#

class ConnectorPlasticity(coupling=abaqusConstants.UNCOUPLED, isotropic=ON, isotropicType=abaqusConstants.TABULAR, isotropicTemperature=OFF, isotropicDependencies=0, kinematic=OFF, kinematicType=abaqusConstants.HALF_CYCLE, kinematicTemperature=OFF, kinematicDependencies=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, isotropicTable=(), kinematicTable=(), components=())[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.

Note

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

Public Data Attributes:

isotropicOptions

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

kinematicOptions

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

coupling

A SymbolicConstant specifying whether or not the behavior is coupled.

isotropic

A Boolean specifying whether isotropic hardening data will be used.

isotropicType

A SymbolicConstant specifying the type of isotropic hardening to be specified.

isotropicTemperature

A Boolean specifying whether the isotropic data depend on temperature.

isotropicDependencies

An Int specifying the number of field variable dependencies for the isotropic data.

kinematic

A Boolean specifying whether kinematic hardening data will be used.

kinematicType

A SymbolicConstant specifying the type of kinematic hardening to be specified.

kinematicTemperature

A Boolean specifying whether the kinematic data depend on temperature.

kinematicDependencies

An Int specifying the number of field variable dependencies for the kinematic data.

forcePotentialOperator

A SymbolicConstant specifying the contribution operator for the force potential contributions.

forcePotentialExponent

A Float specifying the number equal to the inverse of the overall exponent in the force potential definition.

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

isotropicTable

A sequence of sequences of Floats specifying isotropic plasticity properties.

kinematicTable

A sequence of sequences of Floats specifying kinematic plasticity properties.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

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

kinematicOptions

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

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([coupling, isotropic, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorPlasticity object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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.


ConnectorPotential#

class ConnectorPotential(componentStyle=abaqusConstants.COMPONENT_NUMBER, componentNumber=0, sign=abaqusConstants.POSITIVE, scaleFactor=1, positiveExponent=2, shiftFactor=0, hFunction=abaqusConstants.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.

Note

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

Public Data Attributes:

derivedComponent

A DerivedComponent object specifying the DerivedComponent used in the contribution.

componentStyle

A SymbolicConstant specifying whether a component number or the name of the DerivedComponent object will be used in the contribution.

componentNumber

An Int specifying the component number used in the contribution.

sign

A SymbolicConstant specifying the sign of the contribution.

scaleFactor

A Float specifying the scaling factor for the contribution.

positiveExponent

A Float specifying the positive exponent for the contribution.

shiftFactor

A Float specifying the shift factor for the contribution.

hFunction

either absolute value, Macauley bracket, or the identity function.

Public Methods:

__init__([componentStyle, componentNumber, ...])

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

setValues(*args, **kwargs)

This method modifies the ConnectorPotential object.

DerivedComponent()

This method creates a DerivedComponent object.


ConnectorPotentialArray#

ConnectorPotentialArray[source]

alias of List[ConnectorPotential]

ConnectorStop#

class ConnectorStop(minMotion=None, maxMotion=None, components=())[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.

Note

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

Public Data Attributes:

minMotion

None or a Float specifying the lower bound for the connector's relative position for all specified components, or no lower bound.

maxMotion

None or a Float specifying the upper bound for the connector's relative position for all specified components, or no upper bound.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined.

Inherited from ConnectorBehaviorOption

connectorPotentials

A ConnectorPotentialArray object.

derivedComponent

A DerivedComponent object.

evolutionPotentials

A ConnectorPotentialArray object.

initiationPotentials

A ConnectorPotentialArray object.

initiationOptions

A ConnectorOptions object.

isotropicOptions

A ConnectorOptions object.

kinematicOptions

A ConnectorOptions object.

options

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

tangentialBehavior

A TangentialBehavior object

Public Methods:

__init__([minMotion, maxMotion, components])

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

setValues(*args, **kwargs)

This method modifies the ConnectorStop object.

Inherited from ConnectorBehaviorOption

TangentialBehavior([formulation, ...])

This method creates a TangentialBehavior object.

DerivedComponent()

This method creates a DerivedComponent object.

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#

class DerivedComponent[source]

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

Note

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

Public Data Attributes:

cdcTerms

A CDCTermArray object.

Public Methods:

__init__()

This method creates a DerivedComponent object.

setValues(*args, **kwargs)

This method modifies the DerivedComponent object.

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

This method creates a CDCTerm object.


TangentialBehavior#

class TangentialBehavior(formulation=abaqusConstants.PENALTY, slipRateDependency=OFF, pressureDependency=OFF, temperatureDependency=OFF, dependencies=0, exponentialDecayDefinition=abaqusConstants.COEFFICIENTS, shearStressLimit=None, maximumElasticSlip=abaqusConstants.FRACTION, fraction=None, absoluteDistance=None, table=())[source]

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

Note

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

Public Data Attributes:

formulation

A SymbolicConstant specifying the friction coefficient formulation.

slipRateDependency

A Boolean specifying whether the data depend on slip rate.

pressureDependency

A Boolean specifying whether the data depend on contact pressure.

temperatureDependency

A Boolean specifying whether the data depend on temperature.

dependencies

An Int specifying the number of field variables for the data.

exponentialDecayDefinition

A SymbolicConstant specifying the exponential decay definition for the data.

shearStressLimit

None or a Float specifying no upper limit or the friction coefficient shear stress limit.

maximumElasticSlip

A SymbolicConstant specifying the method for modifying the allowable elastic slip.

fraction

A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension.

absoluteDistance

None or a Float specifying the absolute magnitude of the allowable elastic slip.

table

A sequence of sequences of Floats specifying the tangential properties.

Public Methods:

__init__([formulation, slipRateDependency, ...])

This method creates a TangentialBehavior object.

setValues(*args, **kwargs)

This method modifies the TangentialBehavior object.