update docs (exa/docs!157) (fbdf45a1) · Commits · Janine Carney / docs

docs/source_docs/user_guide/inputs/fluid_model.rst

+51 −34

Original line number	Diff line number	Diff line
		@@ -27,12 +27,11 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		.. \|Sato_Eq\| replace:: :math:`\mu_{pit} = C d_s \rho \left\|\boldsymbol{u} - \boldsymbol{u_s}\right\|`

		.. \|eff_visc\| replace:: :math:`\mu_{eff} = \mu_{mol} + \mu_{eddy} + \mu_{susp} + \mu_{pit}`

		.. \|mix_Eq\| replace:: :math:`\mu_{mix} = \sum_{\alpha=1}^{N} \frac{X_{\alpha} \mu_{\alpha}}{\sum_{\beta} X_{\beta} \phi_{\alpha \beta}}`

		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| \| Description \| Type \| Default \|
		+============================================+============================================================+========+==========+
		+============================================+================================================================+========+==========+
		\| viscosity.molecular \| Specify which molecular viscosity model to use. \| String \| None \|
		\| \| \| \| \|
		\| \| Options: \| \| \|
		@@ -55,28 +54,28 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		\| \| \| \| \|
		\| \| A viscosity model is required if the fluid solver is \| \| \|
		\| \| enabled. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.molecular.constant \| Constant fluid viscosity. \| Real \| 0 \|
		\| \| \| \| \|
		\| \| A value is required for ``constant`` viscosity model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.molecular.Sutherland.T_ref \| Sutherland model reference temperature. \| Real \| 0 \|
		\| \| \| \| \|
		\| \| A value is required for ``Sutherland`` viscosity model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.molecular.Sutherland.mu_ref \| Sutherland model reference viscosity at T_ref. \| Real \| 0 \|
		\| \| \| \| \|
		\| \| A value is required for ``Sutherland`` viscosity model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.molecular.Sutherland.S \| Sutherland model temperature. \| Real \| 0 \|
		\| \| \| \| \|
		\| \| A value is required for ``Sutherland`` viscosity model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.molecular.Reid.A \| Reid model constants. \| Real \| 0 \|
		\| viscosity.molecular.Reid.B \| \| \| \|
		\| viscosity.molecular.Reid.C \| Values are required for ``Reid`` viscosity model. \| \| \|
		\| viscosity.molecular.Reid.D \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.eddy \| Specify eddy viscosity model. \| \| \|
		\| \| \| \| \|
		\| \| Options: \| \| \|
		@@ -85,15 +84,15 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		\| \| * ``Smagorinsky-Lilly`` :cite:p:`Smag63,Lilly66` \| \| \|
		\| \| * ``WALE`` :cite:p:`ducros98` \| \| \|
		\| \| * ``usr`` \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.eddy.Smagorinsky-Lilly.constant \| Smagorinsky-Lilly constant which usually has values \| Real \| None \|
		\| \| between 0.1 and 0.2. \| \| \|
		\| \| \| \| \|
		\| \| A value is required when using the ``Smagorinsky-Lilly`` \| \| \|
		\| \| eddy viscosity model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.eddy.WALE.constant \| WALE eddy viscosity model constant. \| Real \| 0.325 \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension \| Specify suspension viscosity model of the form \| String \| None \|
		\| \| \| \| \|
		\| \| :math:`\mu_{susp} = \mu_{mol}(\mu^* - 1)` \| \| \|
		@@ -128,48 +127,53 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		\| \| \| \| \|
		\| \| :math:`\mu_{pit} = C_\mu k_f^2 / \epsilon_f` \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.Brinkman.constant \| Constant for exponent in Brinkman suspension expression. \| Real \| None \|
		\| \| \| \| \|
		\| \| A value is required when using the ``Brinkman`` model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.Roscoe.c1 \| Constant for max packing in Roscoe suspension expression. \| Real \| None \|
		\| \| \| \| \|
		\| \| A value is required when using the ``Roscoe`` model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.Roscoe.c2 \| Constant for exponent in Roscoe suspension expression. \| Real \| None \|
		\| \| \| \| \|
		\| \| A value is required when using the ``Roscoe`` model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.ChengLaw.constant \| Constant for exponent in ChengLaw suspension expression. \| Real \| None \|
		\| \| \| \| \|
		\| \| A value is required when using the ``ChengLaw`` model. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.Sato.constant \| Constant for Sato suspension expression. \| Real \| 0.65 \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.suspension.Subramaniam.constant \| Constant for Subramaniam suspension expression. \| Real \| 0.09 \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| viscosity.max_effective_factor \| Max limit of the effective viscosity as a factor of the \| Real \| 1.e6 \|
		\| \| molecular viscosity \| \| \|
		\| \| \| \| \|
		\| \| :math:`\mu_{eff} < fac*\mu_{mol}`, where \| \| \|
		\| \| \|eff_visc\| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| species \| Specify the species that constitute the fluid. \| Strings\| None \|
		\| \| \| \| \|
		\| \| All listed species must be properly defined. See the \| \| \|
		\| \| :ref:`species definition documentation<InputsSpeciesDefs>` \| \| \|
		\| \| for additional details. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| molecular_weight \| Constant fluid molecular weight. \| Real \| 0 \|
		\| \| \| \| \|
		\| \| A molecular weight should only be defined when using one \| \| \|
		\| \| of the ``IdealGas`` constraints and the species equations \| \| \|
		\| \| are not solved. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| specific_heat \| Specify which specific heat model to use for the fluid. \| String \| None \|
		\| \| \| \| \|
		\| \| A specific heat model is required if advecting enthalpy. \| \| \|
		\| \| Furthermore, the model must be ``mixture`` if species \| \| \|
		\| \| equations are solved. \| \| \|
		\| \| \| \| \|
		\| \| Options: \| \| \|
		\| \| \| \| \|
		\| \| * ``constant`` - the fluid has a constant specific heat \| \| \|
		@@ -190,23 +194,36 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		\| \| \| \| \|
		\| \| :math:`c_{p,\mathrm{mixture}} = \sum_n X_n c_{p,n}` \| \| \|
		\| \| \| \| \|
		\| \| A specific heat model is required if advecting enthalpy. \| \| \|
		\| \| Furthermore, the model must be ``mixture`` if species \| \| \|
		\| \| equations are solved. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| specific_heat.constant \| Constant fluid specific heat \| Real \| 0 \|
		\| \| A value is required for ``constant`` specific heat model. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		\| specific_heat.NASA7.a[i] \| Specific heat polynomial coefficients. Polynomial \| Real \| None \|
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| specific_heat.ignore_discontinuities \| Ignore discontinuities in NASA-7 polynomials at transition \| Int \| 0 \|
		\| \| temperatures (``Tsplit``). More information is provided \| \| \|
		\| \| in :ref:`species specific heats<InputsSpeciesDefs>`. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| specific_heat.NASA7.a[i] \| Specific heat polynomial coefficients. Polynomial \| Reals \| None \|
		\| \| coefficients are required if the fluid specific heat \| \| \|
		\| \| model is ``NASA7-poly``. \| \| \|
		\| \| \| \| \|
		\| \| Additional information on NASA-7 polynomials is provided \| \| \|
		\| \| in :ref:`species specific heats<InputsSpeciesDefs>`. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| specific_heat.NASA7.Tsplit \| Defines the transition temperature between NASA-7 polynomials. \| Reals \| 1000 \|
		\| \| \| \| \|
		\| \| * Setting ``Tsplit = -1`` signifies that a single \| \| \|
		\| \| polynomial defines the specific heat and enthalpy for all \| \| \|
		\| \| temperatures. \| \| \|
		\| \| \| \| \|
		\| \| * Specifying ``N`` temperatures signifies that ``N+1`` \| \| \|
		\| \| polynomials are used to define the specific heat \| \| \|
		\| \| and enthalpy. \| \| \|
		\| \| \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| thermal_conductivity \| Specify which thermal conductivity model to use for \| String \| None \|
		\| \| fluid. Options: \| \| \|
		\| \| \| \| \|
		@@ -215,22 +232,22 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill
		\| \| \| \| \|
		\| \| A thermal conductivity model is required if advecting \| \| \|
		\| \| enthalpy. \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| thermal_conductivity.constant \| Constant fluid thermal conductivity. \| Real \| 0 \|
		\| \| A value is required for ``constant`` thermal conductivity \| \| \|
		\| \| model. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| thermodynamic_pressure \| Thermodynamic pressure. \| Real \| 0 \|
		\| \| A value is required when using the \| \| \|
		\| \| ``IdealGasClosedSystem`` constraint. If using the \| \| \|
		\| \| ``IdealGasOpenSystem`` constraint, then the value must \| \| \|
		\| \| match all specified outflow pressures. \| \| \|
		\| \| \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+
		\| reference_temperature \| Reference temperature used to compute specific \| Real \| 298. \|
		\| \| enthalpy \| \| \|
		+--------------------------------------------+------------------------------------------------------------+--------+----------+
		+--------------------------------------------+----------------------------------------------------------------+--------+----------+


		Example inputs

docs/source_docs/user_guide/inputs/initial_conditions.rst

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

docs/source_docs/user_guide/inputs/model_options.rst

+12 −13

File changed.

Preview size limit exceeded, changes collapsed.

docs/source_docs/user_guide/inputs/solids_model.rst

+60 −17

File changed.

Preview size limit exceeded, changes collapsed.

docs/source_docs/user_guide/inputs/species.rst

+57 −42

File changed.

Preview size limit exceeded, changes collapsed.