added subphase analysis

This commit is contained in:
James McClure 2021-07-24 10:52:18 -04:00
parent fc2c98467d
commit 51a9c359b9

View File

@ -0,0 +1,52 @@
======================================
Color model -- Subphase Analysis
======================================
The subphase analysis routine for the LBPM color model logs a time series
of averaged information to the space-delimited CSV file ``subphase.csv``.
The ``subphase_analysis_interval`` key should be specified to control the interval at
to perform basic analysis, which corresponds to the number of simulation timesteps
to perform between analyses. The subphase analys routine performs the following functions
* analyzes the connectivity of fluid phases using a connected components algorithm
* constructs iso-surfaces to represent interfaces within the system
Since it is more computationally expensive to carry out these operations compared to the
basic analysis, it may be useful to choose ``subphase_analysis_interval`` to be larger than
``analysis_interval``. Nevertheless, since analysis is performed in memory, it is orders of
magnitude faster than to analyze data in situ rather than writing fields to disc. Monitoring
the performance in MLUPS provides an easy way to tune the analysis interval so that the
overall simulation performance is not subject to significant penalties.
There are three main entities that are constructed for subphase analysis
* :math:`\Omega_w:\phi<0` : region of space filled by fluid w
* :math:`\Omega_n:\phi<0` : region of space filled by fluid n
* :math:`\Omega_i: |\nabla \phi<0| > \epsilon` : region of space for the interface region
The phase regions are defined identical to what is reported in ``timelog.csv``.
The interface region is defined explicitly as the portion of space where
significant composition gradients are present.
The list of measures logged to ``subphase.csv`` are defined as follows.
The region of space occupied by the wetting fluid is determined from the
phase indicator field, :math:`\Omega_w:\phi<0`
* ``sw`` -- water saturation (fluid component 2)
* ``krw`` -- water effective permeability
* ``krn`` -- non-wetting fluid effective permeability
* ``krn`` -- non-wetting fluid effective permeability
* ``krwf`` -- non-wetting fluid effective permeability
* ``krnf`` -- non-wetting fluid effective permeability
More comprehensive analysis is performed in the ``subphase`` analysis module.
.. code-block:: bash
Analysis {
analysis_interval = 1000
subphase_analysis_interval = 5000
visualization_interval = 20000
}
1 ======================================
2 Color model -- Subphase Analysis
3 ======================================
4 The subphase analysis routine for the LBPM color model logs a time series
5 of averaged information to the space-delimited CSV file ``subphase.csv``.
6 The ``subphase_analysis_interval`` key should be specified to control the interval at
7 to perform basic analysis, which corresponds to the number of simulation timesteps
8 to perform between analyses. The subphase analys routine performs the following functions
9 * analyzes the connectivity of fluid phases using a connected components algorithm
10 * constructs iso-surfaces to represent interfaces within the system
11 Since it is more computationally expensive to carry out these operations compared to the
12 basic analysis, it may be useful to choose ``subphase_analysis_interval`` to be larger than
13 ``analysis_interval``. Nevertheless, since analysis is performed in memory, it is orders of
14 magnitude faster than to analyze data in situ rather than writing fields to disc. Monitoring
15 the performance in MLUPS provides an easy way to tune the analysis interval so that the
16 overall simulation performance is not subject to significant penalties.
17 There are three main entities that are constructed for subphase analysis
18 * :math:`\Omega_w:\phi<0` : region of space filled by fluid w
19 * :math:`\Omega_n:\phi<0` : region of space filled by fluid n
20 * :math:`\Omega_i: |\nabla \phi<0| > \epsilon` : region of space for the interface region
21 The phase regions are defined identical to what is reported in ``timelog.csv``.
22 The interface region is defined explicitly as the portion of space where
23 significant composition gradients are present.
24 The list of measures logged to ``subphase.csv`` are defined as follows.
25 The region of space occupied by the wetting fluid is determined from the
26 phase indicator field, :math:`\Omega_w:\phi<0`
27 * ``sw`` -- water saturation (fluid component 2)
28 * ``krw`` -- water effective permeability
29 * ``krn`` -- non-wetting fluid effective permeability
30 * ``krn`` -- non-wetting fluid effective permeability
31 * ``krwf`` -- non-wetting fluid effective permeability
32 * ``krnf`` -- non-wetting fluid effective permeability
33
34 More comprehensive analysis is performed in the ``subphase`` analysis module.
35 .. code-block:: bash
36 Analysis {
37 analysis_interval = 1000
38 subphase_analysis_interval = 5000
39 visualization_interval = 20000
40 }