.. _Chap:InputsPlotfiles: Plotfiles and other output ========================== The following inputs must be preceded by the prefix ``mfix`` and control frequency and naming of plotfile generation. +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +======================+=======================================================================+=============+===========+ | plot_file | Prefix to use for plotfile output. | String | plt | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | file_digits | Number of digits to use in plotfile (plt[0-9]+) and checkpoint | Int | 5 | | | (chk[0-9]+) filenames. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | plot_int | Plotting interval in timesteps (0 to disable). | Int | 0 | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | plot_per_approx | Approximate plotting interval in simulation time (does not modify dt).| Real | 0 | | | 0 to disable. Only one of ``plot_int`` or ``plot_per_approx`` may be | | | | | specified. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | plot_on_restart | Write a plotfile when restarting (only used if ``plot_int``>0). | Bool | false | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ The following inputs must be preceded by the prefix ``mfix`` and control which variables will be written in plotfiles. +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +=====================+=======================================================================+=============+===========+ | plt_regtest | Plot all variables (overrides all other plot flags). | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_drag_p | Plot particle drag force. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_ep_g | Plot fluid volume fraction. | Int | 1 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_gradp_g | Plot fluid pressure gradient. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_mu_g | Plot fluid molecular viscosity. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_omega_p | Plot particle angular velocity. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_p_g | Plot fluid pressure. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_phase | Plot particle type. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_radius | Plot particle radius. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_ro_g | Plot fluid density. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_ro_p | Plot particle density. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_statwt | Plot particle (parcel) statistical weight. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_T_g | Plot fluid temperature. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_T_p | Plot particle temperature. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_vel_g | Plot fluid velocity data. | Int | 1 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_vel_p | Plot particle velocity. | Int | 1 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_volfrac | Plot Eulerian grid volume fraction (from cut cells). | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ | plt_vort | Plot fluid vorticity. | Int | 0 | +---------------------+-----------------------------------------------------------------------+-------------+-----------+ The following inputs must be preceded by the prefix ``mfix.solids`` and allow to write additional plotfiles which contain only solids variables in specific regions at fixed timesteps or approximated simulation times. +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +================================+=================================================================+=============+===========+ | regions | Regions used when generating plotfiles. The only supported | Strings | None | | | region shape for plotfile output is ``box``. | | | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name] | Specify which solids phases will be plotted. | Strings | | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plot_int | Plotting interval in timesteps (0 to disable). | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plot_per_approx | Approximate plotting interval in simulation time (does not | Real | 0 | | | modify dt). 0 to disable. Only one of ``plot_int`` or | | | | | ``plot_per_approx`` may be specified. | | | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_regtest | Plot all variables (overrides all other plot flags). | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_cp_s | Plot particle specific heat coefficient. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_drag_p | Plot particle drag force. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_h_s_txfr | Plot particle interphase enthalpy transfer. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_mass | Plot particle mass. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_mass_sn_txfr | Plot particle interphase mass transfer. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_omega_p | Plot particle angular velocity. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_omoi | Plot particle inverse momentum of inertia. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_phase | Plot particle phase. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_radius | Plot particle radius. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_ro_p | Plot particle density. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_statwt | Plot particle statistical weight. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_T_p | Plot particle temperature. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_vel_p | Plot particle velocity. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_vel_s_txfr | Plot particle interphase velocity transfer. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_volume | Plot particle volume. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ | [region_name].plt_X_s | Plot particle species mass fractions. | Int | 0 | +--------------------------------+-----------------------------------------------------------------+-------------+-----------+ Files will be saved to a directory ``[region_name]`` using the ``plot_file`` prefix, e.g. ``region1/plt00000`` Below is an example for specifying the inputs to plot solids data in a given region. .. code-block:: none mfix.solids.regions = my_region mfix.solids.my_region.plot_int = 10 mfix.solids.my_region.plt_vel_p = 1 Debugging ========= The following inputs control whether particle data should be written out in ASCII format. They must be preceded by the prefix ``mfix``. +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +======================+=======================================================================+=============+===========+ | par_ascii_file | Prefix to use for ASCII particle output file name. | String | par | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | par_ascii_int | ASCII particle output interval in timesteps. 0 to disable. | Int | 0 | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | par_ascii_per_approx | Approximate simulation time period for ASCII particle output. 0 to | Real | 0 | | | disable. Only one of ``par_ascii_int`` or ``par_ascii_per_approx`` | | | | | may be specified. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ The following inputs control whether the EB geometry or level set should be written. They must be preceded by the prefix ``mfix``. +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | | Description | Type | Default | +======================+=======================================================================+=============+===========+ | write_ls | Write a plotfile containing the level set and volume fraction. | Bool | false | | | If enabled, it will only be written once, after initialization or | | | | | restart. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | write_eb_surface | Write the EB geometry in VTP format. | Bool | false | | | If enabled, it will only be written once, after initialization or | | | | | restart. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ | write_geom | Write a plotfile containing the EB geometry data. | Bool | false | | | If true, it will only be written once, after initialization or | | | | | restart. | | | +----------------------+-----------------------------------------------------------------------+-------------+-----------+ `Ascent` has been integrated into MFIX-Exa for *in situ* visualization. See :ref:`Ascent` for details.