*****
Usage
*****

In order to enable remeshing in your simulation, a "BEGIN REMESHING" command block must be invoked.  This command block is placed within the Region scope of the Sierra/SM input file.  The available commands within the remeshing command block are displayed below:

.. parsed-literal::

   BEGIN REMESHING <string>remesh_name
     #
     # block set commands
     BLOCK = <string list>block_names
     ASSEMBLY = <string list>assembly_names
     INCLUDE ALL BLOCKS
     REMOVE BLOCK = <string list>block_names
     CRITERION IS ELEMENT VALUE OF <string>var_name <\|<=\|=\|>=\|> <real>tolerance
   END REMESHING


As an example, consider the below remeshing syntax:

.. parsed-literal::
		
   BEGIN REMESHING remesh1
     BLOCK = BLOCK_1
     CRITERION IS ELEMENT VALUE OF NORMALIZED_INRADIUS < 1.0e-1
   END REMESHING


If this syntax is provided, the code will examine all elements within BLOCK_1 to check if any elements have a value of NORMALIZED_INRADIUS < 1.0E-1.  If an element is found to meet that criterion, remeshing is performed.

.. admonition:: Remeshing subsets of the mesh is not currently supported.
   :class: admonition warning

   Although the element criteria is only evaluated over block_1, a new mesh can not currently be created for just block_1.  Therefore, the entire mesh will be examined and potentially modified if an element meets the remeshing criteria. This capability is currently being developed.

.. admonition:: In-Core Remeshing is currently only supported for Composite Tet10 Elements
   :class: admonition warning

   "************************************************************************************************************************************************"

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