.. _output-global:

*********************
Global Output Options
*********************

These commands exist at the region scope to control the output of default global variables:

.. code-block:: sierrainput

   GLOBAL ENERGY REPORTING = EXACT|APPROXIMATE|OFF (EXACT
   EXTENSIVE GLOBAL VARS   {PROBLEMSIZE|CORESOLVER|MLSOLVER|CONTACT|
                            ALMATERIAL|CONSTRAINTMESH|ENERGYBALANCE|
                            NODAL|ELEMENT|ALL}
                            [IN <output_name: string>]
   EXTENSIVE RIGID BODY VARS OUTPUT = OFF|HISTORY|RESULTS|ALL|
                                      DEFAULT(DEFAULT)

Through the ``GLOBAL ENERGY REPORTING`` command line Sierra/SM offers three reporting options for global energy variables:  ``EXACT``, ``APPROXIMATE``, and ``OFF``. The ``EXACT`` and ``APPROXIMATE`` reporting options use different algorithms for tracking the global values of external energy, internal energy, contact energy, and hourglass energy. In many cases, the ``APPROXIMATE`` reporting option will provide a modest performance improvement with a negligible effect on the reported energy values. The ``OFF`` option will result in a further performance improvement and will report all energy values as zero.

The ``GLOBAL ENERGY REPORTING`` command has no effect on the analysis itself; the energy values calculated are used only for reporting purposes.

The command ``EXTENSIVE GLOBAL VARS`` requests that a set of global variables (dictated by the choice of the option) be written to the output file(s). An output results file may optionally be specified to which to write the variables; otherwise they will be written to all output files. Note, by default energy and momentum variables are written to all output files. Regardless of the option set here any global variable may be requested specifically by name in an output block.

The line command ``EXTENSIVE RIGID BODY VARS OUTPUT`` controls the default output set for global rigid body variables. Regardless of the option choice here, global rigid body variables may be output by name in the history or results output blocks. See Table :numref:`tab-output-variables-rb_globvars` for a list of available variables. The ``EXTENSIVE RIGID BODY VARS OUTPUT`` options are:  ``OFF`` to specify no default rigid body global variable output; ``HISTORY`` to specify default rigid body global variable output to the history file(s) only; ``RESULTS`` to specify default rigid body global variable output to the results file(s) only; ``ALL`` to specify default rigid body global variable output to both the history and results files. This option defaults to ``DEFAULT`` by default if the analysis contains less than ten rigid bodies then the rigid body variables will be written to results and history. If the analysis has more than ten rigid bodies then no rigid body global variable will be output by default. For an analysis with several rigid bodies it may a significant file size and performance benefit to not output the rigid body variables due to the large number of such variables.
