Commit 58901967 authored by Jordan Musser's avatar Jordan Musser
Browse files

Level set measured to the refined EB geometry (!247)

parent e67f8174
Loading
Loading
Loading
Loading
+8 −8
Changes for docs/source_docs/references/eb/EBWalls.rst: 8 added lines, 8 removed lines.
Original line number Diff line number Diff line
@@ -24,15 +24,15 @@ the level-set creation:
+-------------------------------+------------------------------------------------+
|  Parameter                    |  Description                                   |
+===============================+================================================+
| ``amr.max_level``             | If greater than 0, MFIX-Exa operates in        |
|                               | multi-level mode. The level-set grids follow   |
|                               | all other grids. If equal to 1, the level-set  |
|                               | has two levels (one additional level with      |
|                               | higher refinement).                            |
| ``amr.max_level``             | If greater than 0, the fluid operates in       |
|                               | multi-level mode. Particles and their          |
|                               | level-set stay on level 0.                     |
+-------------------------------+------------------------------------------------+
| ``mfix.levelset_refinement``  | If ``amr.max_level > 1`` this parameter is     |
|                               | ignored. Otherwise it sets the maximum         |
|                               | refinement of the level-set                    |
| ``mfix.levelset_refinement``  | Refinement of the particle level-set grid      |
|                               | relative to level 0 (a power of 2). The        |
|                               | level-set is the distance to the walls cut on  |
|                               | this grid, and with particles the fluid EB     |
|                               | levels are coarsened from the same cut.        |
+-------------------------------+------------------------------------------------+

EB Specification
+0 −4
Changes for docs/source_docs/tools/pic2dem.rst: 0 added lines, 4 removed lines.
Original line number Diff line number Diff line
@@ -46,10 +46,6 @@ The following inputs must be preceded by "pic2dem.":
| geom_chk_file          | Name of the EB checkpoint file where the DEM      | string | ""      |
|                        | refined case geometry will be read or written     |        |         |
+------------------------+---------------------------------------------------+--------+---------+
| geom_levelset_chk_file | Name of the EB checkpoint file where the levelset | string | ""      |
|                        | geometry for the DEM refined case will be read or |        |         |
|                        | written                                           |        |         |
+------------------------+---------------------------------------------------+--------+---------+
| geom_chk_write         | Enable writing the EB geometry                    | bool   | false   |
|                        | checkpoint file for the DEM refined case          |        |         |
+------------------------+---------------------------------------------------+--------+---------+
+10 −3
Changes for docs/source_docs/user_guide/inputs/geometry.rst: 10 added lines, 3 removed lines.
Original line number Diff line number Diff line
@@ -366,8 +366,15 @@ Levelset refinement
-------------------

For particle-wall interactions, the geometry is represented using a levelset function, and the grid storing this
levelset can be refined to capture geometric details more accurately. This refinement affects only particle-wall
interactions and does not alter the geometry representation used for solving the fluid equations.
levelset can be refined to capture geometric details more accurately. The levelset is the distance to the walls of
the geometry cut on the refined grid, so walls, corners and curved surfaces that the level-0 grid cannot resolve are
resolved by the levelset grid.

When DEM or PIC particles are solved, the embedded boundary is cut once, on the finer of the finest AMR level and the
refined levelset grid, and every fluid level is coarsened from it. The fluid volume fractions then hold the volume the
particles can reach, so that particles and fluid see the same walls. With particles, ``levelset_refinement`` greater
than 1 therefore also changes the fluid volume fractions (slightly) from a geometry cut directly on level 0. Without
particles, the levelset is not used and this input has no effect.

The following inputs are defined using the prefix ``mfix``:

@@ -375,7 +382,7 @@ The following inputs are defined using the prefix ``mfix``:
|                        | Description                                                                   |   Type   | Default             |
+========================+===============================================================================+==========+=====================+
| levelset_refinement    | Refinement factor of levelset resolution relative to level 0                  |   Int    | 1                   |
|                        | resolution                                                                    |          |                     |
|                        | resolution. Must be a power of 2.                                             |          |                     |
+------------------------+-------------------------------------------------------------------------------+----------+---------------------+

Embedded boundary
+1 −2
Changes for docs/source_docs/user_guide/inputs/initialization.rst: 1 added line, 2 removed lines.
Original line number Diff line number Diff line
@@ -31,6 +31,5 @@ The following inputs are defined using the prefix ``mfix``.
|                      | Description                                                           |   Type      | Default      |
+======================+=======================================================================+=============+==============+
| geom_chk_read        | Flag to read the EB geometry data from the ``geom_chk_file``          |  Bool       |  false       |
|                      | :ref:`checkpoint file<Chap:InputsCheckpoint>`. If levelset refinement |             |              |
|                      | is enabled, levelset data is read from ``geom_levelset_chk_file``.    |             |              |
|                      | :ref:`checkpoint file<Chap:InputsCheckpoint>`.                        |             |              |
+----------------------+-----------------------------------------------------------------------+-------------+--------------+
+5 −8
Changes for docs/source_docs/user_guide/inputs/output/checkpointing.rst: 5 added lines, 8 removed lines.
Original line number Diff line number Diff line
@@ -19,15 +19,12 @@ The following inputs must be preceded by the prefix ``mfix`` and control checkpo
|                         | of ``check_int``, ``check_per_approx``, or ``check_walltime_interval`` |             |                  |
|                         | may be specified.                                                      |             |                  |
+-------------------------+------------------------------------------------------------------------+-------------+------------------+
| geom_chk_write          | Write the EB geometry data into ``geom_chk_file`` and additionally,    |  Bool       | false            |
|                         | ``geom_levelset_chk_file`` if levelset refinement is enabled.          |             |                  |
| geom_chk_write          | Write the EB geometry data into ``geom_chk_file``.                     |  Bool       | false            |
+-------------------------+------------------------------------------------------------------------+-------------+------------------+
| geom_chk_file           | Name of the EB checkpoint file that is used to store or read           |  String     | geom_chk         |
|                         | the unrefined geometry.                                                |             |                  |
+-------------------------+------------------------------------------------------------------------+-------------+------------------+
| geom_levelset_chk_file  | Name of the EB checkpoint file that is used to store or read           |  String     | geom_levelset_chk|
|                         | the refined geometry, i.e. when levelset refinement is enabled.        |             |                  |
|                         |                                                                        |             |                  |
| geom_chk_file           | Name of the EB checkpoint file that is used to store or read the       |  String     | geom_chk         |
|                         | geometry. It holds the finest EB level (the finest AMR level, or the   |             |                  |
|                         | refined levelset grid if that is finer); the coarser levels are        |             |                  |
|                         | rebuilt from it.                                                       |             |                  |
+-------------------------+------------------------------------------------------------------------+-------------+------------------+