Skip to content

Commit 5d94287

Browse files
committed
deploy: 9e5d369
1 parent 5d5eb0d commit 5d94287

8 files changed

Lines changed: 102 additions & 8 deletions

.doctrees/1_requirements.doctree

351 Bytes
Binary file not shown.

.doctrees/3_numerical.doctree

11.6 KB
Binary file not shown.

.doctrees/environment.pickle

0 Bytes
Binary file not shown.

1_requirements.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -97,11 +97,10 @@ <h2>Hardware and Hardware Requirements<a class="headerlink" href="#hardware-and-
9797
<p>GPU acceleration is suggested for large dataset computation. Therefore, the requirements for GPU acceleration is listed as follows:</p>
9898
<ul class="simple">
9999
<li><p>NVIDIA GPUs, with a minimum <a class="reference external" href="https://developer.nvidia.com/cuda-gpus">compute capability</a> of 5.0, i.e., later than GTX 750.</p></li>
100-
<li><p>It is suggested that, make <code class="docutils literal notranslate"><span class="pre">Nx</span></code> × <code class="docutils literal notranslate"><span class="pre">Ny</span></code> × <code class="docutils literal notranslate"><span class="pre">Nz</span></code> × <code class="docutils literal notranslate"><span class="pre">Nt</span></code> less than 200,000,000 Lagrangian particles on each Gigabyte of GPU memory for double-side computation under default numerical methods for one still. Generally half it under high-order computations.</p></li>
100+
<li><p>It is suggested that, make <code class="docutils literal notranslate"><span class="pre">Nx</span></code> × <code class="docutils literal notranslate"><span class="pre">Ny</span></code> × <code class="docutils literal notranslate"><span class="pre">Nz</span></code> × <code class="docutils literal notranslate"><span class="pre">Nt</span></code> less than 200,000,000 Lagrangian particles on each Gigabyte of GPU memory for double-side computation under default numerical methods for one still. Generally half it under high-order computations. For example, you can execute on a 600×300×300 mesh for c.a. 80 time steps for a still on a welcomed RTX 2080ti 22G customized GPU, with the price of ~$400.</p></li>
101+
<li><p>The general short for GPU is VRAM, not computational power, hence old-but-large GPUs are great for use. Newers can be faster, but smallers can run nothing.</p></li>
102+
<li><p>The GPU requirements for dynamic LCS are undergoing experiments by the author.</p></li>
101103
</ul>
102-
<p>For example, you can execute on a 600×300×300 mesh for c.a. 80 time steps for a still on a welcomed RTX 2080ti 22G customized GPU, with the price of ~$400.
103-
* The general short for GPU is VRAM, not computational power, hence old-but-large GPUs are great for use. Newers can be faster, but smallers can run nothing.
104-
* The GPU requirements for dynamic LCS are undergoing experiments by the author.</p>
105104
</section>
106105
<section id="basic-environment">
107106
<h2>Basic Environment<a class="headerlink" href="#basic-environment" title="Link to this heading"></a></h2>
@@ -142,7 +141,8 @@ <h2>Add-on Libs<a class="headerlink" href="#add-on-libs" title="Link to this hea
142141
</section>
143142
<section id="quickstart">
144143
<h2>Quickstart<a class="headerlink" href="#quickstart" title="Link to this heading"></a></h2>
145-
<p>An computation example coming with a set of our in-house downscaled Direct Navier-Stokes Simulation (DNS) data is provided, including :math:
144+
<p>After configurations of environment, you can run a very first demo to test the environment as well as the code, and learn how to use this toolbox for your own data towards new insights.
145+
An computation example coming with a set of our in-house downscaled Direct Navier-Stokes Simulation (DNS) data is provided, including :math:
146146
The dataset can be downloaded from <a class="reference external" href="https://noting.noting">here</a>, and the case descriptions can be referred to paper <code class="docutils literal notranslate"><span class="pre">I.P.</span></code>.</p>
147147
</section>
148148
</section>

3_numerical.html

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,72 @@
144144
k_6 = \mathbf{u}\!\bigl(\mathbf{x}_n + \Delta t(-\tfrac{3}{2}k_1 + 2k_2 - \tfrac{1}{2}k_3 + k_4),\;t_n + \Delta t\bigr),\\
145145
\mathbf{x}_{n+1} = \mathbf{x}_n + \Delta t\bigl(\tfrac{1}{20}k_1 + \tfrac{1}{4}k_4 + \tfrac{1}{5}k_5 + \tfrac{1}{2}k_6\bigr).\end{split}\]</div>
146146
<p>This scheme incurs a global error of order <span class="math notranslate nohighlight">\(O(\Delta t^6)\)</span> with six velocity evaluations.</p>
147+
<table class="docutils align-default">
148+
<thead>
149+
<tr class="row-odd"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">output_dir</span></code></p></th>
150+
<th class="head"><p>Path to directory for saving results</p></th>
151+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">&lt;string&gt;</span></code></p></th>
152+
<th class="head"></th>
153+
</tr>
154+
<tr class="row-even"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">auto_wall</span></code></p></th>
155+
<th class="head"><p>Flag for automatic wall detection</p></th>
156+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">0</span></code></p></th>
157+
<th class="head"><p>Manually indicate computation bounds.</p></th>
158+
</tr>
159+
<tr class="row-odd"><th class="head"></th>
160+
<th class="head"></th>
161+
<th class="head"><p>(<code class="docutils literal notranslate"><span class="pre">1</span></code>)</p></th>
162+
<th class="head"><p>Auto detect bounds from input mesh.</p></th>
163+
</tr>
164+
<tr class="row-even"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">wall_xrange</span></code></p></th>
165+
<th class="head"><p>X-direction wall bounds [xmin, xmax]</p></th>
166+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">[&lt;float&gt;,</span> <span class="pre">&lt;float&gt;]</span></code></p></th>
167+
<th class="head"><p>Dimensionalized coordinates bounds.</p></th>
168+
</tr>
169+
<tr class="row-odd"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">wall_yrange</span></code></p></th>
170+
<th class="head"><p>Y-direction wall bounds [ymin, ymax]</p></th>
171+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">[&lt;float&gt;,</span> <span class="pre">&lt;float&gt;]</span></code></p></th>
172+
<th class="head"></th>
173+
</tr>
174+
<tr class="row-even"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">wall_zrange</span></code></p></th>
175+
<th class="head"><p>Z-direction wall bounds [zmin, zmax]</p></th>
176+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">[&lt;float&gt;,</span> <span class="pre">&lt;float&gt;]</span></code></p></th>
177+
<th class="head"></th>
178+
</tr>
179+
<tr class="row-odd"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">x</span></code></p></th>
180+
<th class="head"><p>Number of Lagrangian seed points in X direction</p></th>
181+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">&lt;int&gt;</span></code></p></th>
182+
<th class="head"></th>
183+
</tr>
184+
<tr class="row-even"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">y</span></code></p></th>
185+
<th class="head"><p>Number of Lagrangian seed points in Y direction</p></th>
186+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">&lt;int&gt;</span></code></p></th>
187+
<th class="head"></th>
188+
</tr>
189+
<tr class="row-odd"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">z</span></code></p></th>
190+
<th class="head"><p>Number of Lagrangian seed points in Z direction</p></th>
191+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">&lt;int&gt;</span></code></p></th>
192+
<th class="head"></th>
193+
</tr>
194+
<tr class="row-even"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">T_range</span></code></p></th>
195+
<th class="head"><p>Time range [<code class="docutils literal notranslate"><span class="pre">T_start</span></code>, <code class="docutils literal notranslate"><span class="pre">T_end</span></code>] in frames</p></th>
196+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">[&lt;float&gt;,</span> <span class="pre">&lt;float&gt;]</span></code></p></th>
197+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">T_end</span></code> no larger than <code class="docutils literal notranslate"><span class="pre">N_frames</span></code>.</p></th>
198+
</tr>
199+
<tr class="row-odd"><th class="head"><p><code class="docutils literal notranslate"><span class="pre">dt</span></code></p></th>
200+
<th class="head"><p>Time step for particle advection in frames</p></th>
201+
<th class="head"><p><code class="docutils literal notranslate"><span class="pre">&lt;float&gt;</span></code></p></th>
202+
<th class="head"></th>
203+
</tr>
204+
</thead>
205+
<tbody>
206+
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">physical_dt</span></code></p></td>
207+
<td><p>Physical time step between two input frames</p></td>
208+
<td><p><code class="docutils literal notranslate"><span class="pre">&lt;float&gt;</span></code></p></td>
209+
<td><p>Perform physical advection.</p></td>
210+
</tr>
211+
</tbody>
212+
</table>
147213
</section>
148214
</section>
149215
<section id="ftle-computation">

_sources/1_requirements.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,7 @@ The minimiums are listed as follows:
1414
GPU acceleration is suggested for large dataset computation. Therefore, the requirements for GPU acceleration is listed as follows:
1515

1616
* NVIDIA GPUs, with a minimum `compute capability <https://developer.nvidia.com/cuda-gpus>`__ of 5.0, i.e., later than GTX 750.
17-
* It is suggested that, make ``Nx`` × ``Ny`` × ``Nz`` × ``Nt`` less than 200,000,000 Lagrangian particles on each Gigabyte of GPU memory for double-side computation under default numerical methods for one still. Generally half it under high-order computations.
18-
For example, you can execute on a 600×300×300 mesh for c.a. 80 time steps for a still on a welcomed RTX 2080ti 22G customized GPU, with the price of ~$400.
17+
* It is suggested that, make ``Nx`` × ``Ny`` × ``Nz`` × ``Nt`` less than 200,000,000 Lagrangian particles on each Gigabyte of GPU memory for double-side computation under default numerical methods for one still. Generally half it under high-order computations. For example, you can execute on a 600×300×300 mesh for c.a. 80 time steps for a still on a welcomed RTX 2080ti 22G customized GPU, with the price of ~$400.
1918
* The general short for GPU is VRAM, not computational power, hence old-but-large GPUs are great for use. Newers can be faster, but smallers can run nothing.
2019
* The GPU requirements for dynamic LCS are undergoing experiments by the author.
2120

@@ -67,5 +66,6 @@ For already-installed ParaView, set environment variable ``PARAVIEW_PATH`` point
6766
Quickstart
6867
-----------------
6968

69+
After configurations of environment, you can run a very first demo to test the environment as well as the code, and learn how to use this toolbox for your own data towards new insights.
7070
An computation example coming with a set of our in-house downscaled Direct Navier-Stokes Simulation (DNS) data is provided, including :math:
7171
The dataset can be downloaded from `here <https://noting.noting>`__, and the case descriptions can be referred to paper ``I.P.``.

_sources/3_numerical.rst.txt

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,34 @@ The six-stage scheme uses non-uniform weights to attain sixth-order accuracy:
8888
8989
This scheme incurs a global error of order :math:`O(\Delta t^6)` with six velocity evaluations.
9090

91+
92+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
93+
| ``output_dir`` | Path to directory for saving results | ``<string>`` | |
94+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
95+
| ``auto_wall`` | Flag for automatic wall detection | ``0`` | Manually indicate computation bounds. |
96+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
97+
| | | (``1``) | Auto detect bounds from input mesh. |
98+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
99+
| ``wall_xrange`` | X-direction wall bounds [xmin, xmax] | ``[<float>, <float>]`` | Dimensionalized coordinates bounds. |
100+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
101+
| ``wall_yrange`` | Y-direction wall bounds [ymin, ymax] | ``[<float>, <float>]`` | |
102+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
103+
| ``wall_zrange`` | Z-direction wall bounds [zmin, zmax] | ``[<float>, <float>]`` | |
104+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
105+
| ``x`` | Number of Lagrangian seed points in X direction | ``<int>`` | |
106+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
107+
| ``y`` | Number of Lagrangian seed points in Y direction | ``<int>`` | |
108+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
109+
| ``z`` | Number of Lagrangian seed points in Z direction | ``<int>`` | |
110+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
111+
| ``T_range`` | Time range [``T_start``, ``T_end``] in frames | ``[<float>, <float>]`` | ``T_end`` no larger than ``N_frames``. |
112+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
113+
| ``dt`` | Time step for particle advection in frames | ``<float>`` | |
114+
+===================+======================================================+=========================+=========================================================================================================+
115+
| ``physical_dt`` | Physical time step between two input frames | ``<float>`` | Perform physical advection. |
116+
+-------------------+------------------------------------------------------+-------------------------+---------------------------------------------------------------------------------------------------------+
117+
118+
91119
.. _ftlefinal:
92120

93121
FTLE Computation

searchindex.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)