57.3 ConnectorDamage object

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.

Access

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

57.3.1 ConnectorDamage(...)

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

Path

sectionApi.sections()[name].ConnectorDamage

Prototype

odb_ConnectorDamage&
ConnectorDamage(const odb_String& coupling,
  const odb_String& criterion,
  bool initiationTemperature,
  const odb_String& initiationPotentialOperator,
  double initiationPotentialExponent,
  int initiationDependencies,
  bool evolution,
  const odb_String& evolutionType,
  const odb_String& softening,
  bool useAffected,
  const odb_String& degradation,
  bool evolutionTemperature,
  int evolutionDependencies,
  const odb_String& evolutionPotentialOperator,
  double evolutionPotentialExponent,
  const odb_SequenceConnectorPotential& initiationPotentials,
  const odb_SequenceConnectorPotential& evolutionPotentials,
  const odb_SequenceSequenceDouble& initiationTable,
  const odb_SequenceSequenceDouble& evolutionTable,
  const odb_SequenceInt& affectedComponents,
  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".

criterion

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

initiationTemperature

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

initiationPotentialOperator

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

initiationPotentialExponent

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

initiationDependencies

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

evolution

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

evolutionType

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

softening

An odb_String 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=true and when evolutionType="MOTION_TYPE".

useAffected

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

degradation

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

evolutionTemperature

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

evolutionDependencies

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

evolutionPotentialOperator

An odb_String 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=true, when evolutionType="MOTION_TYPE", and when criterion="FORCE" or "MOTION".

evolutionPotentialExponent

A Double 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=true, when evolutionPotentialOperator="SUM", when evolutionType="MOTION", and when criterion="FORCE" or "MOTION".

initiationPotentials

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

evolutionPotentials

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

initiationTable

An odb_SequenceSequenceDouble specifying the initiation properties. The default value is an empty sequence.
Items in the initiationTable data are described below.

evolutionTable

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

affectedComponents

An odb_SequenceInt 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=true and useAffected=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 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.

Return value

A ConnectorDamage object.

Exceptions

ValueError and TextError.

57.3.2 setValues(...)

This method modifies the ConnectorDamage object.

Required arguments

None.

Optional arguments

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

Return value

None

Exceptions

ValueError.

57.3.3 Members

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

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

Prototype

odb_ConnectorOptions initiationOptions() const;
odb_ConnectorOptions evolutionOptions() const;

initiationOptions

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

evolutionOptions

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

57.3.4 Corresponding analysis keywords

*CONNECTOR DAMAGE INITIATION, *CONNECTOR DAMAGE EVOLUTION, *CONNECTOR POTENTIAL