Docs @ 336487c

Author: MFC Action

documentation/architecture.html

@@ -401,7 +401,7 @@ <h1 class="doxsection"><a class="anchor" id="autotoc_md13"></a>
 <li><b>Add the module to <span class="tt">docs/module_categories.json</span></b> so it appears in this page</li>
 </ol>
 <p>Follow the pattern of existing modules like <span class="tt">m_body_forces</span> (simple) or <span class="tt">m_viscous</span> (more involved) as a template.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-31</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-04-01</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/case_constraints.html

@@ -1420,7 +1420,7 @@ <h2 class="doxsection"><a class="anchor" id="physics-warnings"></a>
 </table>
 <hr  />
 <p>💡 <b>Tip:</b> If you encounter a validation error, check the relevant section above or review <a href="https://github.com/MFlowCode/MFC/blob/master/toolchain/mfc/case_validator.py"><span class="tt">case_validator.py</span></a> for complete validation logic.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-31</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-04-01</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/cli-reference.html

@@ -240,11 +240,15 @@ <h3 class="doxsection"><a class="anchor" id="build"></a>
 <tr class="markdownTableRowEven">
 <td class="markdownTableBodyNone"><span class="tt">--case-optimization</span>  </td><td class="markdownTableBodyNone">(GPU Optimization) Compile MFC targets with some case parameters hard-coded (requires &ndash;input).  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--mpi</span>, <span class="tt">--no-mpi</span>  </td><td class="markdownTableBodyNone">Enable/disable MPI  </td><td class="markdownTableBodyNone"><span class="tt">true</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--deps-only</span>  </td><td class="markdownTableBodyNone">Only fetch and build dependencies, do not build MFC targets.  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 <tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--mpi</span>, <span class="tt">--no-mpi</span>  </td><td class="markdownTableBodyNone">Enable/disable MPI  </td><td class="markdownTableBodyNone"><span class="tt">true</span>  </td></tr>
+<tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Build all default targets (CPU)</div>
@@ -331,7 +335,9 @@ <h3 class="doxsection"><a class="anchor" id="run"></a>
 <tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowEven">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Run interactively with 1 rank</div>
@@ -406,7 +412,9 @@ <h3 class="doxsection"><a class="anchor" id="test"></a>
 <tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowEven">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Run all tests</div>
@@ -449,7 +457,9 @@ <h3 class="doxsection"><a class="anchor" id="clean"></a>
 <tr class="markdownTableRowEven">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Clean all build files</div>
@@ -813,7 +823,9 @@ <h3 class="doxsection"><a class="anchor" id="count"></a>
 <tr class="markdownTableRowEven">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Show LOC statistics</div>
@@ -840,7 +852,9 @@ <h3 class="doxsection"><a class="anchor" id="count_diff"></a>
 <tr class="markdownTableRowEven">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <hr  />
 <h2 class="doxsection"><a class="anchor" id="autotoc_md70"></a>
@@ -872,7 +886,9 @@ <h3 class="doxsection"><a class="anchor" id="bench"></a>
 <tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowEven">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <p><b>Examples:</b></p>
 <div class="fragment"><div class="line"># Run benchmarks and save results</div>
@@ -902,7 +918,9 @@ <h3 class="doxsection"><a class="anchor" id="bench_diff"></a>
 <tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span>, <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU (OpenACC/OpenMP)  </td><td class="markdownTableBodyNone"><span class="tt">no</span>  </td></tr>
 <tr class="markdownTableRowEven">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span>, <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
+<tr class="markdownTableRowOdd">
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span>, <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td><td class="markdownTableBodyNone"><span class="tt">false</span>  </td></tr>
 </table>
 <hr  />
 <h2 class="doxsection"><a class="anchor" id="autotoc_md73"></a>
@@ -945,12 +963,14 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md78"></a>
 <tr class="markdownTableRowEven">
 <td class="markdownTableBodyNone"><span class="tt">--gpu [acc/mp]</span> / <span class="tt">--no-gpu</span>  </td><td class="markdownTableBodyNone">Enable GPU with OpenACC or OpenMP  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--debug</span> / <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with debug compiler flags  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--debug</span> / <span class="tt">--no-debug</span>  </td><td class="markdownTableBodyNone">Build with full debug compiler flags  </td></tr>
 <tr class="markdownTableRowEven">
-<td class="markdownTableBodyNone"><span class="tt">--gcov</span> / <span class="tt">--no-gcov</span>  </td><td class="markdownTableBodyNone">Enable code coverage  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--reldebug</span> / <span class="tt">--no-reldebug</span>  </td><td class="markdownTableBodyNone">Build with lightweight debug flags (CI)  </td></tr>
 <tr class="markdownTableRowOdd">
-<td class="markdownTableBodyNone"><span class="tt">--single</span> / <span class="tt">--no-single</span>  </td><td class="markdownTableBodyNone">Single precision  </td></tr>
+<td class="markdownTableBodyNone"><span class="tt">--gcov</span> / <span class="tt">--no-gcov</span>  </td><td class="markdownTableBodyNone">Enable code coverage  </td></tr>
 <tr class="markdownTableRowEven">
+<td class="markdownTableBodyNone"><span class="tt">--single</span> / <span class="tt">--no-single</span>  </td><td class="markdownTableBodyNone">Single precision  </td></tr>
+<tr class="markdownTableRowOdd">
 <td class="markdownTableBodyNone"><span class="tt">--mixed</span> / <span class="tt">--no-mixed</span>  </td><td class="markdownTableBodyNone">Mixed precision  </td></tr>
 </table>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
@@ -964,7 +984,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md80"></a>
 Debug Logging (<span class="tt">-d, --debug-log</span>)</h3>
 <p>Enables debug logging for the Python toolchain (mfc.sh internals). This is for troubleshooting the build system, not the MFC simulation code.</p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-31</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-04-01</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/examples.html

@@ -388,7 +388,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md274"></a>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md275"></a>
 Final Condition and Linear Theory</h3>
 <p><img src="final_condition-3D_rayleigh_taylor-example.png" alt="" height="400" class="inline"/> <img src="linear_theory-3D_rayleigh_taylor-example.png" alt="" height="400" class="inline"/></p>
-<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-03-31</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-04-01</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">