.. ############################################################################
.. manual/packages/vertex-cfd/nonlinear_solve_printing.rst
.. ############################################################################

.. _sec_nonlinear_solve_printing:

********************
NOX Printing
********************

The ``Printing`` sublist controls the precision, processor, and diagnostic categories used by NOX output.

.. dropdown:: <Printing>
   :icon: multi-select
   :color: primary
   :animate: fade-in-slide-down

   .. py:data:: Output Precision

      :type: integer
      :value: Integer
      :usage: Optional
      :default: ``3``
      :description: Sets the number of digits used by NOX diagnostic output.

   .. py:data:: Output Processor

      :type: integer
      :value: MPI rank
      :usage: Optional
      :default: ``0``
      :description: Selects the MPI rank that writes NOX diagnostic output.

   .. dropdown:: Output Information
      :icon: bookmark
      :color: light
      :animate: fade-in-slide-down

      Each entry is an optional boolean that enables the matching
      NOX output category. Tempus enables ``Error``, ``Warning``,
      ``Linear Solver Details``, ``Stepper Iteration``, ``Stepper
      Details``, and ``Stepper Parameters`` by default; it disables
      ``Outer Iteration``, ``Parameters``, and ``Details``. The
      searched Vertex-CFD inputs override these settings to enable
      only ``Error`` and ``Warning``.

Example
-------

.. literalinclude:: ../../../../examples/inputs/simple_box_2d.xml
   :language: xml
   :linenos:
   :start-at: <ParameterList name="Printing">
   :end-at: </ParameterList> <!-- Printing -->
   :emphasize-lines: 2-14
   :caption: NOX output configured to print only errors and warnings.