Skip to content

Commit bc40322

Browse files
author
MFC Action
committed
Docs @ d8dec27
1 parent 6478002 commit bc40322

File tree

634 files changed

+24438
-9330
lines changed

Some content is hidden

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

634 files changed

+24438
-9330
lines changed

documentation/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@
122122
</div><!--header-->
123123
<div class="contents">
124124
<div class="textblock"><p><a class="anchor" id="md_readme"></a> </p>
125-
<h1><a class="anchor" id="autotoc_md76"></a>
125+
<h1><a class="anchor" id="autotoc_md77"></a>
126126
User Documentation</h1>
127127
<ul>
128128
<li><a class="el" href="md_getting-started.html">Getting Started</a></li>
@@ -135,7 +135,7 @@ <h1><a class="anchor" id="autotoc_md76"></a>
135135
<li><a class="el" href="md_authors.html">MFC's Authors</a></li>
136136
<li><a class="el" href="md_references.html">References</a></li>
137137
</ul>
138-
<h1><a class="anchor" id="autotoc_md77"></a>
138+
<h1><a class="anchor" id="autotoc_md78"></a>
139139
Code/API Documentation</h1>
140140
<p>MFC's three codes have their own documentation:</p>
141141
<ul>

documentation/index.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
var index =
22
[
3-
[ "User Documentation", "index.html#autotoc_md76", null ],
4-
[ "Code/API Documentation", "index.html#autotoc_md77", null ]
3+
[ "User Documentation", "index.html#autotoc_md77", null ],
4+
[ "Code/API Documentation", "index.html#autotoc_md78", null ]
55
];

documentation/md_CODE__OF__CONDUCT.html

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -121,12 +121,12 @@
121121
<div class="headertitle"><div class="title">Contributor Covenant Code of Conduct</div></div>
122122
</div><!--header-->
123123
<div class="contents">
124-
<div class="textblock"><p><a class="anchor" id="autotoc_md23"></a> </p>
125-
<h1><a class="anchor" id="autotoc_md24"></a>
124+
<div class="textblock"><p><a class="anchor" id="autotoc_md24"></a> </p>
125+
<h1><a class="anchor" id="autotoc_md25"></a>
126126
Our Pledge</h1>
127127
<p>We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.</p>
128128
<p>We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.</p>
129-
<h1><a class="anchor" id="autotoc_md25"></a>
129+
<h1><a class="anchor" id="autotoc_md26"></a>
130130
Our Standards</h1>
131131
<p>Examples of behavior that contributes to a positive environment for our community include:</p>
132132
<ul>
@@ -144,37 +144,37 @@ <h1><a class="anchor" id="autotoc_md25"></a>
144144
<li>Publishing others' private information, such as a physical or email address, without their explicit permission</li>
145145
<li>Other conduct which could reasonably be considered inappropriate in a professional setting</li>
146146
</ul>
147-
<h1><a class="anchor" id="autotoc_md26"></a>
147+
<h1><a class="anchor" id="autotoc_md27"></a>
148148
Enforcement Responsibilities</h1>
149149
<p>Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.</p>
150150
<p>Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.</p>
151-
<h1><a class="anchor" id="autotoc_md27"></a>
151+
<h1><a class="anchor" id="autotoc_md28"></a>
152152
Scope</h1>
153153
<p>This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.</p>
154-
<h1><a class="anchor" id="autotoc_md28"></a>
154+
<h1><a class="anchor" id="autotoc_md29"></a>
155155
Enforcement</h1>
156156
<p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at <a href="#" onclick="location.href='mai'+'lto:'+'shb'+'@g'+'ate'+'ch'+'.ed'+'u'; return false;">shb@g<span class="obfuscator">.nosp@m.</span>atec<span class="obfuscator">.nosp@m.</span>h.edu</a>. All complaints will be reviewed and investigated promptly and fairly.</p>
157157
<p>All community leaders are obligated to respect the privacy and security of the reporter of any incident.</p>
158-
<h1><a class="anchor" id="autotoc_md29"></a>
158+
<h1><a class="anchor" id="autotoc_md30"></a>
159159
Enforcement Guidelines</h1>
160160
<p>Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:</p>
161-
<h2><a class="anchor" id="autotoc_md30"></a>
161+
<h2><a class="anchor" id="autotoc_md31"></a>
162162
1. Correction</h2>
163163
<p><b>Community Impact</b>: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.</p>
164164
<p><b>Consequence</b>: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.</p>
165-
<h2><a class="anchor" id="autotoc_md31"></a>
165+
<h2><a class="anchor" id="autotoc_md32"></a>
166166
2. Warning</h2>
167167
<p><b>Community Impact</b>: A violation through a single incident or series of actions.</p>
168168
<p><b>Consequence</b>: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.</p>
169-
<h2><a class="anchor" id="autotoc_md32"></a>
169+
<h2><a class="anchor" id="autotoc_md33"></a>
170170
3. Temporary Ban</h2>
171171
<p><b>Community Impact</b>: A serious violation of community standards, including sustained inappropriate behavior.</p>
172172
<p><b>Consequence</b>: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.</p>
173-
<h2><a class="anchor" id="autotoc_md33"></a>
173+
<h2><a class="anchor" id="autotoc_md34"></a>
174174
4. Permanent Ban</h2>
175175
<p><b>Community Impact</b>: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.</p>
176176
<p><b>Consequence</b>: A permanent ban from any sort of public interaction within the community.</p>
177-
<h1><a class="anchor" id="autotoc_md34"></a>
177+
<h1><a class="anchor" id="autotoc_md35"></a>
178178
Attribution</h1>
179179
<p>This Code of Conduct is adapted from the <a href="https://www.contributor-covenant.org">Contributor Covenant</a>, version 2.0, available at <a href="https://www.contributor-covenant.org/version/2/0/code_of_conduct.html">https://www.contributor-covenant.org/version/2/0/code_of_conduct.html</a>.</p>
180180
<p>Community Impact Guidelines were inspired by <a href="https://github.com/mozilla/diversity">Mozilla's code of conduct enforcement ladder</a>.</p>

documentation/md_case.html

Lines changed: 41 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -169,8 +169,9 @@ <h1><a class="anchor" id="autotoc_md3"></a>
169169
<li>(Optional) Acoustic Source Parameters</li>
170170
<li>(Optional) Ensemble-Averaged Bubble Model Parameters</li>
171171
<li>(Optional) Velocity Field Setup Parameters</li>
172+
<li>(Optional) Phase Change Parameters</li>
172173
</ol>
173-
<p>Items 7, 8, and 9 are optional sets of parameters that activate the acoustic source model, ensemble-averaged bubble model, and initial velocity field setup, respectively. Definition of the parameters is described in the following subsections.</p>
174+
<p>Items 7, 8, 9, and 10 are optional sets of parameters that activate the acoustic source model, ensemble-averaged bubble model, initial velocity field setup, and phase change, respectively. Definition of the parameters is described in the following subsections.</p>
174175
<h2><a class="anchor" id="autotoc_md5"></a>
175176
1. Runtime</h2>
176177
<table class="markdownTable">
@@ -349,14 +350,25 @@ <h2><a class="anchor" id="autotoc_md11"></a>
349350
<tr class="markdownTableRowOdd">
350351
<td class="markdownTableBodyRight"><code>Re(1)</code> * </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Shear viscosity of fluid. </td></tr>
351352
<tr class="markdownTableRowEven">
352-
<td class="markdownTableBodyRight"><code>Re(2)</code> * </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Volume viscosity of fluid. </td></tr>
353+
<td class="markdownTableBodyRight"><code>Re(2)</code> * </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Volume viscosity of fluid. </td></tr>
354+
<tr class="markdownTableRowOdd">
355+
<td class="markdownTableBodyRight"><code>cv</code> ** </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Sffened-gas parameter $c_v$ of fluid. </td></tr>
356+
<tr class="markdownTableRowEven">
357+
<td class="markdownTableBodyRight"><code>qv</code> ** </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Stiffened-gas parameter $q$ of fluid. </td></tr>
358+
<tr class="markdownTableRowOdd">
359+
<td class="markdownTableBodyRight"><code>qvp</code> ** </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">Stiffened-gas parameter $q'$ of fluid. </td></tr>
353360
</table>
354361
<p>Fluid material's parameters. All parameters should be prepended with <code>fluid_pp(i)</code> where $i$ is the fluid index.</p>
355362
<p>*: Parameters that work only with <code>model_eqns</code>=2.</p>
363+
<p>**: Parameters that work only with <code>model_eqns</code>=3.</p>
356364
<p>The table lists the fluid material's parameters. The parameters define material's property of compressible fluids that are used in simulation.</p>
357365
<ul>
358366
<li><code>fluid_pp(i)gamma</code> and <code>fluid_pp(i)pi_inf</code> define $\Gamma$ and $\Pi$ as parameters of $i$-th fluid that are used in stiffened gas equation of state.</li>
359-
<li><code>fluid_pp(i)Re(1)</code> and <code>fluid_pp(i)Re(2)</code> define the shear and volume viscosities of $i$-th fluid, respectively. When these parameters are undefined, fluids are treated as inviscid. Details of implementation of viscosity in MFC can be found in <a href="references.md#Coralic15">Coralic (2015)</a>.</li>
367+
<li><code>fluid_pp(i)Re(1)</code> and <code>fluid_pp(i)Re(2)</code> define the shear and volume viscosities of $i$-th fluid, respectively.</li>
368+
</ul>
369+
<p>When these parameters are undefined, fluids are treated as inviscid. Details of implementation of viscosity in MFC can be found in <a href="references.md#Coralic15">Coralic (2015)</a>.</p>
370+
<ul>
371+
<li><code>fluid_pp(i)cv</code>, <code>fluid_pp(i)qv</code>, and <code>fluid_pp(i)qvp</code> define $c_v$, $q$, and $q'$ as parameters of $i$-th fluid that are used in stiffened gas equation of state.</li>
360372
</ul>
361373
<h2><a class="anchor" id="autotoc_md12"></a>
362374
5. Simulation Algorithm</h2>
@@ -641,9 +653,29 @@ <h2><a class="anchor" id="autotoc_md16"></a>
641653
<li><code>vel_profile</code> activates setting the mean streamwise velocity to hyperbolic tangent profile. This option works only for 2D and 3D cases.</li>
642654
<li><code>instability_wave</code> activates the perturbation of initial velocity by instability waves obtained from linear stability analysis for a mixing layer with hyperbolic tangent mean streamwise velocity profile. This option only works for 2D and 3D cases, together with <code>vel_profile = TRUE</code>.</li>
643655
</ul>
644-
<h1><a class="anchor" id="autotoc_md17"></a>
656+
<h2><a class="anchor" id="autotoc_md17"></a>
657+
10. Phase Change Model</h2>
658+
<table class="markdownTable">
659+
<tr class="markdownTableHead">
660+
<th class="markdownTableHeadRight">Parameter </th><th class="markdownTableHeadCenter">Type </th><th class="markdownTableHeadLeft">Description </th></tr>
661+
<tr class="markdownTableRowOdd">
662+
<td class="markdownTableBodyRight"><code>relax</code> </td><td class="markdownTableBodyCenter">Logical </td><td class="markdownTableBodyLeft">Activates Phase Change model </td></tr>
663+
<tr class="markdownTableRowEven">
664+
<td class="markdownTableBodyRight"><code>relax_model</code> </td><td class="markdownTableBodyCenter">Integer </td><td class="markdownTableBodyLeft">Phase change model: [5] pT-equilibrium; [6] pTg-equilibrium </td></tr>
665+
<tr class="markdownTableRowOdd">
666+
<td class="markdownTableBodyRight"><code>palpha_eps</code> </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">tolerance of the Newton Solver to activate pT-equilibrium </td></tr>
667+
<tr class="markdownTableRowEven">
668+
<td class="markdownTableBodyRight"><code>ptgalpha_eps</code> </td><td class="markdownTableBodyCenter">Real </td><td class="markdownTableBodyLeft">tolerance of the Newton Solver to activate pTg-equilibrium </td></tr>
669+
</table>
670+
<ul>
671+
<li><code>relax</code> Activates the Phase Change model.</li>
672+
<li><code>relax_model</code> Specifies the phase change model to be used: [5] enables pT-equilibrium, while [6] activates pTg-equilibrium (if criteria are met).</li>
673+
<li><code>palpha_eps</code> Specifies the tolerance used for the Newton Solvers used in the pT-equilibrium model.</li>
674+
<li><code>ptgalpha_eps</code> Specifies the tolerance used for the Newton Solvers used in the pTg-equilibrium model.</li>
675+
</ul>
676+
<h1><a class="anchor" id="autotoc_md18"></a>
645677
Enumerations</h1>
646-
<h2><a class="anchor" id="autotoc_md18"></a>
678+
<h2><a class="anchor" id="autotoc_md19"></a>
647679
Boundary conditions</h2>
648680
<table class="markdownTable">
649681
<tr class="markdownTableHead">
@@ -681,7 +713,7 @@ <h2><a class="anchor" id="autotoc_md18"></a>
681713
</table>
682714
<p>*: This boundary condition is only used for <code>bc_ybeg</code> when using cylindrical coordinates (&lsquo;cyl_coord = 'T&rsquo;<code>and 3d). For axisymmetric problems, use</code>bc_ybeg = -2<code>with</code>cyl_coord = 'T'` in 2D.</p>
683715
<p>The boundary condition supported by the MFC are listed in table Boundary Conditions. Their number (<code>#</code>) corresponds to the input value in <code>input.py</code> labeled <code>bc_[x,y,z]%[beg,end]</code> (see table Simulation Algorithm Parameters). The entries labeled "Characteristic." are characteristic boundary conditions based on <a href="references.md#Thompson87">Thompson (1987)</a> and <a href="references.md#Thompson90">Thompson (1990)</a>.</p>
684-
<h2><a class="anchor" id="autotoc_md19"></a>
716+
<h2><a class="anchor" id="autotoc_md20"></a>
685717
Patch types</h2>
686718
<table class="markdownTable">
687719
<tr class="markdownTableHead">
@@ -730,7 +762,7 @@ <h2><a class="anchor" id="autotoc_md19"></a>
730762
<td class="markdownTableBodyRight">21 </td><td class="markdownTableBodyCenter">Model </td><td class="markdownTableBodyCenter">2 &amp; 3 </td><td class="markdownTableBodyCenter">Y </td><td class="markdownTableBodyLeft">Imports a Model (STL/OBJ). Requires <code>modelfilepath</code>. </td></tr>
731763
</table>
732764
<p>The patch types supported by the MFC are listed in table Patch Types. This includes types exclusive to one-, two-, and three-dimensional problems. The patch type number (<code>#</code>) corresponds to the input value in <code>input.py</code> labeled <code>patch_icpp(j)geometry</code> where $j$ is the patch index. Each patch requires a different set of parameters, which are also listed in this table.</p>
733-
<h2><a class="anchor" id="autotoc_md20"></a>
765+
<h2><a class="anchor" id="autotoc_md21"></a>
734766
Monopole supports</h2>
735767
<table class="markdownTable">
736768
<tr class="markdownTableHead">
@@ -749,7 +781,7 @@ <h2><a class="anchor" id="autotoc_md20"></a>
749781
<td class="markdownTableBodyNone">6 </td><td class="markdownTableBodyNone">Cyl_coord along axial-dir </td></tr>
750782
</table>
751783
<p>The monopole support types available in MFC are listed in table Monopole supports. This includes types exclusive to one-, two-, and three-dimensional problems with special sauce geometry like transducers as well as coordinate systems such as cylindrical coordinates. The monopole support number (<code>#</code>) corresponds to the input value in <code>input.py</code> labeled <code>Mono(i)support</code> where $i$ is the monopole source index.</p>
752-
<h2><a class="anchor" id="autotoc_md21"></a>
784+
<h2><a class="anchor" id="autotoc_md22"></a>
753785
Conservative Variables Ordering</h2>
754786
<table class="markdownTable">
755787
<tr class="markdownTableHead">
@@ -775,7 +807,7 @@ <h2><a class="anchor" id="autotoc_md21"></a>
775807
<td class="markdownTableBodyNone">hypoelastic variables </td><td class="markdownTableBodyNone">N/A </td></tr>
776808
</table>
777809
<p>The above variables correspond to optional physics.</p>
778-
<h2><a class="anchor" id="autotoc_md22"></a>
810+
<h2><a class="anchor" id="autotoc_md23"></a>
779811
Primitive Variables Ordering</h2>
780812
<table class="markdownTable">
781813
<tr class="markdownTableHead">

0 commit comments

Comments
 (0)