DamageInitiation object

The DamageInitiation object specifies material properties to define the initiation of damage.

The following topics are discussed:

Access
DuctileDamageInitiation(...)
FldDamageInitiation(...)
FlsdDamageInitiation(...)
JohnsonCookDamageInitiation(...)
MaxeDamageInitiation(...)
MaxsDamageInitiation(...)
MkDamageInitiation(...)
MsfldDamageInitiation(...)
QuadeDamageInitiation(...)
QuadsDamageInitiation(...)
MaxpeDamageInitiation(...)
MaxpsDamageInitiation(...)
ShearDamageInitiation(...)
HashinDamageInitiation(...)
Members
Corresponding analysis keywords

Access

materialApi.materials()[name].ductileDamageInitiation()
materialApi.materials()[name].fldDamageInitiation()
materialApi.materials()[name].flsdDamageInitiation()
materialApi.materials()[name].hashinDamageInitiation()
materialApi.materials()[name].johnsonCookDamageInitiation()
materialApi.materials()[name].maxeDamageInitiation()
materialApi.materials()[name].maxpeDamageInitiation()
materialApi.materials()[name].maxpsDamageInitiation()
materialApi.materials()[name].maxsDamageInitiation()
materialApi.materials()[name].mkDamageInitiation()
materialApi.materials()[name].msfldDamageInitiation()
materialApi.materials()[name].quadeDamageInitiation()
materialApi.materials()[name].quadsDamageInitiation()
materialApi.materials()[name].shearDamageInitiation()

DuctileDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].DuctileDamageInitiation

Prototype

odb_DamageInitiation&
DuctileDamageInitiation(const odb_SequenceSequenceDouble& table,
                        const odb_String& definition,
                        double feq,
                        double fnn,
                        double fnt,
                        int frequency,
                        double ks,
                        int numberImperfections,
                        bool temperatureDependency,
                        int dependencies,
                        double alpha,
                        double omega,
                        double tolerance,
                        const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Table data

If constructor is DuctileDamageInitiation, the table data specify the following:

Equivalent fracture strain at damage initiation.
Stress triaxiality.
Strain 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 constructor is FldDamageInitiation, the table data specify the following:

Major principal strain at damage initiation.
Minor principal strain.
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 constructor FlsdDamageInitiation, the table data specify the following:

Major principal stress at damage initiation.
Minor principal stress.
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 constructor is JohnsonCookDamageInitiation, the table data specify the following:

Johnson-Cook failure parameter D1.
Johnson-Cook failure parameter D2.
Johnson-Cook failure parameter D3.
Johnson-Cook failure parameter D4.
Johnson-Cook failure parameter D5.
Melting temperature.
Transition temperature.
Reference strain rate.

If constructor MkDamageInitiation, the table data specify the following:

Flaw size relative to nominal thickness of the section.
Angle (in degrees) with respect to the 1-direction of the local material orientation.
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 constructor is MsfldDamageInitiation and definition=MSFLD, the table data specify the following:

Nominal strain at damage initiation in a normal-only mode.
Equivalent plastic strain at initiation of localized necking.
Ratio of minor to major principal strains.
Equivalent plastic strain 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 constructor is MsfldDamageInitiation and definition=FLD, the table data specify the following:

Major principal strain at initiation of localized necking.
Equivalent plastic strain at initiation of localized necking.
Ratio of minor to major principal strains.
Equivalent plastic strain 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 constructor is QuadeDamageInitiation or MaxeDamageInitiation, the table data specify the following:

Nominal strain at damage initiation in a normal-only mode.
Nominal strain at damage initiation in a shear-only mode that involves separation only along the first shear direction.
Nominal strain at damage initiation in a shear-only mode that involves separation only along the second shear 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.

If constructor is QuadsDamageInitiation or MaxsDamageInitiation, the table data specify the following:

Nominal strain at damage initiation in a normal-only mode.
Nominal strain at damage initiation in a shear-only mode that involves separation only along the first shear direction.
Nominal strain at damage initiation in a shear-only mode that involves separation only along the second shear 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.

If constructor is MaxpeDamageInitiation, the table data specify the following:

Maximum principal strain at damage initiation.
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 constructor is MaxpsDamageInitiation, the table data specify the following:

Maximum principal stress at damage initiation.
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 constructor is ShearDamageInitiation, the table data specify the following:

Equivalent fracture strain at damage initiation.
Shear stress ratio.
Strain 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 constructor is HashinDamageInitiation, the table data specify the following:

Fiber tensile strength.
Fiber compressive strength.
Matrix tensile strength.
Matrix compressive strength.
Longitudinal shear strength.
Transverse shear strength.
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 DamageInitiation object.

Exceptions

RangeError.

FldDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].FldDamageInitiation

Prototype

odb_DamageInitiation&
FldDamageInitiation(const odb_SequenceSequenceDouble& table,
                    const odb_String& definition,
                    double feq,
                    double fnn,
                    double fnt,
                    int frequency,
                    double ks,
                    int numberImperfections,
                    bool temperatureDependency,
                    int dependencies,
                    double alpha,
                    double omega,
                    double tolerance,
                    const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

FlsdDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].FlsdDamageInitiation

Prototype

odb_DamageInitiation&
FlsdDamageInitiation(const odb_SequenceSequenceDouble& table,
                     const odb_String& definition,
                     double feq,
                     double fnn,
                     double fnt,
                     int frequency,
                     double ks,
                     int numberImperfections,
                     bool temperatureDependency,
                     int dependencies,
                     double alpha,
                     double omega,
                     double tolerance,
                     const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

JohnsonCookDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].JohnsonCookDamageInitiation

Prototype

odb_DamageInitiation&
JohnsonCookDamageInitiation(const odb_SequenceSequenceDouble& table,
                            const odb_String& definition,
                            double feq,
                            double fnn,
                            double fnt,
                            int frequency,
                            double ks,
                            int numberImperfections,
                            bool temperatureDependency,
                            int dependencies,
                            double alpha,
                            double omega,
                            double tolerance,
                            const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MaxeDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MaxeDamageInitiation

Prototype

odb_DamageInitiation&
MaxeDamageInitiation(const odb_SequenceSequenceDouble& table,
                     const odb_String& definition,
                     double feq,
                     double fnn,
                     double fnt,
                     int frequency,
                     double ks,
                     int numberImperfections,
                     bool temperatureDependency,
                     int dependencies,
                     double alpha,
                     double omega,
                     double tolerance,
                     const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MaxsDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MaxsDamageInitiation

Prototype

odb_DamageInitiation&
MaxsDamageInitiation(const odb_SequenceSequenceDouble& table,
                     const odb_String& definition,
                     double feq,
                     double fnn,
                     double fnt,
                     int frequency,
                     double ks,
                     int numberImperfections,
                     bool temperatureDependency,
                     int dependencies,
                     double alpha,
                     double omega,
                     double tolerance,
                     const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MkDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MkDamageInitiation

Prototype

odb_DamageInitiation&
MkDamageInitiation(const odb_SequenceSequenceDouble& table,
                   const odb_String& definition,
                   double feq,
                   double fnn,
                   double fnt,
                   int frequency,
                   double ks,
                   int numberImperfections,
                   bool temperatureDependency,
                   int dependencies,
                   double alpha,
                   double omega,
                   double tolerance,
                   const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MsfldDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MsfldDamageInitiation

Prototype

odb_DamageInitiation&
MsfldDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

QuadeDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].QuadeDamageInitiation

Prototype

odb_DamageInitiation&
QuadeDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

QuadsDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].QuadsDamageInitiation

Prototype

odb_DamageInitiation&
QuadsDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MaxpeDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MaxpeDamageInitiation

Prototype

odb_DamageInitiation&
MaxpeDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

MaxpsDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].MaxpsDamageInitiation

Prototype

odb_DamageInitiation&
MaxpsDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

ShearDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].ShearDamageInitiation

Prototype

odb_DamageInitiation&
ShearDamageInitiation(const odb_SequenceSequenceDouble& table,
                      const odb_String& definition,
                      double feq,
                      double fnn,
                      double fnt,
                      int frequency,
                      double ks,
                      int numberImperfections,
                      bool temperatureDependency,
                      int dependencies,
                      double alpha,
                      double omega,
                      double tolerance,
                      const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

HashinDamageInitiation(...)

This method creates a DamageInitiation object.

Path

materialApi.materials()[name].HashinDamageInitiation

Prototype

odb_DamageInitiation&
HashinDamageInitiation(const odb_SequenceSequenceDouble& table,
                       const odb_String& definition,
                       double feq,
                       double fnn,
                       double fnt,
                       int frequency,
                       double ks,
                       int numberImperfections,
                       bool temperatureDependency,
                       int dependencies,
                       double alpha,
                       double omega,
                       double tolerance,
                       const odb_String& direction);

Required arguments

table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.

Optional arguments

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".

Return value

A DamageInitiation object.

Exceptions

RangeError.

Members

The DamageInitiation object can have the following members:

Prototype

odb_String definition() const;
double feq() const;
double fnn() const;
double fnt() const;
int frequency() const;
double ks() const;
int numberImperfections() const;
bool temperatureDependency() const;
int dependencies() const;
double alpha() const;
double omega() const;
double tolerance() const;
odb_String direction() const;
odb_SequenceSequenceDouble table() const;
odb_DamageEvolution damageEvolution() const;
odb_DamageStabilization damageStabilization() const;
odb_DamageStabilizationCohesive damageStabilizationCohesive() const;

definition: An odb_String specifying the damage initiation definition. Possible values are "FLD" and "MSFLD". The default value is "MSFLD".
feq: A Double specifying the critical value of the deformation severity index for equivalent plastic strains. The default value is 10.0.
fnn: A Double specifying the critical value of the deformation severity index for strains normal to the groove direction. The default value is 10.0.
fnt: A Double specifying the critical value of the deformation severity index for shear strains. The default value is 10.0.
frequency: An Int specifying the frequency, in increments, at which the Marciniak-Kuczynski analysis is going to be performed. The default value is 1.
ks: A Double specifying the value of Ks. The default value is 0.0.
numberImperfections: An Int specifying the number of imperfections to be considered for the evaluation of the Marciniak-Kuczynski analysis. These imperfections are assumed to be equally spaced in the angular direction. The default value is 4.
temperatureDependency: A Boolean specifying whether the data depend on temperature. The default value is false.
dependencies: An Int specifying the number of field variable dependencies. The default value is 0.
alpha: A Double specifying the value of the coefficient that will multiply the shear contribution to the Hashin's fiber initiation criterion. The default value is 0.0.
omega: A Double specifying the factor used for filtering the ratio of principal strain rates used for the evaluation of the MSFLD damage initiation criterion. The default value is 1.0.
tolerance: A Double specifying the tolerance within which the damage initiation criterion must be satisfied. The default value is 0.05.
direction: An odb_String specifying the damage initiation direction. Possible values are "NMORI" and "TMORI". The default value is "NMORI".
table: An odb_SequenceSequenceDouble specifying the items described in the "Table data" section.
damageEvolution: A DamageEvolution object.
damageStabilization: A DamageStabilization object.
damageStabilizationCohesive: A DamageStabilizationCohesive object.

Corresponding analysis keywords

DAMAGE INITIATION