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 >
132132Case 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 "> 'hypoelasticity'</ span > : < span class ="stringliteral "> 'T'</ span > , < span class ="comment "> # Elastic solids</ span > </ div >
416416< div class ="line "> < span class ="stringliteral "> 'riemann_solver'</ 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 >
422422Physics 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 >
442442Bubble 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 >
458458Numerics</ 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 >
470470Geometry</ 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