Skip to content

Commit 191f178

Browse files
author
MFC Action
committed
Docs @ 3639574
1 parent 1f80a2f commit 191f178

File tree

227 files changed

+5623
-5524
lines changed

Some content is hidden

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

227 files changed

+5623
-5524
lines changed

documentation/case.html

Lines changed: 144 additions & 137 deletions
Large diffs are not rendered by default.

documentation/case_constraints.html

Lines changed: 39 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -128,20 +128,20 @@
128128
<div class="headertitle"><div class="title">Case Creator Guide </div></div>
129129
</div><!--header-->
130130
<div class="contents">
131-
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md39"></a>
131+
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="autotoc_md24"></a>
132132
Case Creator Guide</h1>
133133
<blockquote class="doxtable">
134134
<p><b>Quick reference</b> for building MFC cases: working examples, compatibility rules, and configuration requirements. </p>
135135
</blockquote>
136136
<blockquote class="doxtable">
137137
<p>Auto-generated from <span class="tt">case_validator.py</span> and <span class="tt">examples/</span>. </p>
138138
</blockquote>
139-
<h2 class="doxsection"><a class="anchor" id="autotoc_md40"></a>
139+
<h2 class="doxsection"><a class="anchor" id="case-design-playbook"></a>
140140
🧩 Case Design Playbook</h2>
141141
<blockquote class="doxtable">
142142
<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>
143143
</blockquote>
144-
<h3 class="doxsection"><a class="anchor" id="autotoc_md41"></a>
144+
<h3 class="doxsection"><a class="anchor" id="autotoc_md25"></a>
145145
🟢 Beginner Examples</h3>
146146
<details >
147147
<summary >
@@ -162,12 +162,12 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md41"></a>
162162
<li><b>Time stepping:</b> RK3 (SSP)</li>
163163
</ul>
164164
<p><b>Related Documentation:</b></p><ul>
165-
<li>Model Equations (model_eqns = 2)</li>
166-
<li>Riemann Solvers</li>
165+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
166+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
167167
</ul>
168168
<p></p>
169169
</details>
170-
<h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
170+
<h3 class="doxsection"><a class="anchor" id="autotoc_md26"></a>
171171
🟡 Intermediate Examples</h3>
172172
<details >
173173
<summary >
@@ -189,9 +189,9 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
189189
<li><b>Time stepping:</b> RK3 (SSP)</li>
190190
</ul>
191191
<p><b>Related Documentation:</b></p><ul>
192-
<li>Model Equations (model_eqns = 2)</li>
193-
<li>Riemann Solvers</li>
194-
<li>Bubble Models</li>
192+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
193+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
194+
<li><a class="el" href="#bubble-models" title="💧 Bubble Models">Bubble Models</a></li>
195195
</ul>
196196
<p></p>
197197
</details>
@@ -215,10 +215,10 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
215215
<li><b>Time stepping:</b> RK3 (SSP)</li>
216216
</ul>
217217
<p><b>Related Documentation:</b></p><ul>
218-
<li>Model Equations (model_eqns = 2)</li>
219-
<li>Riemann Solvers</li>
220-
<li>Bubble Models</li>
221-
<li>Viscosity</li>
218+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
219+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
220+
<li><a class="el" href="#bubble-models" title="💧 Bubble Models">Bubble Models</a></li>
221+
<li><a class="el" href="#compat-physics-models" title="Physics Models">Viscosity</a></li>
222222
</ul>
223223
<p></p>
224224
</details>
@@ -242,9 +242,9 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
242242
<li><b>Time stepping:</b> RK3 (SSP)</li>
243243
</ul>
244244
<p><b>Related Documentation:</b></p><ul>
245-
<li>Model Equations (model_eqns = 2)</li>
246-
<li>Riemann Solvers</li>
247-
<li>MHD</li>
245+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
246+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
247+
<li><a class="el" href="#compat-physics-models" title="Physics Models">MHD</a></li>
248248
</ul>
249249
<p></p>
250250
</details>
@@ -268,9 +268,9 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
268268
<li><b>Time stepping:</b> RK3 (SSP)</li>
269269
</ul>
270270
<p><b>Related Documentation:</b></p><ul>
271-
<li>Model Equations (model_eqns = 2)</li>
272-
<li>Riemann Solvers</li>
273-
<li>Immersed Boundaries</li>
271+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
272+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
273+
<li><a class="el" href="#compat-geometry" title="Geometry">Immersed Boundaries</a></li>
274274
</ul>
275275
<p></p>
276276
</details>
@@ -294,13 +294,13 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md42"></a>
294294
<li><b>Time stepping:</b> RK3 (SSP)</li>
295295
</ul>
296296
<p><b>Related Documentation:</b></p><ul>
297-
<li>Model Equations (model_eqns = 2)</li>
298-
<li>Riemann Solvers</li>
299-
<li>Viscosity</li>
297+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
298+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
299+
<li><a class="el" href="#compat-physics-models" title="Physics Models">Viscosity</a></li>
300300
</ul>
301301
<p></p>
302302
</details>
303-
<h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
303+
<h3 class="doxsection"><a class="anchor" id="autotoc_md27"></a>
304304
🔴 Advanced Examples</h3>
305305
<details >
306306
<summary >
@@ -323,8 +323,8 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
323323
<li><b>Time stepping:</b> RK3 (SSP)</li>
324324
</ul>
325325
<p><b>Related Documentation:</b></p><ul>
326-
<li>Model Equations (model_eqns = 3)</li>
327-
<li>Riemann Solvers</li>
326+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 3)</a></li>
327+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
328328
</ul>
329329
<p></p>
330330
</details>
@@ -348,9 +348,9 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
348348
<li><b>Time stepping:</b> RK3 (SSP)</li>
349349
</ul>
350350
<p><b>Related Documentation:</b></p><ul>
351-
<li>Model Equations (model_eqns = 2)</li>
352-
<li>Riemann Solvers</li>
353-
<li>Viscosity</li>
351+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
352+
<li><a class="el" href="#riemann-solvers" title="⚙️ Riemann Solvers">Riemann Solvers</a></li>
353+
<li><a class="el" href="#compat-physics-models" title="Physics Models">Viscosity</a></li>
354354
</ul>
355355
<p></p>
356356
</details>
@@ -372,11 +372,11 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md43"></a>
372372
<li><b>Time stepping:</b> RK3 (SSP)</li>
373373
</ul>
374374
<p><b>Related Documentation:</b></p><ul>
375-
<li>Model Equations (model_eqns = 2)</li>
375+
<li><a class="el" href="#model-equations" title="🔢 Model Equations">Model Equations (model_eqns = 2)</a></li>
376376
</ul>
377377
<p></p>
378378
</details>
379-
<h2 class="doxsection"><a class="anchor" id="autotoc_md44"></a>
379+
<h2 class="doxsection"><a class="anchor" id="common-configuration-patterns"></a>
380380
🚀 Common Configuration Patterns</h2>
381381
<p>Start with these proven combinations:</p>
382382
<details open="true">
@@ -415,10 +415,10 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md44"></a>
415415
<div class="line"><span class="stringliteral">&#39;hypoelasticity&#39;</span>: <span class="stringliteral">&#39;T&#39;</span>, <span class="comment"># Elastic solids</span></div>
416416
<div class="line"><span class="stringliteral">&#39;riemann_solver&#39;</span>: 1, <span class="comment"># HLL</span></div>
417417
</div><!-- fragment --> </details>
418-
<h2 class="doxsection"><a class="anchor" id="autotoc_md45"></a>
418+
<h2 class="doxsection"><a class="anchor" id="feature-compatibility"></a>
419419
📊 Feature Compatibility</h2>
420420
<p>What works together:</p>
421-
<h3 class="doxsection"><a class="anchor" id="autotoc_md46"></a>
421+
<h3 class="doxsection"><a class="anchor" id="compat-physics-models"></a>
422422
Physics Models</h3>
423423
<table class="markdownTable">
424424
<tr class="markdownTableHead">
@@ -438,7 +438,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md46"></a>
438438
<tr class="markdownTableRowOdd">
439439
<td class="markdownTableBodyNone">Acoustic Sources </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">✓ General use </td></tr>
440440
</table>
441-
<h3 class="doxsection"><a class="anchor" id="autotoc_md47"></a>
441+
<h3 class="doxsection"><a class="anchor" id="compat-bubble-models"></a>
442442
Bubble Models</h3>
443443
<table class="markdownTable">
444444
<tr class="markdownTableHead">
@@ -454,7 +454,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md47"></a>
454454
<tr class="markdownTableRowOdd">
455455
<td class="markdownTableBodyNone">adv_n </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">✓ General use </td></tr>
456456
</table>
457-
<h3 class="doxsection"><a class="anchor" id="autotoc_md48"></a>
457+
<h3 class="doxsection"><a class="anchor" id="compat-numerics"></a>
458458
Numerics</h3>
459459
<table class="markdownTable">
460460
<tr class="markdownTableHead">
@@ -466,7 +466,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md48"></a>
466466
<tr class="markdownTableRowOdd">
467467
<td class="markdownTableBodyNone">MUSCL Order </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">✓ General use </td></tr>
468468
</table>
469-
<h3 class="doxsection"><a class="anchor" id="autotoc_md49"></a>
469+
<h3 class="doxsection"><a class="anchor" id="compat-geometry"></a>
470470
Geometry</h3>
471471
<table class="markdownTable">
472472
<tr class="markdownTableHead">
@@ -476,7 +476,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md49"></a>
476476
<tr class="markdownTableRowEven">
477477
<td class="markdownTableBodyNone">Cylindrical Coordinates </td><td class="markdownTableBodyNone"></td><td class="markdownTableBodyNone">✓ General use </td></tr>
478478
</table>
479-
<h2 class="doxsection"><a class="anchor" id="autotoc_md50"></a>
479+
<h2 class="doxsection"><a class="anchor" id="model-equations"></a>
480480
🔢 Model Equations</h2>
481481
<p>Choose your governing equations:</p>
482482
<details >
@@ -521,7 +521,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md50"></a>
521521
<li><b>Requirements:</b> Set <span class="tt">rhoref</span>, Set <span class="tt">pref</span>, <span class="tt">num_fluids</span> = <span class="tt">1</span> (1) </li>
522522
</ul>
523523
</details>
524-
<h2 class="doxsection"><a class="anchor" id="autotoc_md51"></a>
524+
<h2 class="doxsection"><a class="anchor" id="riemann-solvers"></a>
525525
⚙️ Riemann Solvers</h2>
526526
<table class="markdownTable">
527527
<tr class="markdownTableHead">
@@ -537,7 +537,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md51"></a>
537537
<tr class="markdownTableRowOdd">
538538
<td class="markdownTableBodyNone"><b>Lax-Friedrichs</b> </td><td class="markdownTableBodyNone"><span class="tt">5</span> </td><td class="markdownTableBodyNone">Robust fallback </td><td class="markdownTableBodyNone">Not with cylindrical+viscous </td></tr>
539539
</table>
540-
<h2 class="doxsection"><a class="anchor" id="autotoc_md52"></a>
540+
<h2 class="doxsection"><a class="anchor" id="bubble-models"></a>
541541
💧 Bubble Models</h2>
542542
<details >
543543
<summary >
@@ -566,7 +566,7 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md52"></a>
566566
</ul>
567567
<p><b>Note:</b> Tracks individual bubbles </p>
568568
</details>
569-
<h2 class="doxsection"><a class="anchor" id="autotoc_md53"></a>
569+
<h2 class="doxsection"><a class="anchor" id="quick-parameter-reference"></a>
570570
📖 Quick Parameter Reference</h2>
571571
<p>Key parameters and their constraints:</p>
572572
<details >

0 commit comments

Comments
 (0)