diff --git a/docs/source_docs/user_guide/inputs/fluid_model.rst b/docs/source_docs/user_guide/inputs/fluid_model.rst index d0533cf7deb028f7738c4831eca63c0b4927262f..1aef1bad2c4d00e3429c1bcf643de0e70aabcdd5 100644 --- a/docs/source_docs/user_guide/inputs/fluid_model.rst +++ b/docs/source_docs/user_guide/inputs/fluid_model.rst @@ -172,13 +172,15 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill | | | | | | | * ``constant`` - the fluid has a constant specific heat | | | | | | | | -| | * ``NASA7-poly`` the fluid specific heat is defined by a | | | -| | low-temperature (T < 1000K) polynomial and a | | | -| | high-temperature (T > 1000K) polynomial. | | | +| | * ``NASA7-poly`` the fluid specific heat is defined by | | | +| | NASA-7 polynomails. | | | | | | | | | | NASA7 polynomial format: | | | | | | | | -| | :math:`c_p(T) = \sum_{i=0}^5 a_iT^i` | | | +| | :math:`c_p(T)/R = \sum_{i=0}^4 a_{i}T^{i}` | | | +| | | | | +| | Additional information on NASA-7 polynomials is provided | | | +| | in :ref:`species specific heats`. | | | | | | | | | | * ``mixture`` - a *mixture* specific heat is computed | | | | | from :ref:`species specific heats` | | | @@ -195,16 +197,12 @@ a single fluid; therefore, it is common to name the fluid ``fluid``. This is ill | | A value is required for ``constant`` specific heat model. | | | | | | | | +--------------------------------------------+------------------------------------------------------------+--------+----------+ -| specific_heat.NASA7.a[i] | Specific heat polynomial coefficients. Polynomial | Real | 0. 0. | +| specific_heat.NASA7.a[i] | Specific heat polynomial coefficients. Polynomial | Real | None | | | coefficients are required if the fluid specific heat | | | | | model is ``NASA7-poly``. | | | | | | | | -| | Each polynomial is defined by six coefficients (``a0``, | | | -| | ..., ``a5``), and two values are required for each | | | -| | coefficient. The first value is the low temperature | | | -| | polynomial coefficient (T < 1000K) and the second is the | | | -| | coefficient for the high temperature polynomial | | | -| | (T > 1000K). A total of twelve coefficients are required. | | | +| | Additional information on NASA-7 polynomials is provided | | | +| | in :ref:`species specific heats`. | | | | | | | | +--------------------------------------------+------------------------------------------------------------+--------+----------+ | thermal_conductivity | Specify which thermal conductivity model to use for | String | None | diff --git a/docs/source_docs/user_guide/inputs/species_defs.rst b/docs/source_docs/user_guide/inputs/species_defs.rst index b093c1014bca1d1545648d0aba462550773ec220..ad83fcf0ac6efddc535624d77439920cc5be3d2f 100644 --- a/docs/source_docs/user_guide/inputs/species_defs.rst +++ b/docs/source_docs/user_guide/inputs/species_defs.rst @@ -30,16 +30,14 @@ The following inputs are defined using the ``species`` prefix. | | and a *mixture* specific heat is computed based on the fluid or | | | | | particle composition. | | | | | | | | -| | * ``NASA7-poly`` the specific heat of each species is defined by two | | | -| | polynomials that are a function of temperature, then a *mixture* | | | -| | specific heat is computed based on the fluid or particle | | | -| | composition. One polynomial defines the specific across the low | | | -| | temperature range while the second defines the specific heat across | | | -| | the high temperature range. | | | +| | * ``NASA7-poly`` the specific heat of each species is defined by one | | | +| | or more polynomials that are a function of temperature, then the | | | +| | *mixture* specific heat is computed based on the fluid or particle | | | +| | composition. | | | | | | | | | | NASA7 polynomial format: | | | | | | | | -| | :math:`c_p(T) = \sum_{i=0}^5 a_iT^i` | | | +| | :math:`c_p(T)/R = \sum_{i=0}^4 a_{i}T^{i}` | | | | | | | | +--------------------------+------------------------------------------------------------------------+----------+-----------+ | ignore_discontinuities | MFIX-Exa asserts that the low and high NASA-7 polynomials are | int | 0 | @@ -72,15 +70,36 @@ The following inputs are for each species defined using the ``species.[species n | | species if the fluid (solids) ``specific_heat = mixture`` and the | | | | | specific heat model is ``constant`` | | | +---------------------------------------+------------------------------------------------------------------------+----------+-----------+ -| specific_heat.NASA7.a[i] | Species specific heat polynomial coefficients. Required for all fluid | Real | 0. 0. | +| specific_heat.NASA7.a[i] | Species specific heat polynomial coefficients. Required for all fluid | Real | None | | | (solids) species if the fluid (solids) ``specific_heat = mixture`` | | | | | and the specific heat model is ``NASA7-poly`` | | | | | | | | -| | Each polynomial is defined by six coefficients (``a0`` .. ``a5``), and | | | -| | two values are required for each coefficient. The first value is the | | | -| | low temperature polynomial coefficient (T < 1000K) and the second is | | | -| | the coefficient for the high temperature polynomial (T > 1000K). A | | | -| | total of twelve coefficients are required. | | | +| | * Each polynomial is defined by six coefficients (``a0`` ... ``a5``). | | | +| | Coefficients ``a0`` through ``a4`` are use for computing specific | | | +| | heat while all six coefficients are used to compute enthalpy. | | | +| | The seventh coefficient, ``a6``, may be provided for completeness | | | +| | but is not used as MFIX-Exa presently does not need to compute | | | +| | entropy. | | | +| | | | | +| | * By default, two sets of coefficients are required. The coefficients | | | +| | define two polynomials used to compute the specific heat and | | | +| | enthalpy across low and high temperatures. The *split temperature* | | | +| | defines the transition from low-to-high polynomials. | | | +| | | | | +| | * A single polynomial can be used for all temperatures by setting the | | | +| | *split temperature* to -1. | | | +| | | | | +| | * Three or more polynomials can be used by defining multiple split | | | +| | temperatures. | | | +| | | | | ++---------------------------------------+------------------------------------------------------------------------+----------+-----------+ +| specific_heat.NASA7.Tsplit | Defines the temperature transition between NASA-7 polynomials. | Real | 1000. | +| | | | | +| | * Setting ``Tsplit = -1`` signifies that a single polynomial defines | | | +| | the specific heat and enthalpy for all temperatures. | | | +| | | | | +| | * Specifying ``N`` split temperatures where ``N>1``, signifies ``N+1`` | | | +| | polynomials are used to define the specific heat and enthalpy. | | | | | | | | +---------------------------------------+------------------------------------------------------------------------+----------+-----------+ | enthalpy_of_formation | Enthalpy of formation of species. This input is required only when | Real | 0 |