57.10 ConnectorPlasticity object

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.

Access

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

57.10.1 ConnectorPlasticity(...)

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

Path

sectionApi.sections()[name].ConnectorPlasticity

Prototype

odb_ConnectorPlasticity&
ConnectorPlasticity(const odb_String& coupling,
   bool isotropic,
   const odb_String& isotropicType,
   bool isotropicTemperature,
   int isotropicDependencies,
   bool kinematic,
   const odb_String& kinematicType,
   bool kinematicTemperature,
   int kinematicDependencies,
   const odb_String& forcePotentialOperator,
   double forcePotentialExponent,
   const odb_SequenceConnectorPotential& connectorPotentials,
   const odb_SequenceSequenceDouble& isotropicTable,
   const odb_SequenceSequenceDouble& kinematicTable,
   const odb_SequenceInt& components);

Required arguments

None.

Optional arguments

coupling

An odb_String specifying whether or not the behavior is coupled. Possible values are "UNCOUPLED" and "COUPLED". The default value is "UNCOUPLED".

isotropic

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

isotropicType

An odb_String 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=true.

isotropicTemperature

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

isotropicDependencies

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

kinematic

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

kinematicType

An odb_String 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=true.

kinematicTemperature

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

kinematicDependencies

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

forcePotentialOperator

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

forcePotentialExponent

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

connectorPotentials

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

isotropicTable

An odb_SequenceSequenceDouble specifying isotropic plasticity properties. Items in the isotropicTable data are described below. This argument is applicable only if isotropic=true. The default value is an empty sequence.

kinematicTable

An odb_SequenceSequenceDouble specifying kinematic plasticity properties. Items in the kinematicTable data are described below. This argument is applicable only if kinematic=true. The default value is an empty sequence.

components

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

Table data

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 .
Isotropic hardening parameter .
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 .
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.

Return value

A ConnectorPlasticity object.

Exceptions

ValueError and TextError.

57.10.2 setValues(...)

This method modifies the ConnectorPlasticity object.

Required arguments

None.

Optional arguments

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

Return value

None

Exceptions

ValueError.

57.10.3 Members

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

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

Prototype

odb_ConnectorOptions isotropicOptions() const;
odb_ConnectorOptions kinematicOptions() const;

isotropicOptions

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

kinematicOptions

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

57.10.4 Corresponding analysis keywords

*CONNECTOR PLASTICITY, *CONNECTOR HARDENING, *CONNECTOR POTENTIAL