.. _failure:

***************
Modular Failure
***************

The modular failure capability consists of a suite of failure models (Tearing Parameter, Johnson-Cook Failure, Wilkins, Modular Failure, Modular BCJ Failure) that are available to several of modular material models. These failure models are briefly defined in this chapter, but other references (e.g. [:footcite:`Corona2013`, :footcite:`mat:ref:lester:2019`, :footcite:`mat:ref:lester:2020`]) provide a more complete description. Modular failure is currently available to the following material models: J\ :sub:`2` plasticity, Hosford plasticity, Hill plasticity, and Barlat plasticity. 
 
Additionally, an anisotropic failure capability has been implemented (:numref:`failure-anisotropic`). This is compatible with the modular failure models listed here, plus several additional models in development.

.. {\color{red} Question for Brian -- should we include JCdamagesoftening, TPdamagesoftening, softeningBCJfailure, BCJparameterfailure, Wilkinsparameter?} 

.. Don't put "User Guide" here it messes up the sectioning

.. code-block:: sierrainput

   #
   # Optional Failure Definitions
   #    Following only need to be defined if intend to use failure model
   #
   FAILURE MODEL = TEARING_PARAMETER | JOHNSON_COOK_FAILURE | WILKINS
                   | MODULAR_FAILURE | MODULAR_BCJ_FAILURE

   CRITICAL FAILURE PARAMETER = <real>

.. toctree::
   :hidden:
   :maxdepth: 1

   failure/tearing
   failure/jc
   failure/wilkins
   failure/modular
   failure/bcj
   failure/anisotropic

.. raw::
   html

   <hr>

.. footbibliography::
