Connector

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

Create connectors

class ConnectorSection[source]

Bases: SectionBase

Public Data Attributes:

Inherited from SectionBase

behaviorOptions

A ConnectorBehaviorOptionArray object.

name

A String specifying the repository key.

beamTransverseShear

A TransverseShearBeam object.

transverseShear

A TransverseShearShell object.

Public Methods:

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

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

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

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

ConnectorElasticity([behavior, coupling, ...])

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

ConnectorFailure([releaseComponent, ...])

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

ConnectorFriction([frictionModel, ...])

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

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

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

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

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

ConnectorPotential([componentStyle, ...])

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

ConnectorStop([minMotion, maxMotion, components])

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

Inherited from SectionBase

sectionsFromOdb(fileName)

This method creates Section objects by reading an output database.


Member Details:

ConnectorDamage(coupling=abaqusConstants.UNCOUPLED, criterion=abaqusConstants.FORCE, initiationTemperature=0, initiationPotentialOperator=abaqusConstants.SUM, initiationPotentialExponent=2, initiationDependencies=0, evolution=1, evolutionType=abaqusConstants.MOTION_TYPE, softening=abaqusConstants.LINEAR, useAffected=0, degradation=abaqusConstants.MAXIMUM, evolutionTemperature=0, evolutionDependencies=0, evolutionPotentialOperator=abaqusConstants.SUM, evolutionPotentialExponent=2, initiationPotentials=None, evolutionPotentials=None, initiationTable=(), evolutionTable=(), affectedComponents=(), components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamage
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamage
Parameters:
  • coupling (Literal[COUPLED, UNCOUPLED], default: UNCOUPLED) – A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

  • criterion (Literal[PLASTIC_MOTION, FORCE, MOTION], default: FORCE) – A SymbolicConstant specifying the damage initiation criterion to be used. Possible values are FORCE, MOTION, and PLASTIC_MOTION. The default value is FORCE.

  • initiationTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the initiation data depend on temperature. The default value is OFF.

  • initiationPotentialOperator (Literal[SUM, MOTION, COUPLED, FORCE, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the initiation potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is only if coupling = COUPLED and if criterion = FORCE or MOTION.

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

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

  • evolution (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether damage evolution data will be used. The default value is ON.

  • evolutionType (Literal[ENERGY_TYPE, MOTION_TYPE], default: MOTION_TYPE) – A SymbolicConstant specifying the type of damage evolution to be specified. Possible values are MOTION_TYPE and ENERGY_TYPE. The default value is MOTION_TYPE.This argument is applicable only if evolution = ON.

  • softening (Literal[EXPONENTIAL, TABULAR, MOTION_TYPE, LINEAR], default: LINEAR) – A SymbolicConstant specifying the damage evolution law to be specified. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.This argument is applicable only if evolution = ON and when evolutionType = MOTION_TYPE.

  • useAffected (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether or not affectedComponents will be specified. If useAffected = OFF, then only the components of relative motion specified by components will undergo damage. The default value is OFF.This argument is applicable only if evolution = ON.

  • degradation (Literal[MULTIPLICATIVE, MAXIMUM], default: MAXIMUM) – A SymbolicConstant specifying the contribution of each damage mechanism when more than one damage mechanism is defined. Possible values are MAXIMUM and MULTIPLICATIVE. The default value is MAXIMUM.This argument is applicable if evolution = ON.

  • evolutionTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the evolution data depend on temperature. The default value is OFF.This argument is applicable only if evolution = ON.

  • evolutionDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the evolution data. The default value is 0.This argument is applicable only if evolution = ON.

  • evolutionPotentialOperator (Literal[SUM, MOTION, MOTION_TYPE, COUPLED, FORCE, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the evolution potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if coupling = COUPLED, when evolution = ON, when evolutionType = MOTION_TYPE, and when criterion = FORCE or MOTION.

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

  • initiationPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution. This member can be specified only if coupling = COUPLED and if criterion = FORCE or MOTION.

  • evolutionPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution). This member can be specified only if coupling = COUPLED, if evolution = ON, if evolutionType = MOTION, and if criterion = FORCE or MOTION.

  • initiationTable (tuple, default: ()) – A sequence of sequences of Floats specifying the initiation properties. The default value is an empty sequence.Items in the initiationTable data are described below.

  • evolutionTable (tuple, default: ()) – A sequence of sequences of Floats specifying the evolution properties. The default value is an empty sequence.Items in the evolutionTable data are described below. This argument is only applicable if evolution = ON.

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

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

Returns:

A ConnectorDamage object.

Return type:

ConnectorDamage

Raises:

ValueError –

ConnectorDamping(type=abaqusConstants.VISCOUS, behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=0, frequencyDependency=0, table=(), independentComponents=(), components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamping
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamping
Parameters:
  • type (Literal[STRUCTURAL, VISCOUS], default: VISCOUS) –

    A SymbolicConstant specifying if the damping type is viscous or structural. Possible values are VISCOUS and STRUCTURAL. The default value is VISCOUS.

    New in version 2022: The type argument was added.

  • behavior (Literal[NONLINEAR, LINEAR], default: LINEAR) – A SymbolicConstant specifying if the damping behavior is linear or nonlinear. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.

  • coupling (Literal[UNCOUPLED, NONLINEAR, COUPLED_POSITION, COUPLED_MOTION, COUPLED, LINEAR], default: UNCOUPLED) – A SymbolicConstant specifying whether the damping behavior is coupled between the connector’s components of relative motion. If behavior = LINEAR, then possible values are UNCOUPLED and COUPLED. If behavior = NONLINEAR, then possible values are UNCOUPLED, COUPLED_POSITION, and COUPLED_MOTION. Possible values are UNCOUPLED, COUPLED, COUPLED_POSITION, and COUPLED_MOTION. The default value is UNCOUPLED.

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

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if behavior = LINEAR and coupling = UNCOUPLED. The default value is OFF.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying damping properties. Items in the table data are described below. The default value is an empty sequence.

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

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

Returns:

A ConnectorDamping object.

Return type:

ConnectorDamping

Raises:

ValueError –

ConnectorElasticity(behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=0, frequencyDependency=0, table=(), independentComponents=(), components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorElasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorElasticity
Parameters:
  • behavior (Literal[RIGID, NONLINEAR, LINEAR], default: LINEAR) – A SymbolicConstant specifying whether the elastic behavior is linear, nonlinear, or rigid. Possible values are LINEAR, NONLINEAR, and RIGID. The default value is LINEAR.

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

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.This argument is not applicable if behavior = RIGID.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.This argument is not applicable if behavior = RIGID.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if behavior = LINEAR and coupling = UNCOUPLED. The default value is OFF.This argument is not applicable if behavior = RIGID.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying elasticity properties. Items in the table data are described below. This argument is not applicable if behavior = RIGID. The default value is an empty sequence.

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

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

Returns:

A ConnectorElasticity object.

Return type:

ConnectorElasticity

Raises:

ValueError –

ConnectorFailure(releaseComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFailure
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFailure
Parameters:
  • releaseComponent (Literal[ALL], default: ALL) – The SymbolicConstant ALL or an Int specifying the motion components that fail. If an Int is specified, only that motion component fails when the failure criteria are satisfied. If releaseComponent = ALL, all motion components fail. The default value is ALL.

  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

  • minForce (Optional[float], default: None) – None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

  • maxForce (Optional[float], default: None) – None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

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

Returns:

A ConnectorFailure object.

Return type:

ConnectorFailure

Raises:

ValueError –

ConnectorFriction(frictionModel=abaqusConstants.PREDEFINED, slipStyle=abaqusConstants.SPECIFY, tangentDirection=None, stickStiffness=None, componentType=abaqusConstants.NO_INDEPENDENT_COMPONENTS, slipDependency=0, temperatureDependency=0, dependencies=0, useContactForceComponent=0, contactForceStyle=abaqusConstants.COMPONENT_NUMBER, contactForceComponent=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, table=(), independentComponents=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFriction
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFriction
Parameters:
  • frictionModel (Literal[PREDEFINED, USER_CUSTOMIZED], default: PREDEFINED) – A SymbolicConstant specifying the desired frictional response model. Possible values are PREDEFINED and USER_CUSTOMIZED. The default value is PREDEFINED.

  • slipStyle (Literal[COMPUTE, SPECIFY, USER_CUSTOMIZED], default: SPECIFY) – A SymbolicConstant specifying the method of indicating the slip direction: either specified or computed based upon the force potential data. Possible values are SPECIFY and COMPUTE. The default value is SPECIFY.This argument is applicable only if frictionModel = USER_CUSTOMIZED.

  • tangentDirection (Optional[int], default: None) – None or an Int specifying the direction for which the frictional behavior is specified. Possible values are 1 ≤ tangentDirection ≤ 6, indicating an available component of relative motion. This argument applies only if frictionModel = USER_CUSTOMIZED and if slipStyle = SPECIFY. The default value is None.

  • stickStiffness (Optional[float], default: None) – None or a Float specifying the stick stiffness associated with the frictional behavior in the direction specified by tangentDirection. If this argument is omitted, Abaqus computes an appropriate number for the stick stiffness. The default value is None.

  • componentType (Literal[POSITION, MOTION, NO_INDEPENDENT_COMPONENTS], default: NO_INDEPENDENT_COMPONENTS) – A SymbolicConstant specifying the type of the independentComponents. Possible values are POSITION, MOTION, and NO_INDEPENDENT_COMPONENTS. The default value is NO_INDEPENDENT_COMPONENTS.

  • slipDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the table data depend on accumulated slip. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the table data depend on temperature. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • useContactForceComponent (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the contact force component will be defined. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • contactForceStyle (Literal[COMPONENT_NUMBER, USER_CUSTOMIZED, DERIVED_COMPONENT], default: COMPONENT_NUMBER) – A SymbolicConstant specifying the method of indicating the contact force component direction: either specified or computed based on upon a DerivedComponent. Possible values are COMPONENT_NUMBER and DERIVED_COMPONENT. The default value is COMPONENT_NUMBER.This argument is applicable only if frictionModel = USER_CUSTOMIZED and if useContactForceComponent = ON.

  • contactForceComponent (int, default: 0) – An Int specifying the contact force component direction. This argument applies only if frictionModel = USER_CUSTOMIZED, if useContactForceComponent = ON, and if contactForceStyle = COMPONENT_NUMBER. The default value is 0.

  • forcePotentialOperator (Literal[SUM, COMPUTE, USER_CUSTOMIZED, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the force potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if frictionModel = USER_CUSTOMIZED and if slipStyle = COMPUTE.

  • forcePotentialExponent (float, default: 2) – A Float specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.This argument is applicable only if frictionModel = USER_CUSTOMIZED, if slipStyle = COMPUTE, and if forcePotentialOperator = SUM.

  • connectorPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if frictionModel = USER_CUSTOMIZED, and if slipStyle = COMPUTE.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying friction properties. The default value is an empty sequence.If frictionModel = PREDEFINED, each sequence of the table data specifies:If applicable, the first geometric scaling constant relevant to frictional interactions.Etc., up to as many geometric scaling constants as are associated with this connection type.Internal contact force/moment generating friction in the first predefined slip direction.If applicable, internal contact force/moment generating friction in the second predefined slip direction.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the first predefined slip direction, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.If frictionModel = USER_CUSTOMIZED, each sequence of the table data specifies:Effective radius of the cylindrical or spherical surface over which frictional slip occurs in the connector associated with frictional effects in the direction specified by tangentDirection. This radius is relevant only if the connection type includes an available rotational component of relative motion and tangentDirection = SLIP_DIRECTION.Internal contact force/moment generating friction in the direction specified by tangentDirection.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the direction specified by tangentDirection, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.

  • independentComponents (tuple, default: ()) – A sequence of Ints specifying the independent components. Possible values are 1 ≤ independentComponents ≤ 6. In addition, each independent component value must be unique. The independentComponents argument applies only if frictionModel = USER_CUSTOMIZED. Only available components can be specified. The default value is an empty sequence.

Returns:

A ConnectorFriction object.

Return type:

ConnectorFriction

Raises:

ValueError –

ConnectorLock(lockingComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorLock
import odbConnectorBehavior
odbConnectorBehavior.ConnectorLock
Parameters:
  • lockingComponent (Literal[ALL], default: ALL) – The SymbolicConstant ALL or an Int specifying the motion components that are locked. If an Int is specified, only that motion component is locked when the locking criteria are satisfied. If lockingComponent = ALL, all motion components are locked. The default value is ALL.

  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

  • minForce (Optional[float], default: None) – None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

  • maxForce (Optional[float], default: None) – None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

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

Returns:

A ConnectorLock object.

Return type:

ConnectorLock

Raises:

ValueError –

ConnectorPlasticity(coupling=abaqusConstants.UNCOUPLED, isotropic=1, isotropicType=abaqusConstants.TABULAR, isotropicTemperature=0, isotropicDependencies=0, kinematic=0, kinematicType=abaqusConstants.HALF_CYCLE, kinematicTemperature=0, kinematicDependencies=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, isotropicTable=(), kinematicTable=(), components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorPlasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorPlasticity
Parameters:
  • coupling (Literal[COUPLED, UNCOUPLED], default: UNCOUPLED) – A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

  • isotropic (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether isotropic hardening data will be used. The default value is ON.If isotropic = OFF, then kinematic must be specified as ON.

  • isotropicType (Literal[TABULAR, EXPONENTIAL_LAW], default: TABULAR) – A SymbolicConstant specifying the type of isotropic hardening to be specified. Possible values are TABULAR and EXPONENTIAL_LAW. The default value is TABULAR.This argument is applicable only if isotropic = ON.

  • isotropicTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the isotropic data depend on temperature. The default value is OFF.This argument is applicable only if isotropic = ON.

  • isotropicDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the isotropic data. The default value is 0.This argument is applicable only if isotropic = ON.

  • kinematic (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether kinematic hardening data will be used. The default value is OFF.If kinematic = OFF, then isotropic must be specified as ON.

  • kinematicType (Literal[PARAMETERS, HALF_CYCLE, STABILIZED], default: HALF_CYCLE) – A SymbolicConstant specifying the type of kinematic hardening to be specified. Possible values are HALF_CYCLE, STABILIZED, and PARAMETERS. The default value is HALF_CYCLE.This argument is applicable only if kinematic = ON.

  • kinematicTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the kinematic data depend on temperature. The default value is OFF.This argument is applicable only if kinematic = ON.

  • kinematicDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the kinematic data. The default value is 0.This argument is applicable only if kinematic = ON.

  • forcePotentialOperator (Literal[SUM, COUPLED, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the force potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if coupling = COUPLED.

  • forcePotentialExponent (float, default: 2) – A Float specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.This argument is applicable only if coupling = COUPLED and if forcePotentialOperator = SUM.

  • connectorPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if coupling = COUPLED.

  • isotropicTable (tuple, default: ()) – A sequence of sequences of Floats specifying isotropic plasticity properties. Items in the isotropicTable data are described below. This argument is applicable only if isotropic = ON. The default value is an empty sequence.

  • kinematicTable (tuple, default: ()) – A sequence of sequences of Floats specifying kinematic plasticity properties. Items in the kinematicTable data are described below. This argument is applicable only if kinematic = ON. The default value is an empty sequence.

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

Returns:

A ConnectorPlasticity object.

Return type:

ConnectorPlasticity

Raises:

ValueError –

ConnectorPotential(componentStyle=abaqusConstants.COMPONENT_NUMBER, componentNumber=0, sign=abaqusConstants.POSITIVE, scaleFactor=1, positiveExponent=2, shiftFactor=0, hFunction=abaqusConstants.ABS)[source]

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

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].ConnectorPotential
session.odbs[name].sections[name].behaviorOptions[i].ConnectorPotential
Parameters:
  • componentStyle (Literal[COMPONENT_NUMBER, DERIVED_COMPONENT], default: COMPONENT_NUMBER) – A SymbolicConstant specifying whether a component number or the name of the DerivedComponent object will be used in the contribution. Possible values are COMPONENT_NUMBER and DERIVED_COMPONENT. The default value is COMPONENT_NUMBER.

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

  • sign (Literal[POSITIVE, NEGATIVE], default: POSITIVE) – A SymbolicConstant specifying the sign of the contribution. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

  • scaleFactor (float, default: 1) – A Float specifying the scaling factor for the contribution. The default value is 1.0.

  • positiveExponent (float, default: 2) – A Float specifying the positive exponent for the contribution. The default value is 2.0.This argument is ignored if the potential operator of the invoking behavior option is set to MAXIMUM.

  • shiftFactor (float, default: 0) – A Float specifying the shift factor for the contribution. The default value is 0.0.

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

Returns:

A ConnectorPotential object.

Return type:

ConnectorPotential

Raises:

ValueError –

ConnectorStop(minMotion=None, maxMotion=None, components=())[source]

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorStop
import odbConnectorBehavior
odbConnectorBehavior.ConnectorStop
Parameters:
  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

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

Returns:

A ConnectorStop object.

Return type:

ConnectorStop

Raises:

ValueError –

Other Classes

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

Bases: object

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]

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 (Literal[SUM, RSS, MACAULEY], 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 (Literal[POSITIVE, NEGATIVE], 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: 0) – 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 (Literal[POSITION, MOTION], 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: 0) – 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 –

Member Details:

ConnectorOptions(useBehRegSettings=1, regularize=1, defaultTolerance=1, regularization=0, defaultRateFactor=1, rateFactor=0, interpolation=abaqusConstants.LINEAR, useBehExtSettings=1, extrapolation=abaqusConstants.CONSTANT)[source]

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

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:
  • useBehRegSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for regularization options. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

  • regularize (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the tabular data will be regularized. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF. The default value is ON.

  • defaultTolerance (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default regularization tolerance will be used. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF and regularize = ON. The default value is ON.

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

  • defaultRateFactor (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default rate filter factor will be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. The default value is ON.

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

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

  • useBehExtSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for extrapolation options. The default value is ON.

  • extrapolation (Literal[CONSTANT, LINEAR], default: CONSTANT) – A SymbolicConstant specifying the extrapolation technique to be used. This argument is applicable only if useBehExtSettings = OFF. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

Returns:

A ConnectorOptions object.

Return type:

ConnectorOptions

Raises:

ValueError –

fieldDependencies: int = 0[source]

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

indepCompType: SymbolicConstant = 'POSITION'[source]

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 = ()[source]

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.

intrinsicComponents: tuple[source]

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.

localDependency: Union[AbaqusBoolean, bool] = 0[source]

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.

options: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

setValues(*args, **kwargs)[source]

This method modifies the CDCTerm object.

Raises:

ValueError –

table: tuple[source]

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.

tempDependency: Union[AbaqusBoolean, bool] = 0[source]

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

termOperator: SymbolicConstant = 'RSS'[source]

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.

Type:

A SymbolicConstant specifying the method for combining contributing terms

termSign: SymbolicConstant = 'POSITIVE'[source]

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

class ConnectorOptions(useBehRegSettings=1, regularize=1, defaultTolerance=1, regularization=0, defaultRateFactor=1, rateFactor=0, interpolation=abaqusConstants.LINEAR, useBehExtSettings=1, extrapolation=abaqusConstants.CONSTANT)[source]

Bases: object

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

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

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
mdb.models[name].sections[name].behaviorOptions[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].derivedComponent.cdcTerms[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].derivedComponent.cdcTerms[i].ConnectorOptions
session.odbs[name].sections[name].behaviorOptions[i].ConnectorOptions
Parameters:
  • useBehRegSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for regularization options. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

  • regularize (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the tabular data will be regularized. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF. The default value is ON.

  • defaultTolerance (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default regularization tolerance will be used. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF and regularize = ON. The default value is ON.

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

  • defaultRateFactor (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default rate filter factor will be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. The default value is ON.

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

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

  • useBehExtSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for extrapolation options. The default value is ON.

  • extrapolation (Literal[CONSTANT, LINEAR], default: CONSTANT) – A SymbolicConstant specifying the extrapolation technique to be used. This argument is applicable only if useBehExtSettings = OFF. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

Returns:

A ConnectorOptions object.

Return type:

ConnectorOptions

Raises:

ValueError –

Member Details:

defaultRateFactor: Union[AbaqusBoolean, bool] = 1[source]

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

defaultTolerance: Union[AbaqusBoolean, bool] = 1[source]

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

extrapolation: SymbolicConstant = 'CONSTANT'[source]

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

interpolation: SymbolicConstant = 'LINEAR'[source]

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

rateFactor: float = 0[source]

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

regularization: float = 0[source]

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

regularize: Union[AbaqusBoolean, bool] = 1[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorOptions object.

Raises:

ValueError –

useBehExtSettings: Union[AbaqusBoolean, bool] = 1[source]

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

useBehRegSettings: Union[AbaqusBoolean, bool] = 1[source]

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

class ConnectorBehaviorOption[source]

Bases: object

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]

Member Details:

ConnectorOptions(useBehRegSettings=1, regularize=1, defaultTolerance=1, regularization=0, defaultRateFactor=1, rateFactor=0, interpolation=abaqusConstants.LINEAR, useBehExtSettings=1, extrapolation=abaqusConstants.CONSTANT)[source]

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

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
Parameters:
  • useBehRegSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for regularization options. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

  • regularize (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the tabular data will be regularized. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF. The default value is ON.

  • defaultTolerance (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default regularization tolerance will be used. This argument is applicable only for an Abaqus/Explicit analysis and only if useBehRegSettings = OFF and regularize = ON. The default value is ON.

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

  • defaultRateFactor (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not the analysis default rate filter factor will be used. This argument is applicable only for an Abaqus/Explicit analysis that includes isotropic hardening with tabular definition or damage initiation with Plastic motion criteria. The default value is ON.

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

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

  • useBehExtSettings (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether or not to use the behavior-level settings for extrapolation options. The default value is ON.

  • extrapolation (Literal[CONSTANT, LINEAR], default: CONSTANT) – A SymbolicConstant specifying the extrapolation technique to be used. This argument is applicable only if useBehExtSettings = OFF. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

Returns:

A ConnectorOptions object.

Return type:

ConnectorOptions

Raises:

ValueError –

DerivedComponent()[source]

This method creates a DerivedComponent object.

Note

This function can be accessed by:

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

A DerivedComponent object.

Return type:

DerivedComponent

Raises:

ValueError –

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

This method creates a TangentialBehavior object.

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
Parameters:
  • formulation (Literal[PENALTY, EXPONENTIAL_DECAY], default: PENALTY) – A SymbolicConstant specifying the friction coefficient formulation. Possible values are PENALTY and EXPONENTIAL_DECAY. The default value is PENALTY.

  • slipRateDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on slip rate. The default value is OFF.

  • pressureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on contact pressure. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

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

  • exponentialDecayDefinition (Literal[TEST_DATA, COEFFICIENTS], default: COEFFICIENTS) – A SymbolicConstant specifying the exponential decay definition for the data. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.

  • shearStressLimit (Optional[float], default: None) – None or a Float specifying no upper limit or the friction coefficient shear stress limit. The default value is None.

  • maximumElasticSlip (Literal[FRACTION, ABSOLUTE_DISTANCE], default: FRACTION) – A SymbolicConstant specifying the method for modifying the allowable elastic slip. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.This argument applies only to Abaqus/Standard analyses.

  • fraction (Optional[float], default: None) – A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension. The default value is 10⁻⁴.This argument applies only to Abaqus/Standard analyses.

  • absoluteDistance (Optional[float], default: None) – None or a Float specifying the absolute magnitude of the allowable elastic slip. The default value is None.This argument applies only to Abaqus/Standard analyses.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the tangential properties. Items in the table data are described below. The default value is an empty sequence.

Returns:

A TangentialBehavior object.

Return type:

TangentialBehavior

connectorPotentials: List[ConnectorPotential] = [][source]

A ConnectorPotentialArray object.

derivedComponent: DerivedComponent = <abaqus.Connector.ConnectorBehaviorOption.DerivedComponent object>[source]

A DerivedComponent object.

evolutionPotentials: List[ConnectorPotential] = [][source]

A ConnectorPotentialArray object.

initiationOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

A ConnectorOptions object.

initiationPotentials: List[ConnectorPotential] = [][source]

A ConnectorPotentialArray object.

isotropicOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

A ConnectorOptions object.

kinematicOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

A ConnectorOptions object.

options: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

tangentialBehavior: TangentialBehavior = <abaqus.Connector.TangentialBehavior.TangentialBehavior object>[source]

A TangentialBehavior object

class DerivedComponent[source]

Bases: object

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

This method creates a DerivedComponent object.

Note

This function can be accessed by:

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

A DerivedComponent object.

Return type:

DerivedComponent

Raises:

ValueError –

Member Details:

CDCTerm(intrinsicComponents, table, termOperator=abaqusConstants.RSS, termSign=abaqusConstants.POSITIVE, localDependency=0, indepCompType=abaqusConstants.POSITION, indepComponents=(), tempDependency=0, 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
mdb.models[name].sections[name].behaviorOptions[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
mdb.models[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].connectorPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].evolutionPotentials[i].DerivedComponent
session.odbs[name].sections[name].behaviorOptions[i].initiationPotentials[i].DerivedComponent
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 (Literal[SUM, RSS, MACAULEY], 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 (Literal[POSITIVE, NEGATIVE], 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: 0) – 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 (Literal[POSITION, MOTION], 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: 0) – 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 –

cdcTerms: List[CDCTerm] = [][source]

A CDCTermArray object.

setValues(*args, **kwargs)[source]

This method modifies the DerivedComponent object.

Raises:

ValueError –

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

Bases: object

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

This method creates a TangentialBehavior object.

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].TangentialBehavior
session.odbs[name].sections[name].behaviorOptions[i].TangentialBehavior
Parameters:
  • formulation (Literal[PENALTY, EXPONENTIAL_DECAY], default: PENALTY) – A SymbolicConstant specifying the friction coefficient formulation. Possible values are PENALTY and EXPONENTIAL_DECAY. The default value is PENALTY.

  • slipRateDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on slip rate. The default value is OFF.

  • pressureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on contact pressure. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

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

  • exponentialDecayDefinition (Literal[TEST_DATA, COEFFICIENTS], default: COEFFICIENTS) – A SymbolicConstant specifying the exponential decay definition for the data. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.

  • shearStressLimit (Optional[float], default: None) – None or a Float specifying no upper limit or the friction coefficient shear stress limit. The default value is None.

  • maximumElasticSlip (Literal[FRACTION, ABSOLUTE_DISTANCE], default: FRACTION) – A SymbolicConstant specifying the method for modifying the allowable elastic slip. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.This argument applies only to Abaqus/Standard analyses.

  • fraction (Optional[float], default: None) – A Float specifying the ratio of the allowable maximum elastic slip to a characteristic model dimension. The default value is 10⁻⁴.This argument applies only to Abaqus/Standard analyses.

  • absoluteDistance (Optional[float], default: None) – None or a Float specifying the absolute magnitude of the allowable elastic slip. The default value is None.This argument applies only to Abaqus/Standard analyses.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the tangential properties. Items in the table data are described below. The default value is an empty sequence.

Returns:

A TangentialBehavior object.

Return type:

TangentialBehavior

Member Details:

absoluteDistance: Optional[float] = None[source]

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

dependencies: int = 0[source]

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

exponentialDecayDefinition: SymbolicConstant = 'COEFFICIENTS'[source]

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

formulation: SymbolicConstant = 'PENALTY'[source]

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

fraction: Optional[float] = None[source]

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

maximumElasticSlip: SymbolicConstant = 'FRACTION'[source]

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

pressureDependency: Union[AbaqusBoolean, bool] = 0[source]

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

setValues(*args, **kwargs)[source]

This method modifies the TangentialBehavior object.

shearStressLimit: Optional[float] = None[source]

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

slipRateDependency: Union[AbaqusBoolean, bool] = 0[source]

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

table: tuple = ()[source]

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

temperatureDependency: Union[AbaqusBoolean, bool] = 0[source]

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

class ConnectorDamage(coupling=abaqusConstants.UNCOUPLED, criterion=abaqusConstants.FORCE, initiationTemperature=0, initiationPotentialOperator=abaqusConstants.SUM, initiationPotentialExponent=2, initiationDependencies=0, evolution=1, evolutionType=abaqusConstants.MOTION_TYPE, softening=abaqusConstants.LINEAR, useAffected=0, degradation=abaqusConstants.MAXIMUM, evolutionTemperature=0, evolutionDependencies=0, evolutionPotentialOperator=abaqusConstants.SUM, evolutionPotentialExponent=2, initiationPotentials=None, evolutionPotentials=None, initiationTable=(), evolutionTable=(), affectedComponents=(), components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamage
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamage
Parameters:
  • coupling (Literal[COUPLED, UNCOUPLED], default: UNCOUPLED) – A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

  • criterion (Literal[PLASTIC_MOTION, FORCE, MOTION], default: FORCE) – A SymbolicConstant specifying the damage initiation criterion to be used. Possible values are FORCE, MOTION, and PLASTIC_MOTION. The default value is FORCE.

  • initiationTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the initiation data depend on temperature. The default value is OFF.

  • initiationPotentialOperator (Literal[SUM, MOTION, COUPLED, FORCE, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the initiation potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is only if coupling = COUPLED and if criterion = FORCE or MOTION.

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

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

  • evolution (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether damage evolution data will be used. The default value is ON.

  • evolutionType (Literal[ENERGY_TYPE, MOTION_TYPE], default: MOTION_TYPE) – A SymbolicConstant specifying the type of damage evolution to be specified. Possible values are MOTION_TYPE and ENERGY_TYPE. The default value is MOTION_TYPE.This argument is applicable only if evolution = ON.

  • softening (Literal[EXPONENTIAL, TABULAR, MOTION_TYPE, LINEAR], default: LINEAR) – A SymbolicConstant specifying the damage evolution law to be specified. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.This argument is applicable only if evolution = ON and when evolutionType = MOTION_TYPE.

  • useAffected (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether or not affectedComponents will be specified. If useAffected = OFF, then only the components of relative motion specified by components will undergo damage. The default value is OFF.This argument is applicable only if evolution = ON.

  • degradation (Literal[MULTIPLICATIVE, MAXIMUM], default: MAXIMUM) – A SymbolicConstant specifying the contribution of each damage mechanism when more than one damage mechanism is defined. Possible values are MAXIMUM and MULTIPLICATIVE. The default value is MAXIMUM.This argument is applicable if evolution = ON.

  • evolutionTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the evolution data depend on temperature. The default value is OFF.This argument is applicable only if evolution = ON.

  • evolutionDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the evolution data. The default value is 0.This argument is applicable only if evolution = ON.

  • evolutionPotentialOperator (Literal[SUM, MOTION, MOTION_TYPE, COUPLED, FORCE, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the evolution potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if coupling = COUPLED, when evolution = ON, when evolutionType = MOTION_TYPE, and when criterion = FORCE or MOTION.

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

  • initiationPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each initiation potential contribution. This member can be specified only if coupling = COUPLED and if criterion = FORCE or MOTION.

  • evolutionPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each evolution potential contribution). This member can be specified only if coupling = COUPLED, if evolution = ON, if evolutionType = MOTION, and if criterion = FORCE or MOTION.

  • initiationTable (tuple, default: ()) – A sequence of sequences of Floats specifying the initiation properties. The default value is an empty sequence.Items in the initiationTable data are described below.

  • evolutionTable (tuple, default: ()) – A sequence of sequences of Floats specifying the evolution properties. The default value is an empty sequence.Items in the evolutionTable data are described below. This argument is only applicable if evolution = ON.

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

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

Returns:

A ConnectorDamage object.

Return type:

ConnectorDamage

Raises:

ValueError –

Member Details:

affectedComponents: Sequence[int] = ()[source]

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

components: tuple = ()[source]

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

coupling: SymbolicConstant = 'UNCOUPLED'[source]

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

criterion: SymbolicConstant = 'FORCE'[source]

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

degradation: SymbolicConstant = 'MAXIMUM'[source]

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

evolution: Boolean = 1[source]

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

evolutionDependencies: int = 0[source]

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

evolutionOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

evolutionPotentialExponent: float = 2[source]

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

evolutionPotentialOperator: SymbolicConstant = 'SUM'[source]

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

evolutionPotentials: ConnectorPotentialArray = [][source]

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

evolutionTable: tuple = ()[source]

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

evolutionTemperature: Boolean = 0[source]

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

evolutionType: SymbolicConstant = 'MOTION_TYPE'[source]

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

initiationDependencies: int = 0[source]

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

initiationOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

initiationPotentialExponent: float = 2[source]

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

initiationPotentialOperator: SymbolicConstant = 'SUM'[source]

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

initiationTable: Sequence[Sequence[float]] = ()[source]

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

initiationTemperature: Boolean = 0[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorDamage object.

Raises:

ValueError –

softening: SymbolicConstant = 'LINEAR'[source]

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

useAffected: Boolean = 0[source]

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

class ConnectorDamping(type=abaqusConstants.VISCOUS, behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=0, frequencyDependency=0, table=(), independentComponents=(), components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorDamping
import odbConnectorBehavior
odbConnectorBehavior.ConnectorDamping
Parameters:
  • type (Literal[STRUCTURAL, VISCOUS], default: VISCOUS) –

    A SymbolicConstant specifying if the damping type is viscous or structural. Possible values are VISCOUS and STRUCTURAL. The default value is VISCOUS.

    New in version 2022: The type argument was added.

  • behavior (Literal[NONLINEAR, LINEAR], default: LINEAR) – A SymbolicConstant specifying if the damping behavior is linear or nonlinear. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.

  • coupling (Literal[UNCOUPLED, NONLINEAR, COUPLED_POSITION, COUPLED_MOTION, COUPLED, LINEAR], default: UNCOUPLED) – A SymbolicConstant specifying whether the damping behavior is coupled between the connector’s components of relative motion. If behavior = LINEAR, then possible values are UNCOUPLED and COUPLED. If behavior = NONLINEAR, then possible values are UNCOUPLED, COUPLED_POSITION, and COUPLED_MOTION. Possible values are UNCOUPLED, COUPLED, COUPLED_POSITION, and COUPLED_MOTION. The default value is UNCOUPLED.

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

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if behavior = LINEAR and coupling = UNCOUPLED. The default value is OFF.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying damping properties. Items in the table data are described below. The default value is an empty sequence.

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

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

Returns:

A ConnectorDamping object.

Return type:

ConnectorDamping

Raises:

ValueError –

Member Details:

behavior: SymbolicConstant = 'LINEAR'[source]

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

components: tuple = ()[source]

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

coupling: SymbolicConstant = 'UNCOUPLED'[source]

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

dependencies: int = 0[source]

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

frequencyDependency: Union[AbaqusBoolean, bool] = 0[source]

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

independentComponents: tuple = ()[source]

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

options: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorDamping object.

Raises:

ValueError –

table: tuple = ()[source]

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

temperatureDependency: Union[AbaqusBoolean, bool] = 0[source]

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

type: SymbolicConstant = 'VISCOUS'[source]

A SymbolicConstant specifying if the damping type is viscous or structural. Possible values are VISCOUS and STRUCTURAL. The default value is VISCOUS.

New in version 2022: The type attribute was added.

class ConnectorElasticity(behavior=abaqusConstants.LINEAR, coupling=abaqusConstants.UNCOUPLED, dependencies=0, temperatureDependency=0, frequencyDependency=0, table=(), independentComponents=(), components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorElasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorElasticity
Parameters:
  • behavior (Literal[RIGID, NONLINEAR, LINEAR], default: LINEAR) – A SymbolicConstant specifying whether the elastic behavior is linear, nonlinear, or rigid. Possible values are LINEAR, NONLINEAR, and RIGID. The default value is LINEAR.

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

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.This argument is not applicable if behavior = RIGID.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on temperature. The default value is OFF.This argument is not applicable if behavior = RIGID.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if behavior = LINEAR and coupling = UNCOUPLED. The default value is OFF.This argument is not applicable if behavior = RIGID.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying elasticity properties. Items in the table data are described below. This argument is not applicable if behavior = RIGID. The default value is an empty sequence.

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

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

Returns:

A ConnectorElasticity object.

Return type:

ConnectorElasticity

Raises:

ValueError –

Member Details:

behavior: SymbolicConstant = 'LINEAR'[source]

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

components: tuple = ()[source]

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

coupling: SymbolicConstant = 'UNCOUPLED'[source]

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

dependencies: int = 0[source]

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

frequencyDependency: Union[AbaqusBoolean, bool] = 0[source]

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

independentComponents: tuple = ()[source]

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

options: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorElasticity object.

Raises:

ValueError –

table: tuple = ()[source]

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

temperatureDependency: Union[AbaqusBoolean, bool] = 0[source]

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

class ConnectorFailure(releaseComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFailure
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFailure
Parameters:
  • releaseComponent (Literal[ALL], default: ALL) – The SymbolicConstant ALL or an Int specifying the motion components that fail. If an Int is specified, only that motion component fails when the failure criteria are satisfied. If releaseComponent = ALL, all motion components fail. The default value is ALL.

  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

  • minForce (Optional[float], default: None) – None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

  • maxForce (Optional[float], default: None) – None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

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

Returns:

A ConnectorFailure object.

Return type:

ConnectorFailure

Raises:

ValueError –

Member Details:

components: tuple = ()[source]

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

maxForce: float | None = None[source]

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

maxMotion: float | None = None[source]

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

minForce: float | None = None[source]

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

minMotion: float | None = None[source]

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

releaseComponent: SymbolicConstant = 'ALL'[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorFailure object.

Raises:

ValueError –

class ConnectorFriction(frictionModel=abaqusConstants.PREDEFINED, slipStyle=abaqusConstants.SPECIFY, tangentDirection=None, stickStiffness=None, componentType=abaqusConstants.NO_INDEPENDENT_COMPONENTS, slipDependency=0, temperatureDependency=0, dependencies=0, useContactForceComponent=0, contactForceStyle=abaqusConstants.COMPONENT_NUMBER, contactForceComponent=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, table=(), independentComponents=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorFriction
import odbConnectorBehavior
odbConnectorBehavior.ConnectorFriction
Parameters:
  • frictionModel (Literal[PREDEFINED, USER_CUSTOMIZED], default: PREDEFINED) – A SymbolicConstant specifying the desired frictional response model. Possible values are PREDEFINED and USER_CUSTOMIZED. The default value is PREDEFINED.

  • slipStyle (Literal[COMPUTE, SPECIFY, USER_CUSTOMIZED], default: SPECIFY) – A SymbolicConstant specifying the method of indicating the slip direction: either specified or computed based upon the force potential data. Possible values are SPECIFY and COMPUTE. The default value is SPECIFY.This argument is applicable only if frictionModel = USER_CUSTOMIZED.

  • tangentDirection (Optional[int], default: None) – None or an Int specifying the direction for which the frictional behavior is specified. Possible values are 1 ≤ tangentDirection ≤ 6, indicating an available component of relative motion. This argument applies only if frictionModel = USER_CUSTOMIZED and if slipStyle = SPECIFY. The default value is None.

  • stickStiffness (Optional[float], default: None) – None or a Float specifying the stick stiffness associated with the frictional behavior in the direction specified by tangentDirection. If this argument is omitted, Abaqus computes an appropriate number for the stick stiffness. The default value is None.

  • componentType (Literal[POSITION, MOTION, NO_INDEPENDENT_COMPONENTS], default: NO_INDEPENDENT_COMPONENTS) – A SymbolicConstant specifying the type of the independentComponents. Possible values are POSITION, MOTION, and NO_INDEPENDENT_COMPONENTS. The default value is NO_INDEPENDENT_COMPONENTS.

  • slipDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the table data depend on accumulated slip. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the table data depend on temperature. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • useContactForceComponent (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the contact force component will be defined. The default value is OFF.This argument applies only if frictionModel = USER_CUSTOMIZED.

  • contactForceStyle (Literal[COMPONENT_NUMBER, USER_CUSTOMIZED, DERIVED_COMPONENT], default: COMPONENT_NUMBER) – A SymbolicConstant specifying the method of indicating the contact force component direction: either specified or computed based on upon a DerivedComponent. Possible values are COMPONENT_NUMBER and DERIVED_COMPONENT. The default value is COMPONENT_NUMBER.This argument is applicable only if frictionModel = USER_CUSTOMIZED and if useContactForceComponent = ON.

  • contactForceComponent (int, default: 0) – An Int specifying the contact force component direction. This argument applies only if frictionModel = USER_CUSTOMIZED, if useContactForceComponent = ON, and if contactForceStyle = COMPONENT_NUMBER. The default value is 0.

  • forcePotentialOperator (Literal[SUM, COMPUTE, USER_CUSTOMIZED, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the force potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if frictionModel = USER_CUSTOMIZED and if slipStyle = COMPUTE.

  • forcePotentialExponent (float, default: 2) – A Float specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.This argument is applicable only if frictionModel = USER_CUSTOMIZED, if slipStyle = COMPUTE, and if forcePotentialOperator = SUM.

  • connectorPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if frictionModel = USER_CUSTOMIZED, and if slipStyle = COMPUTE.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying friction properties. The default value is an empty sequence.If frictionModel = PREDEFINED, each sequence of the table data specifies:If applicable, the first geometric scaling constant relevant to frictional interactions.Etc., up to as many geometric scaling constants as are associated with this connection type.Internal contact force/moment generating friction in the first predefined slip direction.If applicable, internal contact force/moment generating friction in the second predefined slip direction.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the first predefined slip direction, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.If frictionModel = USER_CUSTOMIZED, each sequence of the table data specifies:Effective radius of the cylindrical or spherical surface over which frictional slip occurs in the connector associated with frictional effects in the direction specified by tangentDirection. This radius is relevant only if the connection type includes an available rotational component of relative motion and tangentDirection = SLIP_DIRECTION.Internal contact force/moment generating friction in the direction specified by tangentDirection.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the direction specified by tangentDirection, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.

  • independentComponents (tuple, default: ()) – A sequence of Ints specifying the independent components. Possible values are 1 ≤ independentComponents ≤ 6. In addition, each independent component value must be unique. The independentComponents argument applies only if frictionModel = USER_CUSTOMIZED. Only available components can be specified. The default value is an empty sequence.

Returns:

A ConnectorFriction object.

Return type:

ConnectorFriction

Raises:

ValueError –

Member Details:

componentType: SymbolicConstant = 'NO_INDEPENDENT_COMPONENTS'[source]

A SymbolicConstant specifying the type of the independentComponents. Possible values are POSITION, MOTION, and NO_INDEPENDENT_COMPONENTS. The default value is NO_INDEPENDENT_COMPONENTS.

connectorPotentials: List[ConnectorPotential] = [][source]

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

contactForceComponent: int = 0[source]

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

contactForceStyle: SymbolicConstant = 'COMPONENT_NUMBER'[source]

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

dependencies: int = 0[source]

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

derivedComponent: DerivedComponent = <abaqus.Connector.DerivedComponent.DerivedComponent object>[source]

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

forcePotentialExponent: float = 2[source]

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

forcePotentialOperator: SymbolicConstant = 'SUM'[source]

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

frictionModel: SymbolicConstant = 'PREDEFINED'[source]

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

independentComponents: tuple = ()[source]

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

options: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorFriction object.

Raises:

ValueError –

slipDependency: Union[AbaqusBoolean, bool] = 0[source]

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

slipStyle: SymbolicConstant = 'SPECIFY'[source]

either specified or computed based upon the force potential data. Possible values are SPECIFY and COMPUTE. The default value is SPECIFY.This argument is applicable only if frictionModel = USER_CUSTOMIZED.

Type:

A SymbolicConstant specifying the method of indicating the slip direction

stickStiffness: Optional[float] = None[source]

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

table: tuple = ()[source]

A sequence of sequences of Floats specifying friction properties. The default value is an empty sequence.If frictionModel = PREDEFINED, each sequence of the table data specifies:If applicable, the first geometric scaling constant relevant to frictional interactions.Etc., up to as many geometric scaling constants as are associated with this connection type.Internal contact force/moment generating friction in the first predefined slip direction.If applicable, internal contact force/moment generating friction in the second predefined slip direction.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the first predefined slip direction, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.If frictionModel = USER_CUSTOMIZED, each sequence of the table data specifies:Effective radius of the cylindrical or spherical surface over which frictional slip occurs in the connector associated with frictional effects in the direction specified by tangentDirection. This radius is relevant only if the connection type includes an available rotational component of relative motion and tangentDirection = SLIP_DIRECTION.Internal contact force/moment generating friction in the direction specified by tangentDirection.Connector constitutive relative motion in the direction specified by independentComponent.Accumulated slip in the direction specified by tangentDirection, if the data depend on accumulated slip.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.

tangentDirection: Optional[int] = None[source]

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

tangentialBehavior: TangentialBehavior = <abaqus.Connector.TangentialBehavior.TangentialBehavior object>[source]

A TangentialBehavior object.

temperatureDependency: Union[AbaqusBoolean, bool] = 0[source]

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

useContactForceComponent: Union[AbaqusBoolean, bool] = 0[source]

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

class ConnectorLock(lockingComponent=abaqusConstants.ALL, minMotion=None, maxMotion=None, minForce=None, maxForce=None, components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorLock
import odbConnectorBehavior
odbConnectorBehavior.ConnectorLock
Parameters:
  • lockingComponent (Literal[ALL], default: ALL) – The SymbolicConstant ALL or an Int specifying the motion components that are locked. If an Int is specified, only that motion component is locked when the locking criteria are satisfied. If lockingComponent = ALL, all motion components are locked. The default value is ALL.

  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

  • minForce (Optional[float], default: None) – None or a Float specifying the lower bound of the force or moment in the directions of the specified components at which locking occurs, or no lower bound. The default value is None.

  • maxForce (Optional[float], default: None) – None or a Float specifying the upper bound of the force or moment in the directions of the specified components at which locking occurs, or no upper bound. The default value is None.

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

Returns:

A ConnectorLock object.

Return type:

ConnectorLock

Raises:

ValueError –

Member Details:

components: tuple = ()[source]

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

lockingComponent: SymbolicConstant = 'ALL'[source]

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

maxForce: float | None = None[source]

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

maxMotion: float | None = None[source]

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

minForce: float | None = None[source]

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

minMotion: float | None = None[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorLock object.

Raises:

ValueError –

class ConnectorPlasticity(coupling=abaqusConstants.UNCOUPLED, isotropic=1, isotropicType=abaqusConstants.TABULAR, isotropicTemperature=0, isotropicDependencies=0, kinematic=0, kinematicType=abaqusConstants.HALF_CYCLE, kinematicTemperature=0, kinematicDependencies=0, forcePotentialOperator=abaqusConstants.SUM, forcePotentialExponent=2, connectorPotentials=None, isotropicTable=(), kinematicTable=(), components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorPlasticity
import odbConnectorBehavior
odbConnectorBehavior.ConnectorPlasticity
Parameters:
  • coupling (Literal[COUPLED, UNCOUPLED], default: UNCOUPLED) – A SymbolicConstant specifying whether or not the behavior is coupled. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.

  • isotropic (Union[AbaqusBoolean, bool], default: 1) – A Boolean specifying whether isotropic hardening data will be used. The default value is ON.If isotropic = OFF, then kinematic must be specified as ON.

  • isotropicType (Literal[TABULAR, EXPONENTIAL_LAW], default: TABULAR) – A SymbolicConstant specifying the type of isotropic hardening to be specified. Possible values are TABULAR and EXPONENTIAL_LAW. The default value is TABULAR.This argument is applicable only if isotropic = ON.

  • isotropicTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the isotropic data depend on temperature. The default value is OFF.This argument is applicable only if isotropic = ON.

  • isotropicDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the isotropic data. The default value is 0.This argument is applicable only if isotropic = ON.

  • kinematic (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether kinematic hardening data will be used. The default value is OFF.If kinematic = OFF, then isotropic must be specified as ON.

  • kinematicType (Literal[PARAMETERS, HALF_CYCLE, STABILIZED], default: HALF_CYCLE) – A SymbolicConstant specifying the type of kinematic hardening to be specified. Possible values are HALF_CYCLE, STABILIZED, and PARAMETERS. The default value is HALF_CYCLE.This argument is applicable only if kinematic = ON.

  • kinematicTemperature (Union[AbaqusBoolean, bool], default: 0) – A Boolean specifying whether the kinematic data depend on temperature. The default value is OFF.This argument is applicable only if kinematic = ON.

  • kinematicDependencies (int, default: 0) – An Int specifying the number of field variable dependencies for the kinematic data. The default value is 0.This argument is applicable only if kinematic = ON.

  • forcePotentialOperator (Literal[SUM, COUPLED, MAXIMUM], default: SUM) – A SymbolicConstant specifying the contribution operator for the force potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if coupling = COUPLED.

  • forcePotentialExponent (float, default: 2) – A Float specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.This argument is applicable only if coupling = COUPLED and if forcePotentialOperator = SUM.

  • connectorPotentials (Optional[List[ConnectorPotential]], default: None) – A ConnectorPotentialArray object specifying one ConnectorPotential object for each force potential contribution. This member can be specified only if coupling = COUPLED.

  • isotropicTable (tuple, default: ()) – A sequence of sequences of Floats specifying isotropic plasticity properties. Items in the isotropicTable data are described below. This argument is applicable only if isotropic = ON. The default value is an empty sequence.

  • kinematicTable (tuple, default: ()) – A sequence of sequences of Floats specifying kinematic plasticity properties. Items in the kinematicTable data are described below. This argument is applicable only if kinematic = ON. The default value is an empty sequence.

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

Returns:

A ConnectorPlasticity object.

Return type:

ConnectorPlasticity

Raises:

ValueError –

Member Details:

components: tuple = ()[source]

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

connectorPotentials: ConnectorPotentialArray = [][source]

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

coupling: SymbolicConstant = 'UNCOUPLED'[source]

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

forcePotentialExponent: float = 2[source]

A Float specifying the number equal to the inverse of the overall exponent in the force potential definition. The default value is 2.0.This argument is applicable only if coupling = COUPLED and if forcePotentialOperator = SUM.

forcePotentialOperator: SymbolicConstant = 'SUM'[source]

A SymbolicConstant specifying the contribution operator for the force potential contributions. Possible values are SUM and MAXIMUM. The default value is SUM.This argument is applicable only if coupling = COUPLED.

isotropic: Boolean = 1[source]

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

isotropicDependencies: int = 0[source]

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

isotropicOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

isotropicTable: tuple = ()[source]

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

isotropicTemperature: Boolean = 0[source]

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

isotropicType: SymbolicConstant = 'TABULAR'[source]

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

kinematic: Boolean = 0[source]

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

kinematicDependencies: int = 0[source]

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

kinematicOptions: ConnectorOptions = <abaqus.Connector.ConnectorOptions.ConnectorOptions object>[source]

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

kinematicTable: tuple = ()[source]

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

kinematicTemperature: Boolean = 0[source]

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

kinematicType: SymbolicConstant = 'HALF_CYCLE'[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorPlasticity object.

Raises:

ValueError –

class ConnectorPotential(componentStyle=abaqusConstants.COMPONENT_NUMBER, componentNumber=0, sign=abaqusConstants.POSITIVE, scaleFactor=1, positiveExponent=2, shiftFactor=0, hFunction=abaqusConstants.ABS)[source]

Bases: object

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

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

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].ConnectorPotential
session.odbs[name].sections[name].behaviorOptions[i].ConnectorPotential
Parameters:
  • componentStyle (Literal[COMPONENT_NUMBER, DERIVED_COMPONENT], default: COMPONENT_NUMBER) – A SymbolicConstant specifying whether a component number or the name of the DerivedComponent object will be used in the contribution. Possible values are COMPONENT_NUMBER and DERIVED_COMPONENT. The default value is COMPONENT_NUMBER.

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

  • sign (Literal[POSITIVE, NEGATIVE], default: POSITIVE) – A SymbolicConstant specifying the sign of the contribution. Possible values are POSITIVE and NEGATIVE. The default value is POSITIVE.

  • scaleFactor (float, default: 1) – A Float specifying the scaling factor for the contribution. The default value is 1.0.

  • positiveExponent (float, default: 2) – A Float specifying the positive exponent for the contribution. The default value is 2.0.This argument is ignored if the potential operator of the invoking behavior option is set to MAXIMUM.

  • shiftFactor (float, default: 0) – A Float specifying the shift factor for the contribution. The default value is 0.0.

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

Returns:

A ConnectorPotential object.

Return type:

ConnectorPotential

Raises:

ValueError –

Member Details:

DerivedComponent()[source]

This method creates a DerivedComponent object.

Note

This function can be accessed by:

mdb.models[name].sections[name].behaviorOptions[i].ConnectorPotential
session.odbs[name].sections[name].behaviorOptions[i].ConnectorPotential
Returns:

A DerivedComponent object.

Return type:

DerivedComponent

Raises:

ValueError –

componentNumber: int = 0[source]

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

componentStyle: SymbolicConstant = 'COMPONENT_NUMBER'[source]

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

derivedComponent: DerivedComponent = <abaqus.Connector.DerivedComponent.DerivedComponent object>[source]

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

hFunction: SymbolicConstant = 'ABS'[source]

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

Type:

A SymbolicConstant specifying the H function of the contribution

positiveExponent: float = 2[source]

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

scaleFactor: float = 1[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorPotential object.

Raises:

ValueError –

shiftFactor: float = 0[source]

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

sign: SymbolicConstant = 'POSITIVE'[source]

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

class ConnectorStop(minMotion=None, maxMotion=None, components=())[source]

Bases: ConnectorBehaviorOption

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

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

Note

This function can be accessed by:

import connectorBehavior
connectorBehavior.ConnectorStop
import odbConnectorBehavior
odbConnectorBehavior.ConnectorStop
Parameters:
  • minMotion (Optional[float], default: None) – None or a Float specifying the lower bound for the connector’s relative position for all specified components, or no lower bound. The default value is None.

  • maxMotion (Optional[float], default: None) – None or a Float specifying the upper bound for the connector’s relative position for all specified components, or no upper bound. The default value is None.

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

Returns:

A ConnectorStop object.

Return type:

ConnectorStop

Raises:

ValueError –

Member Details:

components: tuple = ()[source]

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

maxMotion: float | None = None[source]

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

minMotion: float | None = None[source]

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

setValues(*args, **kwargs)[source]

This method modifies the ConnectorStop object.

Raises:

ValueError –