Skip to content

Commit ec94452

Browse files
author
MFC Action
committed
Docs @ 492f4c5
1 parent f81b53d commit ec94452

48 files changed

Lines changed: 6224 additions & 6203 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: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -427,7 +427,7 @@ <h1 class="doxsection"><a class="anchor" id="autotoc_md13"></a>
427427
<li><b>Add the module to <span class="tt">docs/module_categories.json</span></b> so it appears in this page</li>
428428
</ol>
429429
<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>
430-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-24</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-25</div> </div></div><!-- contents -->
431431
</div><!-- PageDoc -->
432432
</div><!-- doc-content -->
433433
<div id="page-nav" class="page-nav-panel">

documentation/case_constraints.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -808,6 +808,7 @@ <h2 class="doxsection"><a class="anchor" id="quick-parameter-reference"></a>
808808
<li>When enabled, requires: <span class="tt">num_ibs</span></li>
809809
</ul>
810810
<p><b>Requirements</b> (errors):</p><ul>
811+
<li>fd_order must be specified for ib</li>
811812
<li>Immersed Boundaries do not work in 1D (requires n &gt; 0)</li>
812813
<li>ib_state_wrt requires ib to be enabled</li>
813814
</ul>
@@ -1461,7 +1462,7 @@ <h2 class="doxsection"><a class="anchor" id="physics-warnings"></a>
14611462
</table>
14621463
<hr />
14631464
<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-24</div> </div></div><!-- contents -->
1465+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-25</div> </div></div><!-- contents -->
14651466
</div><!-- PageDoc -->
14661467
</div><!-- doc-content -->
14671468
<div id="page-nav" class="page-nav-panel">

documentation/cli-reference.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -999,7 +999,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md81"></a>
999999
<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-24</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-25</div> </div></div><!-- contents -->
10031003
</div><!-- PageDoc -->
10041004
</div><!-- doc-content -->
10051005
<div id="page-nav" class="page-nav-panel">

documentation/examples.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -630,7 +630,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md313"></a>
630630
<p><img src="result-2D_shockdroplet-example.png" alt="" height="400" class="inline"/></p>
631631
<p>This example case contains an automated convergence test using a 1D, two-component advection case. The case can be run by executing the bash script <span class="tt">./submitJobs.sh</span> in a terminal after enabling execution permissions with <span class="tt">chmod +x ./submitJobs.sh</span> and setting the <span class="tt">ROOT_DIR</span> and <span class="tt">MFC_DIR</span> variables. By default the script runs the case for 6 different grid resolutions with 1st, 3rd, and 5th, order spatial reconstructions. These settings can be modified by editing the variables at the top of the script. You can also run different model equations by setting the <span class="tt">ME</span> variable and different Riemann solvers by setting the <span class="tt">RS</span> variable.</p>
632632
<p>Once the simulations have been run, you can generate convergence plots with matplotlib by running <span class="tt">python3 plot.py</span> in a terminal. This will generate plots of the L1, L2, and Linf error norms and save the results to <span class="tt">errors.csv</span>.</p>
633-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-24</div> </div></div><!-- contents -->
633+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-25</div> </div></div><!-- contents -->
634634
</div><!-- PageDoc -->
635635
</div><!-- doc-content -->
636636
<div id="page-nav" class="page-nav-panel">

documentation/parameters.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1288,7 +1288,7 @@ <h2 class="doxsection"><a class="anchor" id="general"></a>
12881288
<tr class="markdownTableRowEven">
12891289
<td class="markdownTableBodyNone"><span class="tt">hypoelasticity</span> </td><td class="markdownTableBodyNone">Logical (T/F) </td><td class="markdownTableBodyNone">Enable hypoelastic model </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone"><span class="tt">hypoelasticity</span> requires <span class="tt">model_eqns</span> = 2; <span class="tt">hypoelasticity</span> requires HLL Riemann solver (<span class="tt">riemann_solver</span> = 1) </td></tr>
12901290
<tr class="markdownTableRowOdd">
1291-
<td class="markdownTableBodyNone"><span class="tt">ib</span> </td><td class="markdownTableBodyNone">Logical (T/F) </td><td class="markdownTableBodyNone">Enable immersed boundary method </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">Immersed Boundaries do not work in 1D (requires n &gt; 0); <span class="tt">num_ibs</span> must be &gt;= 1 when <span class="tt">ib</span> is enabled (or specify at least one <span class="tt">particle_cloud</span> with <span class="tt">num_particles</span> &gt; 0); <span class="tt">num_ibs</span> must be &lt;= <span class="tt">num_ib_patches_max</span> (<span class="tt">num_ib_patches_max_namelist</span> in <span class="tt">m_constants</span>.fpp) </td></tr>
1291+
<td class="markdownTableBodyNone"><span class="tt">ib</span> </td><td class="markdownTableBodyNone">Logical (T/F) </td><td class="markdownTableBodyNone">Enable immersed boundary method </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone"><span class="tt">fd_order</span> must be specified for <span class="tt">ib</span>; Immersed Boundaries do not work in 1D (requires n &gt; 0); <span class="tt">num_ibs</span> must be &gt;= 1 when <span class="tt">ib</span> is enabled (or specify at least one <span class="tt">particle_cloud</span> with <span class="tt">num_particles</span> &gt; 0) </td></tr>
12921292
<tr class="markdownTableRowEven">
12931293
<td class="markdownTableBodyNone"><span class="tt">ib_coefficient_of_friction</span> </td><td class="markdownTableBodyNone">Real </td><td class="markdownTableBodyNone">coefficient of friction used in IB collisions </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">Immersed boundary parameter </td></tr>
12941294
<tr class="markdownTableRowOdd">
@@ -1605,7 +1605,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md434"></a>
16051605
<div class="line"> </div>
16061606
<div class="line"># Filter by type</div>
16071607
<div class="line">./mfc.sh params -t real weno</div>
1608-
</div><!-- fragment --><div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-24</div> </div></div><!-- contents -->
1608+
</div><!-- fragment --><div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-25</div> </div></div><!-- contents -->
16091609
</div><!-- PageDoc -->
16101610
</div><!-- doc-content -->
16111611
<div id="page-nav" class="page-nav-panel">

documentation/physics_constraints.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -656,7 +656,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md485"></a>
656656
<li>FFT WRT incompatible with cylindrical coordinates</li>
657657
<li>FFT WRT requires global dimensions divisible by 2</li>
658658
</ul>
659-
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-24</div> </div></div><!-- contents -->
659+
<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-06-25</div> </div></div><!-- contents -->
660660
</div><!-- PageDoc -->
661661
</div><!-- doc-content -->
662662
<div id="page-nav" class="page-nav-panel">

simulation/doxygen_crawl.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -663,10 +663,7 @@
663663
<a href="namespacem__derived__variables.html#a2ad32df44939f53838dc6fe272c28ccb"/>
664664
<a href="namespacem__derived__variables.html#a3eb66e46af47e787f79a01e2236779b0"/>
665665
<a href="namespacem__derived__variables.html#a4a361321ed7068d74220d79b0a14e6c4"/>
666-
<a href="namespacem__derived__variables.html#a4db3866184ab1811002aec3e6e22c40a"/>
667-
<a href="namespacem__derived__variables.html#a7124df0982c30315cf6638596693f7ce"/>
668666
<a href="namespacem__derived__variables.html#a77b3f12eca15a93f0bbe8881f6bbcfd4"/>
669-
<a href="namespacem__derived__variables.html#a7bf1c5799ea6a39a4be055ecd66b6b8b"/>
670667
<a href="namespacem__derived__variables.html#ad5dfada9c933c6a4d3f9b41a8b7a98f9"/>
671668
<a href="namespacem__derived__variables.html#ade7f2b3caf70e9839dbcd5937a6fc982"/>
672669
<a href="namespacem__derived__variables.html#ae5f6b78c6e67bce7d4f9c6814b8fbd2b"/>
@@ -738,6 +735,7 @@
738735
<a href="namespacem__global__parameters.html#a33b4272ac0c75aff15851f9dfa6a9d14"/>
739736
<a href="namespacem__global__parameters.html#a383c6ff025d4ea09ddd4e2356042d86b"/>
740737
<a href="namespacem__global__parameters.html#a38a29138166e436370b8d57be3207692"/>
738+
<a href="namespacem__global__parameters.html#a38a6274bd913eb525dc43fec88c798b8"/>
741739
<a href="namespacem__global__parameters.html#a39f8f9e370fa12d18d6c6e666dc2a561"/>
742740
<a href="namespacem__global__parameters.html#a412b521f53489c6e3924ac69de0495ac"/>
743741
<a href="namespacem__global__parameters.html#a46a3e8a6405a0008a7f34bcfc648b20f"/>
@@ -780,6 +778,7 @@
780778
<a href="namespacem__global__parameters.html#a8780eea6af1d24812fe7a3872e178a58"/>
781779
<a href="namespacem__global__parameters.html#a8b9e56ff9c0da6dca164f0445c3fa77b"/>
782780
<a href="namespacem__global__parameters.html#a8d92e6693bd3b6bd68e024d00437dfa3"/>
781+
<a href="namespacem__global__parameters.html#a8defd37e7bf484d0e0891affbb5427c9"/>
783782
<a href="namespacem__global__parameters.html#a8ed3dee47bbaa5de7ae564ca9d770404"/>
784783
<a href="namespacem__global__parameters.html#a91304734742c36abcb4dbf0712545344"/>
785784
<a href="namespacem__global__parameters.html#a9319da4e5fa3c04c6d8e169d85523fdf"/>
@@ -811,6 +810,7 @@
811810
<a href="namespacem__global__parameters.html#ad263edf3b1c7617112e716c12e2980f8"/>
812811
<a href="namespacem__global__parameters.html#ad48aea41066f34a5b868bb5d83767eef"/>
813812
<a href="namespacem__global__parameters.html#ad4e160df8d0de7ea1801a1ca29f8e9b0"/>
813+
<a href="namespacem__global__parameters.html#ad5246d5c36c96abd9862971f720b7383"/>
814814
<a href="namespacem__global__parameters.html#ad76c4758994b52559f478d251dc0cba5"/>
815815
<a href="namespacem__global__parameters.html#ad80f68aac31aa898ab2d7729f60e375f"/>
816816
<a href="namespacem__global__parameters.html#adab11dab474410541d4c37725bea01e1"/>

simulation/m__boundary__primitives_8fpp_8f90_source.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1761,7 +1761,7 @@
17611761
<div class="ttc" id="anamespacem__global__parameters_html_a7a7bb7c9caddde4f86bd27169b0f150d"><div class="ttname"><a href="namespacem__global__parameters.html#a7a7bb7c9caddde4f86bd27169b0f150d">m_global_parameters::bc_y</a></div><div class="ttdeci">type(int_bounds_info) bc_y</div><div class="ttdef"><b>Definition</b> <a href="m__global__parameters_8fpp_8f90_source.html#l00469">m_global_parameters.fpp.f90:469</a></div></div>
17621762
<div class="ttc" id="anamespacem__global__parameters_html_a91304734742c36abcb4dbf0712545344"><div class="ttname"><a href="namespacem__global__parameters.html#a91304734742c36abcb4dbf0712545344">m_global_parameters::bc_x</a></div><div class="ttdeci">type(int_bounds_info) bc_x</div><div class="ttdef"><b>Definition</b> <a href="m__global__parameters_8fpp_8f90_source.html#l00469">m_global_parameters.fpp.f90:469</a></div></div>
17631763
<div class="ttc" id="anamespacem__global__parameters_html_a9544f569916da49084e78b52371ad9e6"><div class="ttname"><a href="namespacem__global__parameters.html#a9544f569916da49084e78b52371ad9e6">m_global_parameters::z_cc</a></div><div class="ttdeci">real(wp), dimension(:), allocatable, target z_cc</div><div class="ttdef"><b>Definition</b> <a href="m__global__parameters_8fpp_8f90_source.html#l00399">m_global_parameters.fpp.f90:399</a></div></div>
1764-
<div class="ttc" id="anamespacem__global__parameters_html_ad76c4758994b52559f478d251dc0cba5"><div class="ttname"><a href="namespacem__global__parameters.html#ad76c4758994b52559f478d251dc0cba5">m_global_parameters::nb</a></div><div class="ttdeci">integer nb</div><div class="ttdef"><b>Definition</b> <a href="m__global__parameters_8fpp_8f90_source.html#l00738">m_global_parameters.fpp.f90:738</a></div></div>
1764+
<div class="ttc" id="anamespacem__global__parameters_html_ad76c4758994b52559f478d251dc0cba5"><div class="ttname"><a href="namespacem__global__parameters.html#ad76c4758994b52559f478d251dc0cba5">m_global_parameters::nb</a></div><div class="ttdeci">integer nb</div><div class="ttdef"><b>Definition</b> <a href="m__global__parameters_8fpp_8f90_source.html#l00756">m_global_parameters.fpp.f90:756</a></div></div>
17651765
<div class="ttc" id="astructm__derived__types_1_1scalar__field_html"><div class="ttname"><a href="structm__derived__types_1_1scalar__field.html">m_derived_types::scalar_field</a></div><div class="ttdoc">Derived type annexing a scalar field (SF).</div><div class="ttdef"><b>Definition</b> <a href="m__derived__types_8fpp_8f90_source.html#l00337">m_derived_types.fpp.f90:337</a></div></div>
17661766
</div><!-- fragment --></div><!-- contents -->
17671767
</div><!-- doc-content -->

0 commit comments

Comments
 (0)