From 7b9d83538d057dc279a311bffb158d63e130f8ed Mon Sep 17 00:00:00 2001
From: William Fullmer <william.fullmer@netl.doe.gov>
Date: Mon, 5 Apr 2021 16:55:00 -0400
Subject: [PATCH] add InputsDiscretization
---
docs/source/Inputs_Chapter.rst | 1 +
docs/source/inputs/InputsDiscretization.rst | 27 +++++++++++++++++++++
2 files changed, 28 insertions(+)
create mode 100644 docs/source/inputs/InputsDiscretization.rst
diff --git a/docs/source/Inputs_Chapter.rst b/docs/source/Inputs_Chapter.rst
index 1b6b11e..46a7554 100644
--- a/docs/source/Inputs_Chapter.rst
+++ b/docs/source/Inputs_Chapter.rst
@@ -41,6 +41,7 @@ keywords such as ``mfix``, ``amr``, ``geometry``, ``nodal_proj`` etc.
inputs/InputsProblemDefinition
inputs/InputsCoupling
inputs/InputsTimeStepping
+ inputs/InputsDiscretization
inputs/InputsInitialization
inputs/InputsLoadBalancing
inputs/InputsMultigrid
diff --git a/docs/source/inputs/InputsDiscretization.rst b/docs/source/inputs/InputsDiscretization.rst
new file mode 100644
index 0000000..04e62bd
--- /dev/null
+++ b/docs/source/inputs/InputsDiscretization.rst
@@ -0,0 +1,27 @@
+.. sec:InputsDiscretization:
+
+Discretization
+==============
+
++---------------------------+-----------------------------------------------------------------------+-------------+--------------+
+| Key | Description | Type | Default |
++===========================+=======================================================================+=============+==============+
+| use_drag_coeff_in_proj_gp | Algebraically consistent p coeff in proj or (default) simplified form | Bool | False |
++---------------------------+-----------------------------------------------------------------------+-------------+--------------+
+| advection_type | Predictor-Corrector Method of Lines ("mol") or Godunov ("godunov") | String | mol |
++---------------------------+-----------------------------------------------------------------------+-------------+--------------+
+| use_drag_in_godunov | Include a drag term in the Godunov flux or (default) not | Bool | False |
++---------------------------+-----------------------------------------------------------------------+-------------+--------------+
+| redistribution_type | Use flux ("FluxRedist"), state ("StateRedist") or no ("NoRedist") | | |
+| | redistribution | String | FluxRedist |
++---------------------------+-----------------------------------------------------------------------+-------------+--------------+
+
+Notes: The code was originally developed with MOL and FluxRedist. Preliminary
+tests show that the new single-step Godunov method is roughly twice as fast as
+the predictor-corrector MOL at the same time step (e.g., CFL limited to 0.5).
+Further, the Godunov method allows for roughly twice the time step, CFL should
+be limited to 0.9 for stability. Finally, it is recommended that the Godunov
+method be used in conjunction with StateRedist. While not fully vetted, early
+tests also show increased stability in complex geometries for a StateRedist-
+Godunov scheme compared to the previous FluxRedist-MOL scheme.
+
--
GitLab