Docs @ 4c52155

Author: MFC Action

documentation/case.html

@@ -475,6 +475,14 @@ <h3 class="doxsection"><a class="anchor" id="sec-fluid-materials"></a>
 <li><span class="tt">fluid_pp(i)%cv</span>, <span class="tt">fluid_pp(i)%qv</span>, and <span class="tt">fluid_pp(i)%qvp</span> define $c_v$, $q$, and $q'$ as parameters of $i$-th fluid that are used in stiffened gas equation of state.</li>
 <li><span class="tt">fluid_pp(i)%G</span> is required for <span class="tt">hypoelasticity</span>.</li>
 </ul>
+<blockquote class="doxtable">
+<p><b>Stored-form parameters:</b> The values <span class="tt">gamma</span>, <span class="tt">pi_inf</span>, and <span class="tt">Re(1)</span>/<span class="tt">Re(2)</span> are <b>not</b> the raw physical quantities. MFC expects transformed stored forms:</p><ul>
+<li><span class="tt">gamma</span> = \(1/(\gamma-1)\), not \(\gamma\) itself</li>
+<li><span class="tt">pi_inf</span> = \(\gamma\,\pi_\infty / (\gamma - 1)\), not \(\pi_\infty\) itself</li>
+<li><span class="tt">Re(1)</span> = \(1/\mu\) (inverse viscosity), not \(\mu\) itself</li>
+</ul>
+<p>Setting <span class="tt">gamma = 1.4</span> for air is a common mistake; the correct value is <span class="tt">1.0 / (1.4 - 1.0) = 2.5</span>. See <a class="el" href="equations.html#sec-stored-forms" title="Stored Parameter Conventions">Stored Parameter Conventions</a> and <a class="el" href="equations.html#sec-material-values" title="Common Material Values">Common Material Values</a> in the Equations reference for the full table. </p>
+</blockquote>
 <h3 class="doxsection"><a class="anchor" id="sec-simulation-algorithm"></a>
 6. Simulation Algorithm</h3>
 <p>See <a class="el" href="equations.html" title="Equations">Equations</a> for the mathematical models these parameters control.</p>

documentation/doxygen_crawl.html

@@ -169,16 +169,15 @@
 <a href="equations.html"/>
 <a href="equations.html#autotoc_md121"/>
 <a href="equations.html#autotoc_md123"/>
-<a href="equations.html#autotoc_md125"/>
 <a href="equations.html#autotoc_md126"/>
 <a href="equations.html#autotoc_md127"/>
 <a href="equations.html#autotoc_md128"/>
-<a href="equations.html#autotoc_md130"/>
+<a href="equations.html#autotoc_md129"/>
 <a href="equations.html#autotoc_md131"/>
 <a href="equations.html#autotoc_md132"/>
-<a href="equations.html#autotoc_md134"/>
-<a href="equations.html#autotoc_md136"/>
-<a href="equations.html#autotoc_md138"/>
+<a href="equations.html#autotoc_md133"/>
+<a href="equations.html#autotoc_md135"/>
+<a href="equations.html#autotoc_md137"/>
 <a href="equations.html#autotoc_md139"/>
 <a href="equations.html#autotoc_md140"/>
 <a href="equations.html#autotoc_md141"/>
@@ -187,21 +186,21 @@
 <a href="equations.html#autotoc_md144"/>
 <a href="equations.html#autotoc_md145"/>
 <a href="equations.html#autotoc_md146"/>
-<a href="equations.html#autotoc_md148"/>
+<a href="equations.html#autotoc_md147"/>
 <a href="equations.html#autotoc_md149"/>
 <a href="equations.html#autotoc_md150"/>
-<a href="equations.html#autotoc_md152"/>
+<a href="equations.html#autotoc_md151"/>
 <a href="equations.html#autotoc_md153"/>
 <a href="equations.html#autotoc_md154"/>
-<a href="equations.html#autotoc_md156"/>
-<a href="equations.html#autotoc_md158"/>
-<a href="equations.html#autotoc_md160"/>
+<a href="equations.html#autotoc_md155"/>
+<a href="equations.html#autotoc_md157"/>
+<a href="equations.html#autotoc_md159"/>
 <a href="equations.html#autotoc_md161"/>
 <a href="equations.html#autotoc_md162"/>
-<a href="equations.html#autotoc_md164"/>
-<a href="equations.html#autotoc_md166"/>
-<a href="equations.html#autotoc_md168"/>
-<a href="equations.html#autotoc_md170"/>
+<a href="equations.html#autotoc_md163"/>
+<a href="equations.html#autotoc_md165"/>
+<a href="equations.html#autotoc_md167"/>
+<a href="equations.html#autotoc_md169"/>
 <a href="equations.html#autotoc_md171"/>
 <a href="equations.html#autotoc_md172"/>
 <a href="equations.html#autotoc_md173"/>
@@ -217,14 +216,28 @@
 <a href="equations.html#autotoc_md183"/>
 <a href="equations.html#autotoc_md184"/>
 <a href="equations.html#autotoc_md185"/>
-<a href="equations.html#autotoc_md187"/>
+<a href="equations.html#autotoc_md186"/>
 <a href="equations.html#autotoc_md188"/>
 <a href="equations.html#autotoc_md189"/>
 <a href="equations.html#autotoc_md190"/>
-<a href="equations.html#autotoc_md192"/>
-<a href="equations.html#autotoc_md194"/>
+<a href="equations.html#autotoc_md191"/>
+<a href="equations.html#autotoc_md193"/>
+<a href="equations.html#autotoc_md195"/>
+<a href="equations.html#sec-bubble-example"/>
+<a href="equations.html#sec-bubble-nondim"/>
+<a href="equations.html#sec-dimensional-handling"/>
+<a href="equations.html#sec-dimensions-in-out"/>
+<a href="equations.html#sec-flow-params-bubbles"/>
+<a href="equations.html#sec-material-values"/>
+<a href="equations.html#sec-nondim-bubble-dynamics"/>
+<a href="equations.html#sec-nondim-example"/>
+<a href="equations.html#sec-nondim-inputs"/>
+<a href="equations.html#sec-reference-scales"/>
+<a href="equations.html#sec-stored-forms"/>
+<a href="equations.html#sec-two-viscosities"/>
+<a href="equations.html#sec-unit-consistency"/>
+<a href="equations.html#sec-units-dimensions"/>
 <a href="examples.html"/>
-<a href="examples.html#autotoc_md195"/>
 <a href="examples.html#autotoc_md196"/>
 <a href="examples.html#autotoc_md197"/>
 <a href="examples.html#autotoc_md198"/>
@@ -287,15 +300,15 @@
 <a href="examples.html#autotoc_md255"/>
 <a href="examples.html#autotoc_md256"/>
 <a href="examples.html#autotoc_md257"/>
+<a href="examples.html#autotoc_md258"/>
 <a href="expectedPerformance.html"/>
-<a href="expectedPerformance.html#autotoc_md258"/>
-<a href="expectedPerformance.html#autotoc_md260"/>
+<a href="expectedPerformance.html#autotoc_md259"/>
 <a href="expectedPerformance.html#autotoc_md261"/>
 <a href="expectedPerformance.html#autotoc_md262"/>
 <a href="expectedPerformance.html#autotoc_md263"/>
 <a href="expectedPerformance.html#autotoc_md264"/>
 <a href="expectedPerformance.html#autotoc_md265"/>
-<a href="expectedPerformance.html#autotoc_md267"/>
+<a href="expectedPerformance.html#autotoc_md266"/>
 <a href="expectedPerformance.html#autotoc_md268"/>
 <a href="expectedPerformance.html#autotoc_md269"/>
 <a href="expectedPerformance.html#autotoc_md270"/>
@@ -306,8 +319,8 @@
 <a href="expectedPerformance.html#autotoc_md275"/>
 <a href="expectedPerformance.html#autotoc_md276"/>
 <a href="expectedPerformance.html#autotoc_md277"/>
+<a href="expectedPerformance.html#autotoc_md278"/>
 <a href="getting-started.html"/>
-<a href="getting-started.html#autotoc_md278"/>
 <a href="getting-started.html#autotoc_md279"/>
 <a href="getting-started.html#autotoc_md280"/>
 <a href="getting-started.html#autotoc_md281"/>
@@ -319,17 +332,17 @@
 <a href="getting-started.html#autotoc_md287"/>
 <a href="getting-started.html#autotoc_md288"/>
 <a href="getting-started.html#autotoc_md289"/>
+<a href="getting-started.html#autotoc_md290"/>
+<a href="getting-started.html#autotoc_md291"/>
 <a href="gpuParallelization.html"/>
-<a href="gpuParallelization.html#autotoc_md290"/>
 <a href="gpuParallelization.html#autotoc_md292"/>
-<a href="gpuParallelization.html#autotoc_md293"/>
 <a href="gpuParallelization.html#autotoc_md294"/>
+<a href="gpuParallelization.html#autotoc_md295"/>
 <a href="gpuParallelization.html#autotoc_md296"/>
 <a href="gpuParallelization.html#autotoc_md298"/>
 <a href="gpuParallelization.html#autotoc_md300"/>
 <a href="gpuParallelization.html#autotoc_md302"/>
 <a href="gpuParallelization.html#autotoc_md304"/>
-<a href="gpuParallelization.html#autotoc_md305"/>
 <a href="gpuParallelization.html#autotoc_md306"/>
 <a href="gpuParallelization.html#autotoc_md307"/>
 <a href="gpuParallelization.html#autotoc_md308"/>
@@ -339,25 +352,26 @@
 <a href="gpuParallelization.html#autotoc_md312"/>
 <a href="gpuParallelization.html#autotoc_md313"/>
 <a href="gpuParallelization.html#autotoc_md314"/>
+<a href="gpuParallelization.html#autotoc_md315"/>
+<a href="gpuParallelization.html#autotoc_md316"/>
 <a href="graph_legend.html"/>
 <a href="index.html"/>
-<a href="index.html#autotoc_md425"/>
-<a href="index.html#autotoc_md426"/>
 <a href="index.html#autotoc_md427"/>
 <a href="index.html#autotoc_md428"/>
 <a href="index.html#autotoc_md429"/>
 <a href="index.html#autotoc_md430"/>
+<a href="index.html#autotoc_md431"/>
+<a href="index.html#autotoc_md432"/>
 <a href="pages.html"/>
 <a href="papers.html"/>
-<a href="papers.html#autotoc_md315"/>
+<a href="papers.html#autotoc_md317"/>
 <a href="parameters.html"/>
 <a href="parameters.html#acoustic"/>
 <a href="parameters.html#alpha_rho_e_wrt"/>
 <a href="parameters.html#alpha_rho_wrt"/>
 <a href="parameters.html#alpha_wrt"/>
-<a href="parameters.html#autotoc_md316"/>
-<a href="parameters.html#autotoc_md317"/>
 <a href="parameters.html#autotoc_md318"/>
+<a href="parameters.html#autotoc_md319"/>
 <a href="parameters.html#autotoc_md320"/>
 <a href="parameters.html#autotoc_md322"/>
 <a href="parameters.html#autotoc_md324"/>
@@ -370,17 +384,18 @@
 <a href="parameters.html#autotoc_md338"/>
 <a href="parameters.html#autotoc_md340"/>
 <a href="parameters.html#autotoc_md342"/>
-<a href="parameters.html#autotoc_md346"/>
+<a href="parameters.html#autotoc_md344"/>
 <a href="parameters.html#autotoc_md348"/>
 <a href="parameters.html#autotoc_md350"/>
 <a href="parameters.html#autotoc_md352"/>
 <a href="parameters.html#autotoc_md354"/>
 <a href="parameters.html#autotoc_md356"/>
-<a href="parameters.html#autotoc_md359"/>
+<a href="parameters.html#autotoc_md358"/>
 <a href="parameters.html#autotoc_md361"/>
 <a href="parameters.html#autotoc_md363"/>
 <a href="parameters.html#autotoc_md365"/>
-<a href="parameters.html#autotoc_md374"/>
+<a href="parameters.html#autotoc_md367"/>
+<a href="parameters.html#autotoc_md376"/>
 <a href="parameters.html#bc_x"/>
 <a href="parameters.html#bc_y"/>
 <a href="parameters.html#bc_z"/>
@@ -410,122 +425,122 @@
 <a href="parameters.html#z_domain"/>
 <a href="parameters.html#z_output"/>
 <a href="physics_constraints.html"/>
-<a href="physics_constraints.html#autotoc_md375"/>
 <a href="physics_constraints.html#autotoc_md377"/>
-<a href="physics_constraints.html#autotoc_md378"/>
 <a href="physics_constraints.html#autotoc_md379"/>
 <a href="physics_constraints.html#autotoc_md380"/>
+<a href="physics_constraints.html#autotoc_md381"/>
 <a href="physics_constraints.html#autotoc_md382"/>
-<a href="physics_constraints.html#autotoc_md383"/>
 <a href="physics_constraints.html#autotoc_md384"/>
+<a href="physics_constraints.html#autotoc_md385"/>
 <a href="physics_constraints.html#autotoc_md386"/>
-<a href="physics_constraints.html#autotoc_md387"/>
 <a href="physics_constraints.html#autotoc_md388"/>
 <a href="physics_constraints.html#autotoc_md389"/>
+<a href="physics_constraints.html#autotoc_md390"/>
 <a href="physics_constraints.html#autotoc_md391"/>
-<a href="physics_constraints.html#autotoc_md392"/>
+<a href="physics_constraints.html#autotoc_md393"/>
 <a href="physics_constraints.html#autotoc_md394"/>
-<a href="physics_constraints.html#autotoc_md395"/>
+<a href="physics_constraints.html#autotoc_md396"/>
 <a href="physics_constraints.html#autotoc_md397"/>
-<a href="physics_constraints.html#autotoc_md398"/>
+<a href="physics_constraints.html#autotoc_md399"/>
 <a href="physics_constraints.html#autotoc_md400"/>
-<a href="physics_constraints.html#autotoc_md401"/>
 <a href="physics_constraints.html#autotoc_md402"/>
 <a href="physics_constraints.html#autotoc_md403"/>
+<a href="physics_constraints.html#autotoc_md404"/>
 <a href="physics_constraints.html#autotoc_md405"/>
-<a href="physics_constraints.html#autotoc_md406"/>
 <a href="physics_constraints.html#autotoc_md407"/>
 <a href="physics_constraints.html#autotoc_md408"/>
 <a href="physics_constraints.html#autotoc_md409"/>
 <a href="physics_constraints.html#autotoc_md410"/>
 <a href="physics_constraints.html#autotoc_md411"/>
+<a href="physics_constraints.html#autotoc_md412"/>
 <a href="physics_constraints.html#autotoc_md413"/>
-<a href="physics_constraints.html#autotoc_md414"/>
 <a href="physics_constraints.html#autotoc_md415"/>
 <a href="physics_constraints.html#autotoc_md416"/>
 <a href="physics_constraints.html#autotoc_md417"/>
+<a href="physics_constraints.html#autotoc_md418"/>
 <a href="physics_constraints.html#autotoc_md419"/>
-<a href="physics_constraints.html#autotoc_md420"/>
+<a href="physics_constraints.html#autotoc_md421"/>
 <a href="physics_constraints.html#autotoc_md422"/>
-<a href="physics_constraints.html#autotoc_md423"/>
 <a href="physics_constraints.html#autotoc_md424"/>
+<a href="physics_constraints.html#autotoc_md425"/>
+<a href="physics_constraints.html#autotoc_md426"/>
 <a href="running.html"/>
-<a href="running.html#autotoc_md431"/>
-<a href="running.html#autotoc_md432"/>
+<a href="running.html#autotoc_md433"/>
 <a href="running.html#autotoc_md434"/>
 <a href="running.html#autotoc_md436"/>
-<a href="running.html#autotoc_md437"/>
 <a href="running.html#autotoc_md438"/>
 <a href="running.html#autotoc_md439"/>
 <a href="running.html#autotoc_md440"/>
 <a href="running.html#autotoc_md441"/>
 <a href="running.html#autotoc_md442"/>
 <a href="running.html#autotoc_md443"/>
 <a href="running.html#autotoc_md444"/>
+<a href="running.html#autotoc_md445"/>
 <a href="running.html#autotoc_md446"/>
-<a href="running.html#autotoc_md447"/>
 <a href="running.html#autotoc_md448"/>
 <a href="running.html#autotoc_md449"/>
 <a href="running.html#autotoc_md450"/>
 <a href="running.html#autotoc_md451"/>
+<a href="running.html#autotoc_md452"/>
 <a href="running.html#autotoc_md453"/>
 <a href="running.html#autotoc_md455"/>
+<a href="running.html#autotoc_md457"/>
 <a href="testing.html"/>
-<a href="testing.html#autotoc_md456"/>
-<a href="testing.html#autotoc_md457"/>
 <a href="testing.html#autotoc_md458"/>
+<a href="testing.html#autotoc_md459"/>
+<a href="testing.html#autotoc_md460"/>
 <a href="troubleshooting.html"/>
-<a href="troubleshooting.html#autotoc_md459"/>
-<a href="troubleshooting.html#autotoc_md460"/>
 <a href="troubleshooting.html#autotoc_md461"/>
 <a href="troubleshooting.html#autotoc_md462"/>
 <a href="troubleshooting.html#autotoc_md463"/>
+<a href="troubleshooting.html#autotoc_md464"/>
 <a href="troubleshooting.html#autotoc_md465"/>
-<a href="troubleshooting.html#autotoc_md466"/>
 <a href="troubleshooting.html#autotoc_md467"/>
 <a href="troubleshooting.html#autotoc_md468"/>
+<a href="troubleshooting.html#autotoc_md469"/>
 <a href="troubleshooting.html#autotoc_md470"/>
-<a href="troubleshooting.html#autotoc_md471"/>
 <a href="troubleshooting.html#autotoc_md472"/>
 <a href="troubleshooting.html#autotoc_md473"/>
 <a href="troubleshooting.html#autotoc_md474"/>
 <a href="troubleshooting.html#autotoc_md475"/>
+<a href="troubleshooting.html#autotoc_md476"/>
 <a href="troubleshooting.html#autotoc_md477"/>
-<a href="troubleshooting.html#autotoc_md478"/>
 <a href="troubleshooting.html#autotoc_md479"/>
 <a href="troubleshooting.html#autotoc_md480"/>
 <a href="troubleshooting.html#autotoc_md481"/>
+<a href="troubleshooting.html#autotoc_md482"/>
 <a href="troubleshooting.html#autotoc_md483"/>
-<a href="troubleshooting.html#autotoc_md484"/>
 <a href="troubleshooting.html#autotoc_md485"/>
 <a href="troubleshooting.html#autotoc_md486"/>
 <a href="troubleshooting.html#autotoc_md487"/>
 <a href="troubleshooting.html#autotoc_md488"/>
+<a href="troubleshooting.html#autotoc_md489"/>
 <a href="troubleshooting.html#autotoc_md490"/>
-<a href="troubleshooting.html#autotoc_md491"/>
 <a href="troubleshooting.html#autotoc_md492"/>
 <a href="troubleshooting.html#autotoc_md493"/>
+<a href="troubleshooting.html#autotoc_md494"/>
 <a href="troubleshooting.html#autotoc_md495"/>
-<a href="troubleshooting.html#autotoc_md496"/>
 <a href="troubleshooting.html#autotoc_md497"/>
 <a href="troubleshooting.html#autotoc_md498"/>
 <a href="troubleshooting.html#autotoc_md499"/>
 <a href="troubleshooting.html#autotoc_md500"/>
+<a href="troubleshooting.html#autotoc_md501"/>
 <a href="troubleshooting.html#autotoc_md502"/>
-<a href="troubleshooting.html#autotoc_md503"/>
 <a href="troubleshooting.html#autotoc_md504"/>
 <a href="troubleshooting.html#autotoc_md505"/>
 <a href="troubleshooting.html#autotoc_md506"/>
+<a href="troubleshooting.html#autotoc_md507"/>
 <a href="troubleshooting.html#autotoc_md508"/>
+<a href="troubleshooting.html#autotoc_md510"/>
 <a href="visualization.html"/>
-<a href="visualization.html#autotoc_md509"/>
-<a href="visualization.html#autotoc_md510"/>
 <a href="visualization.html#autotoc_md511"/>
 <a href="visualization.html#autotoc_md512"/>
 <a href="visualization.html#autotoc_md513"/>
 <a href="visualization.html#autotoc_md514"/>
 <a href="visualization.html#autotoc_md515"/>
 <a href="visualization.html#autotoc_md516"/>
 <a href="visualization.html#autotoc_md517"/>
+<a href="visualization.html#autotoc_md518"/>
+<a href="visualization.html#autotoc_md519"/>
 </body>
 </html>