Mazars Damage

Mazars scalar damage model

Description

The MazarsDamage model is an implementation of the isotropic damage model for concrete described in Mazars (1984) and Pijaudier-Cabot and Mazars (2001). It is based on the theory of elasticity coupled with the isotropic damage. It describes the elastic stiffness degradation and the softening behavior of concrete under both uniaxial tension and uniaxial compression using an isotropic scalar damage variable . The damage depends only on the effective stresses applied to an undamaged area.

The evolution of the damage is determined by an equivalent strain that quantifies the amount of the local extension state during the mechanical loading. It is calculated from the positive eigenvalues of the strain tensor as follows: where are the components of principal strain and is the Macualay bracket, defined as

The damage loading function is: where is the parameter defining the threshold of damage growth. Initially, is equal to , where is the tensile strength and is the initial Young's modulus of the material. During subsequent steps, it takes on the maximum value of the equivalent strain during the entire load history:

To account for the differing behavior of the concrete in tension and in compression, the scalar damage is expressed as a combination of two damage modes: where and are dimensionless coefficients and represent the contribution of each loading mode such that and under uniaxial tension, and and under uniaxial compression. These coefficients are defined as functions of the principal components of the strain tensors and that result from the tensile and compressive components of the stress tensor, respectively, defined as: and are then computed as: The exponent in these equations is a parameter that can be tuned to fit experimental data for shear response, and is recommended initially to be set to 1. The current implementation of the model has this parameter hard-coded to 1, and it cannot be set by the user.

The scalar damage variables and for tension and compression, respectively, are computed as: where , , , and are material parameters that control the shape of the nonlinear response and are determined using compression and tension tests.

Implementation and Usage

Damage models such as this do not directly compute the stress, but are used in conjunction with a stress calculator to modify the stress computation that takes other phenomena into account as well. The damage models derive from a common base class that defines functionality that a damage model must supply. The ComputeDamageStress model is a stress calculating model that computes the behavior of materials that only exhibit damaged isotropic elastic behavior. The example below shows how the damage and stress models are used in conjunction with each other.

Example Input Syntax

[Materials<<<{"href": "../../syntax/Materials/index.html"}>>>]
  [damage]
    type = MazarsDamage<<<{"description": "Mazars scalar damage model", "href": "MazarsDamage.html"}>>>
    tensile_strength<<<{"description": "Tensile stress threshold for damage initiation"}>>> = 1e6
    a_t<<<{"description": "A_t parameter that controls the shape of the response in tension"}>>> = 0.87
    a_c<<<{"description": "A_c parameter that controls the shape of the response in compression"}>>> = 0.65
    b_t<<<{"description": "B_t parameter that controls the shape of the response in tension"}>>> = 20000
    b_c<<<{"description": "B_c parameter that controls the shape of the response in compression"}>>> = 2150
  []
[]
(blackbear/test/tests/mazars_damage/mazars.i)

MazarsDamage is run in conjunction with a stress calculator that supports the use of a damage model, (ComputeDamageStress in this case), as shown:

[Materials<<<{"href": "../../syntax/Materials/index.html"}>>>]
  [stress]
    type = ComputeDamageStress<<<{"description": "Compute stress for damaged elastic materials in conjunction with a damage model.", "href": "ComputeDamageStress.html"}>>>
    damage_model<<<{"description": "Name of the damage model"}>>> = damage
  []
[]
(blackbear/test/tests/mazars_damage/mazars.i)

Input Parameters

  • a_cA_c parameter that controls the shape of the response in compression

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:A_c parameter that controls the shape of the response in compression

  • a_tA_t parameter that controls the shape of the response in tension

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:A_t parameter that controls the shape of the response in tension

  • b_cB_c parameter that controls the shape of the response in compression

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:B_c parameter that controls the shape of the response in compression

  • b_tB_t parameter that controls the shape of the response in tension

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:B_t parameter that controls the shape of the response in tension

  • tensile_strengthTensile stress threshold for damage initiation

    C++ Type:std::vector<VariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:Tensile stress threshold for damage initiation

Required Parameters

  • base_nameOptional parameter that allows the user to define multiple mechanics material systems on the same block, i.e. for multiple phases

    C++ Type:std::string

    Controllable:No

    Description:Optional parameter that allows the user to define multiple mechanics material systems on the same block, i.e. for multiple phases

  • blockThe list of blocks (ids or names) that this object will be applied

    C++ Type:std::vector<SubdomainName>

    Controllable:No

    Description:The list of blocks (ids or names) that this object will be applied

  • boundaryThe list of boundaries (ids or names) from the mesh where this object applies

    C++ Type:std::vector<BoundaryName>

    Controllable:No

    Description:The list of boundaries (ids or names) from the mesh where this object applies

  • constant_onNONEWhen ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped

    Default:NONE

    C++ Type:MooseEnum

    Options:NONE, ELEMENT, SUBDOMAIN

    Controllable:No

    Description:When ELEMENT, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps.When SUBDOMAIN, MOOSE will only call computeQpProperties() for the 0th quadrature point, and then copy that value to the other qps. Evaluations on element qps will be skipped

  • damage_index_namedamage_indexname of the material property where the damage index is stored

    Default:damage_index

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:name of the material property where the damage index is stored

  • declare_suffixAn optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:An optional suffix parameter that can be appended to any declared properties. The suffix will be prepended with a '_' character.

  • maximum_damage1Maximum value allowed for damage index

    Default:1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Maximum value allowed for damage index

  • maximum_damage_increment0.1maximum damage increment allowed for simulations with adaptive time step

    Default:0.1

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:maximum damage increment allowed for simulations with adaptive time step

  • residual_stiffness_fraction1e-08Minimum fraction of original material stiffness retained for fully damaged material (when damage_index=1)

    Default:1e-08

    C++ Type:double

    Unit:(no unit assumed)

    Controllable:No

    Description:Minimum fraction of original material stiffness retained for fully damaged material (when damage_index=1)

  • use_old_damageFalseWhether to use the damage index from the previous step in the stress computation

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether to use the damage index from the previous step in the stress computation

Optional Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Controllable:Yes

    Description:Set the enabled status of the MooseObject.

  • implicitTrueDetermines whether this object is calculated using an implicit or explicit form

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Determines whether this object is calculated using an implicit or explicit form

  • seed0The seed for the master random number generator

    Default:0

    C++ Type:unsigned int

    Controllable:No

    Description:The seed for the master random number generator

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

  • output_propertiesList of material properties, from this material, to output (outputs must also be defined to an output type)

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:List of material properties, from this material, to output (outputs must also be defined to an output type)

  • outputsnone Vector of output names where you would like to restrict the output of variables(s) associated with this object

    Default:none

    C++ Type:std::vector<OutputName>

    Controllable:No

    Description:Vector of output names where you would like to restrict the output of variables(s) associated with this object

Outputs Parameters

  • prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

  • use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

Material Property Retrieval Parameters

References

  1. Jacky Mazars. Application de la mécanique de l'endommagement au comportement non linéaire et à la rupture du béton de structure. PhD thesis, Université Paris 6, France, 1984.[BibTeX]
  2. Gilles Pijaudier-Cabot and Jacky Mazars. Damage models for concrete. In Jean Lemaitre, editor, Handbook of Materials Behavior Models. Academic Press, 2001.[BibTeX]