Skip to content

Commit 5e14ffb

Browse files
author
MFC Action
committed
Docs @ 0c772e6
1 parent a0d49e8 commit 5e14ffb

576 files changed

Lines changed: 44569 additions & 43859 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

documentation/architecture.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -384,6 +384,8 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md10"></a>
384384
<td class="markdownTableBodyNone"><span class="tt">m_sim_helpers</span> </td><td class="markdownTableBodyNone">Simulation helper routines for enthalpy computation, CFL calculation, and stability checks </td></tr>
385385
<tr class="markdownTableRowEven">
386386
<td class="markdownTableBodyNone"><span class="tt">m_derived_variables</span> </td><td class="markdownTableBodyNone">Derives diagnostic flow quantities (vorticity, speed of sound, numerical Schlieren, etc.) from conservative and primitive variables </td></tr>
387+
<tr class="markdownTableRowOdd">
388+
<td class="markdownTableBodyNone"><span class="tt">m_patch_geometries</span> </td><td class="markdownTableBodyNone">Contains helper functions specific to various patch gemoetries for determining if a grid cell lies inside of or outside of a patch geometry </td></tr>
387389
</table>
388390
<h2 class="doxsection"><a class="anchor" id="autotoc_md11"></a>
389391
Pre-Process</h2>
@@ -425,7 +427,7 @@ <h1 class="doxsection"><a class="anchor" id="autotoc_md13"></a>
425427
<li><b>Add the module to <span class="tt">docs/module_categories.json</span></b> so it appears in this page</li>
426428
</ol>
427429
<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>
428-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-16</div> </div></div><!-- contents -->
430+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-17</div> </div></div><!-- contents -->
429431
</div><!-- PageDoc -->
430432
</div><!-- doc-content -->
431433
<div id="page-nav" class="page-nav-panel">

documentation/case.html

Lines changed: 68 additions & 37 deletions
Large diffs are not rendered by default.

documentation/case_constraints.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@
157157
<div class="headertitle"><div class="title">Case Creator Guide </div></div>
158158
</div><!--header-->
159159
<div class="contents">
160-
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md40"></a>
160+
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md41"></a>
161161
Case Creator Guide</h1>
162162
<blockquote class="doxtable">
163163
<p><b>Quick reference</b> for building MFC cases: working examples, compatibility rules, and configuration requirements. </p>
@@ -170,7 +170,7 @@ <h2 class="doxsection"><a class="anchor" id="case-design-playbook"></a>
170170
<blockquote class="doxtable">
171171
<p><b>Learn by example:</b> The cases below are curated from MFC's <span class="tt">examples/</span> directory and are validated, working configurations. Use them as blueprints for building your own simulations. </p>
172172
</blockquote>
173-
<h3 class="doxsection"><a class="anchor" id="autotoc_md41"></a>
173+
<h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
174174
🟢 Beginner Examples</h3>
175175
<details >
176176
<summary >
@@ -196,7 +196,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md41"></a>
196196
</ul>
197197
<p></p>
198198
</details>
199-
<h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
199+
<h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
200200
🟡 Intermediate Examples</h3>
201201
<details >
202202
<summary >
@@ -329,7 +329,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
329329
</ul>
330330
<p></p>
331331
</details>
332-
<h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
332+
<h3 class="doxsection"><a class="anchor" id="autotoc_md44"></a>
333333
🔴 Advanced Examples</h3>
334334
<details >
335335
<summary >
@@ -1461,7 +1461,7 @@ <h2 class="doxsection"><a class="anchor" id="physics-warnings"></a>
14611461
</table>
14621462
<hr />
14631463
<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>
1464-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-16</div> </div></div><!-- contents -->
1464+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-17</div> </div></div><!-- contents -->
14651465
</div><!-- PageDoc -->
14661466
</div><!-- doc-content -->
14671467
<div id="page-nav" class="page-nav-panel">

documentation/cli-reference.html

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -157,16 +157,16 @@
157157
<div class="headertitle"><div class="title">CLI Reference </div></div>
158158
</div><!--header-->
159159
<div class="contents">
160-
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md45"></a>
160+
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md46"></a>
161161
CLI Reference</h1>
162162
<blockquote class="doxtable">
163163
<p><b>Auto-generated</b> from <span class="tt">toolchain/mfc/cli/commands.py</span></p>
164164
<p>Regenerate with: <span class="tt">./mfc.sh generate</span> </p>
165165
</blockquote>
166-
<h2 class="doxsection"><a class="anchor" id="autotoc_md46"></a>
166+
<h2 class="doxsection"><a class="anchor" id="autotoc_md47"></a>
167167
Overview</h2>
168168
<p>Welcome to the MFC master script. This tool automates and manages building, testing, running, and cleaning of MFC in various configurations on all supported platforms. The README documents this tool and its various commands in more detail. To get started, run <span class="tt">./mfc.sh build -h</span>.</p>
169-
<h2 class="doxsection"><a class="anchor" id="autotoc_md47"></a>
169+
<h2 class="doxsection"><a class="anchor" id="autotoc_md48"></a>
170170
Quick Reference</h2>
171171
<table class="markdownTable">
172172
<tr class="markdownTableHead">
@@ -218,7 +218,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md47"></a>
218218
<tr class="markdownTableRowOdd">
219219
<td class="markdownTableBodyNone"><code>fp-stability</code> </td><td class="markdownTableBodyNone">- </td><td class="markdownTableBodyNone">Run floating-point stability tests using Verrou. </td></tr>
220220
</table>
221-
<h2 class="doxsection"><a class="anchor" id="autotoc_md48"></a>
221+
<h2 class="doxsection"><a class="anchor" id="autotoc_md49"></a>
222222
Commands</h2>
223223
<h3 class="doxsection"><a class="anchor" id="build"></a>
224224
build</h3>
@@ -503,7 +503,7 @@ <h3 class="doxsection"><a class="anchor" id="validate"></a>
503503
<div class="line"># Rewrite integer codes to named values</div>
504504
<div class="line">./mfc.sh validate case.py --migrate</div>
505505
</div><!-- fragment --><hr />
506-
<h2 class="doxsection"><a class="anchor" id="autotoc_md54"></a>
506+
<h2 class="doxsection"><a class="anchor" id="autotoc_md55"></a>
507507
Utility Commands</h2>
508508
<h3 class="doxsection"><a class="anchor" id="new"></a>
509509
new</h3>
@@ -679,7 +679,7 @@ <h3 class="doxsection"><a class="anchor" id="packer"></a>
679679
<div class="line"># Compare two packed files</div>
680680
<div class="line">./mfc.sh packer compare a.pack b.pack</div>
681681
</div><!-- fragment --><p><b>Subcommands:</b></p>
682-
<h4 class="doxsection"><a class="anchor" id="autotoc_md58"></a>
682+
<h4 class="doxsection"><a class="anchor" id="autotoc_md59"></a>
683683
packer pack</h4>
684684
<p>Pack a case into a single file.</p>
685685
<p>Arguments:</p><ul>
@@ -692,7 +692,7 @@ <h4 class="doxsection"><a class="anchor" id="autotoc_md58"></a>
692692
<tr class="markdownTableRowOdd">
693693
<td class="markdownTableBodyNone"><span class="tt">-o</span>, <span class="tt">--output</span> </td><td class="markdownTableBodyNone">Base name of output file. </td><td class="markdownTableBodyNone">- </td></tr>
694694
</table>
695-
<h4 class="doxsection"><a class="anchor" id="autotoc_md59"></a>
695+
<h4 class="doxsection"><a class="anchor" id="autotoc_md60"></a>
696696
packer compare</h4>
697697
<p>Compare two cases.</p>
698698
<p>Arguments:</p><ul>
@@ -760,7 +760,7 @@ <h3 class="doxsection"><a class="anchor" id="generate"></a>
760760
<div class="line"># Generate JSON Schema for IDE support</div>
761761
<div class="line">./mfc.sh generate --json-schema</div>
762762
</div><!-- fragment --><hr />
763-
<h2 class="doxsection"><a class="anchor" id="autotoc_md64"></a>
763+
<h2 class="doxsection"><a class="anchor" id="autotoc_md65"></a>
764764
Development Commands</h2>
765765
<h3 class="doxsection"><a class="anchor" id="lint"></a>
766766
lint</h3>
@@ -872,7 +872,7 @@ <h3 class="doxsection"><a class="anchor" id="count_diff"></a>
872872
<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>
873873
</table>
874874
<hr />
875-
<h2 class="doxsection"><a class="anchor" id="autotoc_md71"></a>
875+
<h2 class="doxsection"><a class="anchor" id="autotoc_md72"></a>
876876
CI Commands</h2>
877877
<h3 class="doxsection"><a class="anchor" id="bench"></a>
878878
bench</h3>
@@ -938,7 +938,7 @@ <h3 class="doxsection"><a class="anchor" id="bench_diff"></a>
938938
<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>
939939
</table>
940940
<hr />
941-
<h2 class="doxsection"><a class="anchor" id="autotoc_md74"></a>
941+
<h2 class="doxsection"><a class="anchor" id="autotoc_md75"></a>
942942
Other Commands</h2>
943943
<h3 class="doxsection"><a class="anchor" id="load"></a>
944944
load</h3>
@@ -956,10 +956,10 @@ <h3 class="doxsection"><a class="anchor" id="interactive"></a>
956956
<p>Launch an interactive menu for MFC operations.</p>
957957
<p><b>Usage:</b> <span class="tt">./mfc.sh interactive [OPTIONS]</span></p>
958958
<hr />
959-
<h2 class="doxsection"><a class="anchor" id="autotoc_md77"></a>
959+
<h2 class="doxsection"><a class="anchor" id="autotoc_md78"></a>
960960
Common Options</h2>
961961
<p>Many commands share common option sets:</p>
962-
<h3 class="doxsection"><a class="anchor" id="autotoc_md78"></a>
962+
<h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
963963
Target Selection (<span class="tt">-t, --targets</span>)</h3>
964964
<p>Available targets:</p><ul>
965965
<li><span class="tt">pre_process</span> - Pre-processor</li>
@@ -968,7 +968,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md78"></a>
968968
<li><span class="tt">syscheck</span> - System check utility</li>
969969
<li><span class="tt">documentation</span> - Build documentation</li>
970970
</ul>
971-
<h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
971+
<h3 class="doxsection"><a class="anchor" id="autotoc_md80"></a>
972972
Build Configuration Flags</h3>
973973
<table class="markdownTable">
974974
<tr class="markdownTableHead">
@@ -988,18 +988,18 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md79"></a>
988988
<tr class="markdownTableRowOdd">
989989
<td class="markdownTableBodyNone"><span class="tt">--mixed</span> / <span class="tt">--no-mixed</span> </td><td class="markdownTableBodyNone">Mixed precision </td></tr>
990990
</table>
991-
<h3 class="doxsection"><a class="anchor" id="autotoc_md80"></a>
991+
<h3 class="doxsection"><a class="anchor" id="autotoc_md81"></a>
992992
Verbosity (<span class="tt">-v, --verbose</span>)</h3>
993993
<p>Controls output verbosity level:</p>
994994
<ul>
995995
<li><span class="tt">-v</span> - Basic verbose output</li>
996996
<li><span class="tt">-vv</span> - Show build commands</li>
997997
<li><span class="tt">-vvv</span> - Full verbose output including CMake details</li>
998998
</ul>
999-
<h3 class="doxsection"><a class="anchor" id="autotoc_md81"></a>
999+
<h3 class="doxsection"><a class="anchor" id="autotoc_md82"></a>
10001000
Debug Logging (<span class="tt">-d, --debug-log</span>)</h3>
10011001
<p>Enables debug logging for the Python toolchain (mfc.sh internals). This is for troubleshooting the build system, not the MFC simulation code.</p>
1002-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-16</div> </div></div><!-- contents -->
1002+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-17</div> </div></div><!-- contents -->
10031003
</div><!-- PageDoc -->
10041004
</div><!-- doc-content -->
10051005
<div id="page-nav" class="page-nav-panel">

0 commit comments

Comments
 (0)