ContactDamage.py

from abaqusConstants import *


class ContactDamage:
    """The ContactDamage object specifies damage options for a contact interaction property.

    Attributes
    ----------
    criterion: SymbolicConstant
        A SymbolicConstant specifying the type of data used to define the initiation of damage.
        Possible values are MAX_STRESS, MAX_SEPARATION, QUAD_TRACTION, and QUAD_SEPARATION. The
        default value is MAX_STRESS.
    initTempDep: Boolean
        A Boolean specifying whether the initiation data depend on temperature. The default
        value is OFF.
    initDependencies: int
        An Int specifying the number of initiation data field variables. The default value is 0.
    useEvolution: Boolean
        A Boolean specifying whether evolution data will be defined. The default value is OFF.
    evolutionType: SymbolicConstant
        A SymbolicConstant specifying the type of data used to define the evolution of damage.
        This argument is valid only when **useEvolution=ON**. Possible values are DISPLACEMENT and
        ENERGY. The default value is DISPLACEMENT.
    softening: SymbolicConstant
        A SymbolicConstant specifying the type of data used to define the evolution softening
        response. This argument is valid only when **useEvolution=ON**. The TABULAR value can be
        used only when **evolutionType=DISPLACEMENT**. Possible values are LINEAR, EXPONENTIAL,
        and TABULAR. The default value is LINEAR.
    useMixedMode: Boolean
        A Boolean specifying whether evolution data be defined using dependent behavior modes.
        This argument is valid only when **useEvolution=ON**. The default value is OFF.
    mixedModeType: SymbolicConstant
        A SymbolicConstant specifying the mode mix fracture criterion. This argument is valid
        only when **useEvolution=ON** and when **useMixedMode=ON**. The POWER_LAW and BK values can
        be used only when **evolutionType=ENERGY**. Possible values are TABULAR, POWER_LAW, and
        BK. The default value is TABULAR.
    modeMixRatio: SymbolicConstant
        A SymbolicConstant specifying the mode mix ratio type. This argument is valid only when
        **useEvolution=ON** and when **useMixedMode=ON**. The TRACTION value can be used only when
        **mixedModeType=TABULAR**. Possible values are ENERGY and TRACTION. The default value is
        ENERGY.
    exponent: float
        None or a Float specifying the exponent in the power-law or BK criterion that defines
        the variation of fracture energy with mode mix. This argument is valid only when
        **useEvolution=ON** and when **mixedModeType=POWER_LAW** or BK. The default value is None.
    evolTempDep: Boolean
        A Boolean specifying whether the evolution data depend on temperature. This argument is
        valid only when **useEvolution=ON**. The default value is OFF.
    evolDependencies: int
        An Int specifying the number of evolution data field variables. This argument is valid
        only when **useEvolution=ON**. The default value is 0.
    useStabilization: Boolean
        A Boolean specifying whether stabilization data will be defined. This argument is valid
        only when **useEvolution=ON**. The default value is OFF.
    viscosityCoef: float
        None or a Float specifying the viscosity coefficient. This argument is valid only when
        **useStabilization=ON**. The default value is None.
    initTable: float
        A tuple of tuples of Floats specifying the values defining the damage initiation. The
        items in the table data are described below.
    evolTable: float
        A tuple of tuples of Floats specifying the values defining the damage evolution. The
        items in the table data are described below. This argument is valid only when
        **useEvolution=ON**.

    Notes
    -----
    This object can be accessed by:

    .. code-block:: python

        import interaction
        mdb.models[name].interactionProperties[name].damage

        The table data for this object are:
        Table data for *initTable*:
        If *criterion*=MAX_STRESS or QUAD_TRACTION, the table data specify the following:
            - Maximum nominal stress in the normal-only mode.
            - Maximum nominal stress in the first shear direction (for a mode that involves separation only in this direction).
            - Maximum nominal stress in the second shear direction (for a mode that involves separation only in this 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 *criterion*=MAX_SEPARATION or QUAD_SEPARATION, the table data specify the following:
            - Separation at damage initiation in a normal-only mode.
            - Separation at damage initiation in a shear-only mode that involves separation only along the first shear
          direction.
            - Separation 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.
        Table data for *evolTable*:
        If *evolutionType*=DISPLACEMENT, *softening*=LINEAR, and *useMixedMode*=OFF, the table data specify the following:
            - Effective total or Plastic displacement at failure, measured from the time of 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 *evolutionType*=ENERGY, *softening*=LINEAR or EXPONENTIAL, and *useMixedMode*=OFF, the table data specify
        the following:
            - Fracture energy.
            - 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*=DISPLACEMENT, *softening*=LINEAR, *useMixedMode*=ON, *mixedModeType*=TABULAR, and
        *modeMixRatio*=ENERGY or TRACTION, the table data specify the following:
            - Total displacement at failure, measured from the time of damage initiation.
            - Appropriate mode mix ratio.
            - Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
            - 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, *softening*=LINEAR or EXPONENTIAL, *useMixedMode*=ON, *mixedModeType*=TABULAR, and
        *modeMixRatio*=ENERGY or TRACTION, the table data specify the following:
            - Fracture energy.
            - Appropriate mode mix ratio.
            - Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
            - 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*=DISPLACEMENT, *softening*=EXPONENTIAL, and *useMixedMode*=OFF, the table data specify the
        following:
            - Effective total or Plastic displacement at failure, measured from the time of damage initiation.
            - Exponential law 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.
        If *evolutionType*=DISPLACEMENT, *softening*=EXPONENTIAL, *useMixedMode*=ON, *mixedModeType*=TABULAR, and
        *modeMixRatio*=ENERGY or TRACTION, the table data specify the following:
            - Total displacement at failure, measured from the time of damage initiation.
            - Exponential law parameter.
            - Appropriate mode mix ratio.
            - Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
            - 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*=DISPLACEMENT, *softening*=TABULAR, and *useMixedMode*=OFF, the table data specify the following:
            - Damage variable.
            - Effective total or Plastic displacement at failure, measured from the time of 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 *evolutionType*=DISPLACEMENT, *softening*=TABULAR, *useMixedMode*=ON, *mixedModeType*=TABULAR, and
        *modeMixRatio*=ENERGY or TRACTION, the table data specify the following:
            - Damage variable.
            - Effective total displacement, measured from the time of damage initiation.
            - Appropriate mode mix ratio.
            - Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
            - 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, *softening*=LINEAR or EXPONENTIAL, *useMixedMode*=ON, *mixedModeType*=POWER_LAW or
        BK, and *modeMixRatio*=ENERGY, the table data specify the following:
            - Normal mode fracture energy.
            - Shear mode fracture energy for failure in the first shear direction.
            - Shear mode fracture energy for failure in 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.

    The corresponding analysis keywords are:

    - DAMAGE INITIATION
            - DAMAGE EVOLUTION
            - DAMAGE STABILIZATION

    """

    # A SymbolicConstant specifying the type of data used to define the initiation of damage.
    # Possible values are MAX_STRESS, MAX_SEPARATION, QUAD_TRACTION, and QUAD_SEPARATION. The
    # default value is MAX_STRESS.
    criterion: SymbolicConstant = MAX_STRESS

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

    # An Int specifying the number of initiation data field variables. The default value is 0.
    initDependencies: int = 0

    # A Boolean specifying whether evolution data will be defined. The default value is OFF.
    useEvolution: Boolean = OFF

    # A SymbolicConstant specifying the type of data used to define the evolution of damage.
    # This argument is valid only when *useEvolution*=ON. Possible values are DISPLACEMENT and
    # ENERGY. The default value is DISPLACEMENT.
    evolutionType: SymbolicConstant = DISPLACEMENT

    # A SymbolicConstant specifying the type of data used to define the evolution softening
    # response. This argument is valid only when *useEvolution*=ON. The TABULAR value can be
    # used only when *evolutionType*=DISPLACEMENT. Possible values are LINEAR, EXPONENTIAL,
    # and TABULAR. The default value is LINEAR.
    softening: SymbolicConstant = LINEAR

    # A Boolean specifying whether evolution data be defined using dependent behavior modes.
    # This argument is valid only when *useEvolution*=ON. The default value is OFF.
    useMixedMode: Boolean = OFF

    # A SymbolicConstant specifying the mode mix fracture criterion. This argument is valid
    # only when *useEvolution*=ON and when *useMixedMode*=ON. The POWER_LAW and BK values can
    # be used only when *evolutionType*=ENERGY. Possible values are TABULAR, POWER_LAW, and
    # BK. The default value is TABULAR.
    mixedModeType: SymbolicConstant = TABULAR

    # A SymbolicConstant specifying the mode mix ratio type. This argument is valid only when
    # *useEvolution*=ON and when *useMixedMode*=ON. The TRACTION value can be used only when
    # *mixedModeType*=TABULAR. Possible values are ENERGY and TRACTION. The default value is
    # ENERGY.
    modeMixRatio: SymbolicConstant = ENERGY

    # None or a Float specifying the exponent in the power-law or BK criterion that defines
    # the variation of fracture energy with mode mix. This argument is valid only when
    # *useEvolution*=ON and when *mixedModeType*=POWER_LAW or BK. The default value is None.
    exponent: float = None

    # A Boolean specifying whether the evolution data depend on temperature. This argument is
    # valid only when *useEvolution*=ON. The default value is OFF.
    evolTempDep: Boolean = OFF

    # An Int specifying the number of evolution data field variables. This argument is valid
    # only when *useEvolution*=ON. The default value is 0.
    evolDependencies: int = 0

    # A Boolean specifying whether stabilization data will be defined. This argument is valid
    # only when *useEvolution*=ON. The default value is OFF.
    useStabilization: Boolean = OFF

    # None or a Float specifying the viscosity coefficient. This argument is valid only when
    # *useStabilization*=ON. The default value is None.
    viscosityCoef: float = None

    # A tuple of tuples of Floats specifying the values defining the damage initiation. The
    # items in the table data are described below.
    initTable: float = None

    # A tuple of tuples of Floats specifying the values defining the damage evolution. The
    # items in the table data are described below. This argument is valid only when
    # *useEvolution*=ON.
    evolTable: float = None

    def __init__(
        self,
        initTable: tuple,
        criterion: SymbolicConstant = MAX_STRESS,
        initTempDep: Boolean = OFF,
        initDependencies: int = 0,
        useEvolution: Boolean = OFF,
        evolutionType: SymbolicConstant = DISPLACEMENT,
        softening: SymbolicConstant = LINEAR,
        useMixedMode: Boolean = OFF,
        mixedModeType: SymbolicConstant = TABULAR,
        modeMixRatio: SymbolicConstant = ENERGY,
        exponent: float = None,
        evolTempDep: Boolean = OFF,
        evolDependencies: int = 0,
        evolTable: tuple = (),
        useStabilization: Boolean = OFF,
        viscosityCoef: float = None,
    ):
        """This method creates a ContactDamage object.

        Notes
        -----
        This function can be accessed by:

        .. code-block:: python

            mdb.models[name].interactionProperties[name].Damage

        Parameters
        ----------
        initTable
            A sequence of sequences of Floats specifying the values defining the damage initiation.
            The items in the table data are described below.
        criterion
            A SymbolicConstant specifying the type of data used to define the initiation of damage.
            Possible values are MAX_STRESS, MAX_SEPARATION, QUAD_TRACTION, and QUAD_SEPARATION. The
            default value is MAX_STRESS.
        initTempDep
            A Boolean specifying whether the initiation data depend on temperature. The default
            value is OFF.
        initDependencies
            An Int specifying the number of initiation data field variables. The default value is 0.
        useEvolution
            A Boolean specifying whether evolution data will be defined. The default value is OFF.
        evolutionType
            A SymbolicConstant specifying the type of data used to define the evolution of damage.
            This argument is valid only when *useEvolution*=ON. Possible values are DISPLACEMENT and
            ENERGY. The default value is DISPLACEMENT.
        softening
            A SymbolicConstant specifying the type of data used to define the evolution softening
            response. This argument is valid only when *useEvolution*=ON. The TABULAR value can be
            used only when *evolutionType*=DISPLACEMENT. Possible values are LINEAR, EXPONENTIAL,
            and TABULAR. The default value is LINEAR.
        useMixedMode
            A Boolean specifying whether evolution data be defined using dependent behavior modes.
            This argument is valid only when *useEvolution*=ON. The default value is OFF.
        mixedModeType
            A SymbolicConstant specifying the mode mix fracture criterion. This argument is valid
            only when *useEvolution*=ON and when *useMixedMode*=ON. The POWER_LAW and BK values can
            be used only when *evolutionType*=ENERGY. Possible values are TABULAR, POWER_LAW, and
            BK. The default value is TABULAR.
        modeMixRatio
            A SymbolicConstant specifying the mode mix ratio type. This argument is valid only when
            *useEvolution*=ON and when *useMixedMode*=ON. The TRACTION value can be used only when
            *mixedModeType*=TABULAR. Possible values are ENERGY and TRACTION. The default value is
            ENERGY.
        exponent
            None or a Float specifying the exponent in the power-law or BK criterion that defines
            the variation of fracture energy with mode mix. This argument is valid only when
            *useEvolution*=ON and when *mixedModeType*=POWER_LAW or BK. The default value is None.
        evolTempDep
            A Boolean specifying whether the evolution data depend on temperature. This argument is
            valid only when *useEvolution*=ON. The default value is OFF.
        evolDependencies
            An Int specifying the number of evolution data field variables. This argument is valid
            only when *useEvolution*=ON. The default value is 0.
        evolTable
            A sequence of sequences of Floats specifying the values defining the damage evolution.
            The items in the table data are described below. This argument is valid only when
            *useEvolution*=ON.
        useStabilization
            A Boolean specifying whether stabilization data will be defined. This argument is valid
            only when *useEvolution*=ON. The default value is OFF.
        viscosityCoef
            None or a Float specifying the viscosity coefficient. This argument is valid only when
            *useStabilization*=ON. The default value is None.

        Returns
        -------
            A ContactDamage object.
        """
        pass

    def setValues(self):
        """This method modifies the ContactDamage object."""
        pass