.. _Chap:InputsAscent:

Ascent
======


`Ascent <https://ascent.readthedocs.io>`_ has been integrated into MFIX-Exa for *in situ* visualization.
MFIX-Exa must be built with Ascent support to use this feature.

The following inputs must be preceded by the prefix ``mfix`` and control frequency of the Ascent pipeline.


+----------------------+-----------------------------------------------------------------------+-------------+-----------+
|                      | Description                                                           |   Type      | Default   |
+======================+=======================================================================+=============+===========+
| ascent_int           | Frequency of ascent pipeline;                                         |    Int      | -1        |
|                      | if -1 then ascent will not be called.                                 |             |           |
+----------------------+-----------------------------------------------------------------------+-------------+-----------+
| ascent_per_approx    | Time period of the ascent pipeline (approximate);                     |    Real     | -1        |
|                      | if -1 then ascent will not be called.                                 |             |           |
+----------------------+-----------------------------------------------------------------------+-------------+-----------+


The following input must be preceded by the prefix ``ascent``,
and specifies the Ascent actions for fluid and/or particles. The frequency which these are called
is controlled by ``ascent_int`` or ``ascent_per_approx``, see above. Note that if an Ascent pipeline
is being included in a GPU build/run, then you must enable managed memory,i.e., set
``amrex.the_arena_is_managed = true``.


+---------------------+-----------------------------------------------------------------------+-------------+-----------+
|                     | Description                                                           |   Type      | Default   |
+=====================+=======================================================================+=============+===========+
| actions             | yaml file of the ascent actions (ex. ascent_actions.yaml). If no file |  String     |           |
|                     | name is provided, then calls to Ascent are skipped.                   |             |           |
+---------------------+-----------------------------------------------------------------------+-------------+-----------+