Docs @ ae9105a

Author: MFC Action

documentation/architecture.html

@@ -427,7 +427,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-07-16</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-07-17</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/case.html

@@ -680,7 +680,7 @@ <h2 class="doxsection"><a class="anchor" id="quick-parameter-reference"></a>
 <b>bubble_model</b> (<span class="tt">bubble_model</span>)</summary>
 <p></p>
 <p><b>Schema constraints:</b></p><ul>
-<li>Choices: <span class="tt">1</span> = Gilmore, <span class="tt">2</span> = Keller-Miksis, <span class="tt">3</span> = Rayleigh-Plesset</li>
+<li>Choices: <span class="tt">0</span> = Particle, <span class="tt">1</span> = Gilmore, <span class="tt">2</span> = Keller-Miksis, <span class="tt">3</span> = Rayleigh-Plesset</li>
 </ul>
 <p><b>Incompatibilities</b> (errors):</p><ul>
 <li>The 5-equation bubbly flow model does not support bubble_model = 1 (Gilmore)</li>
@@ -1462,7 +1462,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-07-16</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-07-17</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">

documentation/case_constraints.html

@@ -234,151 +234,171 @@
 <dd><p class="startdd">H.&#160;Guo, P.&#160;Jiang, L.&#160;Ye, and Y.&#160;Zhu. An efficient and low-divergence method for generating inhomogeneous and anisotropic turbulence with arbitrary spectra. <em>Journal of Fluid Mechanics</em>, 970:A2, 2023. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_harten83"></a>[20]</dt>
+<dt><a class="anchor" id="CITEREF_hadamard1911"></a>[20]</dt>
+<dd><p class="startdd">J.&#160;Hadamard. Mouvement permanent lent d&rsquo;une sph&egrave;re liquide et visqueuse dans un liquide visqueux. <em>Comptes Rendus de l&rsquo;Acad&eacute;mie des Sciences</em>, 152:1735&ndash;1738, 1911.</p>
+<p class="enddd"></p>
+</dd>
+<dt><a class="anchor" id="CITEREF_harten83"></a>[21]</dt>
 <dd><p class="startdd">A.&#160;Harten, P.&#160;D. Lax, and B.&#160;van Leer. On upstream differencing and Godunov-type schemes for hyperbolic conservation laws. <em>SIAM Review</em>, 25(1):35&ndash;61, 1983. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_henrick05"></a>[21]</dt>
+<dt><a class="anchor" id="CITEREF_henrick05"></a>[22]</dt>
 <dd><p class="startdd">A.&#160;K. Henrick, T.&#160;D. Aslam, and J.&#160;M. Powers. Mapped weighted essentially non-oscillatory schemes: Achieving optimal order near critical points. <em>Journal of Computational Physics</em>, 207(2):542&ndash;567, 2005. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_jiang96"></a>[22]</dt>
+<dt><a class="anchor" id="CITEREF_jiang96"></a>[23]</dt>
 <dd><p class="startdd">G.-S. Jiang and C.-W. Shu. Efficient implementation of weighted ENO schemes. <em>Journal of Computational Physics</em>, 126(2):202&ndash;228, 1996. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_johnsen08"></a>[23]</dt>
+<dt><a class="anchor" id="CITEREF_johnsen08"></a>[24]</dt>
 <dd><p class="startdd">E.&#160;Johnsen. <em>Numerical simulations of non-spherical bubble collapse: with applications to shockwave lithotripsy</em>. PhD thesis, California Institute of Technology, 2008.</p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_kamrin12"></a>[24]</dt>
+<dt><a class="anchor" id="CITEREF_kamrin12"></a>[25]</dt>
 <dd><p class="startdd">K.&#160;Kamrin, C.&#160;H. Rycroft, and J.-C. Nave. Reference map technique for finite-strain elasticity and fluid-solid interaction. <em>Journal of the Mechanics and Physics of Solids</em>, 60(11):1952&ndash;1969, 2012. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_kapila01"></a>[25]</dt>
+<dt><a class="anchor" id="CITEREF_kapila01"></a>[26]</dt>
 <dd><p class="startdd">A.&#160;K. Kapila, R.&#160;Menikoff, J.&#160;B. Bdzil, S.&#160;F. Son, and D.&#160;S. Stewart. Two-phase modeling of deflagration-to-detonation transition in granular materials: Reduced equations. <em>Physics of Fluids</em>, 13(10):3002&ndash;3024, 2001. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_keller80"></a>[26]</dt>
+<dt><a class="anchor" id="CITEREF_keller80"></a>[27]</dt>
 <dd><p class="startdd">J.&#160;B. Keller and M.&#160;J. Miksis. Bubble oscillations of large amplitude. <em>Journal of the Acoustical Society of America</em>, 68(2):628&ndash;633, 1980. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_lemetayer04"></a>[27]</dt>
+<dt><a class="anchor" id="CITEREF_lemetayer04"></a>[28]</dt>
 <dd><p class="startdd">O.&#160;Le M&eacute;tayer, J.&#160;Massoni, and R.&#160;Saurel. Elaborating equations of state of a liquid and its vapor for two-phase flow models. <em>International Journal of Thermal Sciences</em>, 43(3):265&ndash;276, 2004. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_rayleigh17"></a>[28]</dt>
+<dt><a class="anchor" id="CITEREF_levich1962"></a>[29]</dt>
+<dd><p class="startdd">V.&#160;G. Levich. <em>Physicochemical Hydrodynamics</em>. Prentice-Hall, Englewood Cliffs, NJ, 1962.</p>
+<p class="enddd"></p>
+</dd>
+<dt><a class="anchor" id="CITEREF_rayleigh17"></a>[30]</dt>
 <dd><p class="startdd">Lord Rayleigh. On the pressure developed in a liquid during the collapse of a spherical cavity. <em>Philosophical Magazine</em>, 34(200):94&ndash;98, 1917. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_maeda17"></a>[29]</dt>
+<dt><a class="anchor" id="CITEREF_maeda17"></a>[31]</dt>
 <dd><p class="startdd">K.&#160;Maeda and T.&#160;Colonius. A source term approach for generation of one-way acoustic waves in the Euler and Navier&ndash;Stokes equations. <em>Wave Motion</em>, 75:36&ndash;49, 2017. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_maeda18"></a>[30]</dt>
+<dt><a class="anchor" id="CITEREF_maeda18"></a>[32]</dt>
 <dd><p class="startdd">K.&#160;Maeda and T.&#160;Colonius. Eulerian&ndash;Lagrangian method for simulation of cloud cavitation. <em>Journal of Computational Physics</em>, 371:994&ndash;1017, 2018. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_mcbride93"></a>[31]</dt>
+<dt><a class="anchor" id="CITEREF_magnaudet2000"></a>[33]</dt>
+<dd><p class="startdd">J.&#160;Magnaudet and I.&#160;Eames. The motion of high-Reynolds-number bubbles in inhomogeneous flows. <em>Annual Review of Fluid Mechanics</em>, 32:659&ndash;708, 2000. </p>
+<p class="enddd"></p>
+</dd>
+<dt><a class="anchor" id="CITEREF_mcbride93"></a>[34]</dt>
 <dd><p class="startdd">B.&#160;J. McBride, S.&#160;Gordon, and M.&#160;A. Reno. Coefficients for calculating thermodynamic and transport properties of individual species. Technical Report TM-4513, NASA, 1993.</p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_meng16"></a>[32]</dt>
+<dt><a class="anchor" id="CITEREF_meng16"></a>[35]</dt>
 <dd><p class="startdd">J.&#160;C.&#160;C. Meng. <em>Numerical simulations of droplet aerobreakup</em>. PhD thesis, California Institute of Technology, 2016.</p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_menikoff89"></a>[33]</dt>
+<dt><a class="anchor" id="CITEREF_menikoff89"></a>[36]</dt>
 <dd><p class="startdd">R.&#160;Menikoff and B.&#160;J. Plohr. The Riemann problem for fluid flow of real materials. <em>Reviews of Modern Physics</em>, 61(1):75&ndash;130, 1989. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_mittal05"></a>[34]</dt>
+<dt><a class="anchor" id="CITEREF_mittal05"></a>[37]</dt>
 <dd><p class="startdd">R.&#160;Mittal and G.&#160;Iaccarino. Immersed boundary methods. <em>Annual Review of Fluid Mechanics</em>, 37:239&ndash;261, 2005. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_miyoshi05"></a>[35]</dt>
+<dt><a class="anchor" id="CITEREF_miyoshi05"></a>[38]</dt>
 <dd><p class="startdd">T.&#160;Miyoshi and K.&#160;Kusano. A multi-state HLL approximate Riemann solver for ideal magnetohydrodynamics. <em>Journal of Computational Physics</em>, 208(1):315&ndash;344, 2005. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_papanastasiou87"></a>[36]</dt>
+<dt><a class="anchor" id="CITEREF_papanastasiou87"></a>[39]</dt>
 <dd><p class="startdd">Tasos&#160;C. Papanastasiou. Flows of materials with yield. <em>Journal of Rheology</em>, 31(5):385&ndash;404, 1987. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_pirozzoli13"></a>[37]</dt>
+<dt><a class="anchor" id="CITEREF_pirozzoli13"></a>[40]</dt>
 <dd><p class="startdd">S.&#160;Pirozzoli and T.&#160;Colonius. Generalized characteristic relaxation boundary conditions for unsteady compressible flow simulations. <em>Journal of Computational Physics</em>, 248:109&ndash;126, 2013. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_plesset49"></a>[38]</dt>
+<dt><a class="anchor" id="CITEREF_plesset49"></a>[41]</dt>
 <dd><p class="startdd">M.&#160;S. Plesset. The dynamics of cavitation bubbles. <em>Journal of Applied Mechanics</em>, 16:277&ndash;282, 1949. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_preston07"></a>[39]</dt>
+<dt><a class="anchor" id="CITEREF_preston07"></a>[42]</dt>
 <dd><p class="startdd">A.&#160;T. Preston, T.&#160;Colonius, and C.&#160;E. Brennen. A reduced-order model of diffusive effects on the dynamics of bubbles. <em>Physics of Fluids</em>, 19(12):123302, 2007. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_rodriguez19"></a>[40]</dt>
+<dt><a class="anchor" id="CITEREF_rodriguez19"></a>[43]</dt>
 <dd><p class="startdd">M.&#160;Rodriguez and E.&#160;Johnsen. A high-order accurate five-equations compressible multiphase approach for viscoelastic fluids and solids with relaxation and elasticity. <em>Journal of Computational Physics</em>, 379:70&ndash;90, 2019. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_saurel08"></a>[41]</dt>
+<dt><a class="anchor" id="CITEREF_rybczynski1911"></a>[44]</dt>
+<dd><p class="startdd">W.&#160;Rybczynski. &Uuml;ber die fortschreitende bewegung einer fl&uuml;ssigen kugel in einem z&auml;hen medium. <em>Bulletin International de l&rsquo;Acad&eacute;mie des Sciences de Cracovie, S&eacute;rie A</em>, pages 40&ndash;46, 1911.</p>
+<p class="enddd"></p>
+</dd>
+<dt><a class="anchor" id="CITEREF_saurel08"></a>[45]</dt>
 <dd><p class="startdd">R.&#160;Saurel, F.&#160;Petitpas, and R.&#160;Abgrall. Modelling phase transition in metastable liquids: application to cavitating and flashing flows. <em>Journal of Fluid Mechanics</em>, 607:313&ndash;350, 2008. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_saurel09"></a>[42]</dt>
+<dt><a class="anchor" id="CITEREF_saurel09"></a>[46]</dt>
 <dd><p class="startdd">R.&#160;Saurel, F.&#160;Petitpas, and R.&#160;A. Berry. Simple and efficient relaxation methods for interfaces separating compressible fluids, cavitating flows and shocks in multiphase mixtures. <em>Journal of Computational Physics</em>, 228(5):1678&ndash;1712, 2009. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_schmidmayer17"></a>[43]</dt>
+<dt><a class="anchor" id="CITEREF_schmidmayer17"></a>[47]</dt>
 <dd><p class="startdd">K.&#160;Schmidmayer, F.&#160;Petitpas, E.&#160;Daniel, N.&#160;Favrie, and S.&#160;L. Gavrilyuk. A model and numerical method for compressible flows with capillary effects. <em>Journal of Computational Physics</em>, 334:468&ndash;496, 2017. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_schmidmayer20"></a>[44]</dt>
+<dt><a class="anchor" id="CITEREF_schmidmayer20"></a>[48]</dt>
 <dd><p class="startdd">K.&#160;Schmidmayer, S.&#160;H. Bryngelson, and T.&#160;Colonius. An assessment of multicomponent flow models and interface capturing schemes for spherical bubble dynamics. <em>Journal of Computational Physics</em>, 402:109080, 2020. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_strang68"></a>[45]</dt>
+<dt><a class="anchor" id="CITEREF_stokes1851"></a>[49]</dt>
+<dd><p class="startdd">G.&#160;G. Stokes. On the effect of the internal friction of fluids on the motion of pendulums. <em>Transactions of the Cambridge Philosophical Society</em>, 9:8&ndash;106, 1851.</p>
+<p class="enddd"></p>
+</dd>
+<dt><a class="anchor" id="CITEREF_strang68"></a>[50]</dt>
 <dd><p class="startdd">G.&#160;Strang. On the construction and comparison of difference schemes. <em>SIAM Journal on Numerical Analysis</em>, 5(3):506&ndash;517, 1968. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_suresh97"></a>[46]</dt>
+<dt><a class="anchor" id="CITEREF_suresh97"></a>[51]</dt>
 <dd><p class="startdd">A.&#160;Suresh and H.&#160;Huynh. Accurate monotonicity-preserving schemes with Runge&ndash;Kutta time stepping. <em>Journal of Computational Physics</em>, 136(1):83&ndash;99, 1997. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_tam05"></a>[47]</dt>
+<dt><a class="anchor" id="CITEREF_tam05"></a>[52]</dt>
 <dd><p class="startdd">C.&#160;K. Tam, H.&#160;Ju, M.&#160;G. Jones, W.&#160;R. Watson, and T.&#160;L. Parrott. A computational and experimental study of slit resonators. <em>Journal of Sound and Vibration</em>, 284(3&ndash;5):947&ndash;984, 2005. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_thompson87"></a>[48]</dt>
+<dt><a class="anchor" id="CITEREF_thompson87"></a>[53]</dt>
 <dd><p class="startdd">K.&#160;W. Thompson. Time dependent boundary conditions for hyperbolic systems. <em>Journal of Computational Physics</em>, 68(1):1&ndash;24, 1987. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_thompson90"></a>[49]</dt>
+<dt><a class="anchor" id="CITEREF_thompson90"></a>[54]</dt>
 <dd><p class="startdd">K.&#160;W. Thompson. Time-dependent boundary conditions for hyperbolic systems, II. <em>Journal of Computational Physics</em>, 89(2):439&ndash;461, 1990. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_thornber08"></a>[50]</dt>
+<dt><a class="anchor" id="CITEREF_thornber08"></a>[55]</dt>
 <dd><p class="startdd">B.&#160;Thornber, A.&#160;Mosedale, D.&#160;Drikakis, D.&#160;Youngs, and R.&#160;J.&#160;R. Williams. An improved reconstruction method for compressible flows with low Mach number features. <em>Journal of Computational Physics</em>, 227(10):4873&ndash;4894, 2008. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_toro94"></a>[51]</dt>
+<dt><a class="anchor" id="CITEREF_toro94"></a>[56]</dt>
 <dd><p class="startdd">E.&#160;F. Toro, M.&#160;Spruce, and W.&#160;Speares. Restoration of the contact surface in the HLL-Riemann solver. <em>Shock Waves</em>, 4:25&ndash;34, 1994. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_toro09"></a>[52]</dt>
+<dt><a class="anchor" id="CITEREF_toro09"></a>[57]</dt>
 <dd><p class="startdd">E.&#160;F. Toro. <em>Riemann Solvers and Numerical Methods for Fluid Dynamics: A Practical Introduction</em>. Springer, 3rd edition, 2009. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_tseng03"></a>[53]</dt>
+<dt><a class="anchor" id="CITEREF_tseng03"></a>[58]</dt>
 <dd><p class="startdd">Y.&#160;H. Tseng and J.&#160;H. Ferziger. A ghost-cell immersed boundary method for flow in complex geometry. <em>Journal of Computational Physics</em>, 192(2):593&ndash;623, 2003. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_wilfong25a"></a>[54]</dt>
+<dt><a class="anchor" id="CITEREF_wilfong25a"></a>[59]</dt>
 <dd><p class="startdd">B.&#160;Wilfong, A.&#160;Radhakrishnan, H.&#160;Le Berre, D.&#160;J. Vickers, T.&#160;Prathi, N.&#160;Tselepidis, B.&#160;Dorschner, R.&#160;Budiardja, B.&#160;Cornille, S.&#160;Abbott, F.&#160;Sch&auml;fer, and S.&#160;H. Bryngelson. Simulating many-engine spacecraft: Exceeding 1 quadrillion degrees of freedom via information geometric regularization. In <em>SC&rsquo;25: Proceedings of the International Conference for High Performance Computing, Networking, Storage and Analysis</em>, pages 14&ndash;24, 2025. *Equal contribution. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_wilfong26"></a>[55]</dt>
+<dt><a class="anchor" id="CITEREF_wilfong26"></a>[60]</dt>
 <dd><p class="startdd">B.&#160;Wilfong, H.&#160;Le Berre, A.&#160;Radhakrishnan, A.&#160;Gupta, D.&#160;J. Vickers, D.&#160;Vaca-Revelo, D.&#160;Adam, H.&#160;Yu, H.&#160;Lee, J.&#160;R. Chreim, M.&#160;Carcana Barbosa, Y.&#160;Zhang, E.&#160;Cisneros-Garibay, A.&#160;Gnanaskandan, M.&#160;Rodriguez Jr., R.&#160;D. Budiardja, S.&#160;Abbott, T.&#160;Colonius, and S.&#160;H. Bryngelson. MFC 5.0: An exascale many-physics flow solver. <em>Computer Physics Communications</em>, 322:110055, 2026. </p>
 <p class="enddd"></p>
 </dd>
-<dt><a class="anchor" id="CITEREF_zein10"></a>[56]</dt>
+<dt><a class="anchor" id="CITEREF_zein10"></a>[61]</dt>
 <dd><p class="startdd">A.&#160;Zein, M.&#160;Hantke, and G.&#160;Warnecke. Modeling phase transition for compressible two-phase flows applied to metastable liquids. <em>Journal of Computational Physics</em>, 229(8):2964&ndash;2998, 2010. </p>
 <p class="enddd"></p>
 </dd>

documentation/citelist.html

@@ -999,7 +999,7 @@ <h3 class="doxsection"><a class="anchor" id="autotoc_md82"></a>
 <h3 class="doxsection"><a class="anchor" id="autotoc_md83"></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-07-16</div> </div></div><!-- contents -->
+<div style="text-align:center; font-size:0.75rem; color:#888; padding:16px 0 0;">Page last updated: 2026-07-17</div> </div></div><!-- contents -->
 </div><!-- PageDoc -->
 </div><!-- doc-content -->
 <div id="page-nav" class="page-nav-panel">