Difference between revisions of "Contrib/IAPWS-IF97-OF"

From OpenFOAMWiki
(Kicked off this page)
 
(Initial creation of full description site)
Line 1: Line 1:
 
; Source code repository: [https://github.com/romansCode/IAPWS-IF97-OF IAPWS-IF97-OF at GitHub]
 
; Source code repository: [https://github.com/romansCode/IAPWS-IF97-OF IAPWS-IF97-OF at GitHub]
  
; Description: IAPWS-IF97 water properties for OpenFOAM (R).
+
= About =
 +
The extension makes water properties based on the [http://gasturbinespower.asmedigitalcollection.asme.org/article.aspx?articleid=1421003 IAPWS-IF97] (doi: 10.1115/1.483186) definition available for OpenFOAM (R) solvers of the compressible buoyant* family, such as buoyantPimpleFoam. The extension is based on the work for the real gas branch of [http://sourceforge.net/p/openfoam-extend/OpenFOAM-1.6-ext/ci/feature/fullyIntegratedRealGasThermo/~/tree/README_RealGasBranch openfoam-ext-1.6]. The water properties come from the C-library [http://freesteam.sourceforge.net/ freesteam].
  
; Support pages:
+
= Installation =
:* Issue/bug tracker: [https://github.com/nicolasedh/hexBlocker/issues hexBlocker Issue Tracker]
+
 
:* Forum support thread: [http://www.cfd-online.com/Forums/openfoam-solving/58551-iapwsif97-water-properties.html IAPWSIF97 water properties]
+
== Prerequisited ==
 +
 
 +
# Full installation of OpenFOAM >=2.2 from http://www.openfoam.org
 +
# Installed freesteam >=2.0 from http://freesteam.sourceforge.net/
 +
 
 +
 
 +
== Installing IAPWS-IF97-OF ==
 +
Open a command line window and navigate to directory you would like to store the source code for IAPWS-IF97-OF. Then run the following commands in a command line on your computer
 +
<pre># git clone https://github.com/romansCode/IAPWS-IF97-OF.git</pre>
 +
<pre># cd IAPWS-IF97-OF</pre>
 +
<pre># wclean && wmake libso</pre>
 +
 
 +
= Usage =
 +
* add ''libIAPWSRangeThermo.so'' and ''libfreesteam.so'' to the libraries in controlDict
 +
<pre>libs
 +
{
 +
        "libIAPWSRangeThermo.so"
 +
        "libfreesteam.so"
 +
}</pre>
 +
* In the the thermophysicalProperties file, which can also be found in the example folder in the source code use the following.
 +
<pre> thermoType
 +
{
 +
    type            heRhoThermo;    // Thermophysical model based on sensible enthalpy
 +
    mixture        pureMixture;    // Only water
 +
    transport      IAPWSTransport; // (mu, k)
 +
    thermo          hIAPWS;        // (Cp)
 +
    equationOfState eosIAPWS;      // (rho)
 +
    specie          specie;
 +
    energy          sensibleEnthalpy;
 +
}
 +
// outside the pressure and temperature range, the properties will be capped to
 +
// the min and max values at the range limits
 +
mixture
 +
{
 +
    IAPWSProperties
 +
    {
 +
        pMax    300e5;  // max allowed pressure
 +
        pMin    221e5;  // min allowed pressure
 +
    }
 +
    specie
 +
    {
 +
        nMoles          1;
 +
        molWeight      18;  // Water
 +
    }
 +
}</pre>
 +
 
 +
* The pressure limits can be used to stabilise the computations at startup, however, they are not necessary and can be set to the limits of the properties table (for 0 < T < 800 deg C p<100 MPa and for 800 < T < 2000 deg C p < 10 MPa).
 +
 
 +
= Support =
 +
* Issue/bug tracker: [https://github.com/romansCode/IAPWS-IF97-OF/issues IAPWS-IF97-OF Issue Tracker]
 +
* Forum support thread: [http://www.cfd-online.com/Forums/openfoam-solving/58551-iapwsif97-water-properties.html IAPWSIF97 water properties]

Revision as of 09:29, 14 June 2015

Source code repository
IAPWS-IF97-OF at GitHub

1 About

The extension makes water properties based on the IAPWS-IF97 (doi: 10.1115/1.483186) definition available for OpenFOAM (R) solvers of the compressible buoyant* family, such as buoyantPimpleFoam. The extension is based on the work for the real gas branch of openfoam-ext-1.6. The water properties come from the C-library freesteam.

2 Installation

2.1 Prerequisited

  1. Full installation of OpenFOAM >=2.2 from http://www.openfoam.org
  2. Installed freesteam >=2.0 from http://freesteam.sourceforge.net/


2.2 Installing IAPWS-IF97-OF

Open a command line window and navigate to directory you would like to store the source code for IAPWS-IF97-OF. Then run the following commands in a command line on your computer

# git clone https://github.com/romansCode/IAPWS-IF97-OF.git
# cd IAPWS-IF97-OF
# wclean && wmake libso

3 Usage

  • add libIAPWSRangeThermo.so and libfreesteam.so to the libraries in controlDict
libs
 {
        "libIAPWSRangeThermo.so" 
        "libfreesteam.so" 
 }
  • In the the thermophysicalProperties file, which can also be found in the example folder in the source code use the following.
 thermoType 
 {
    type            heRhoThermo;    // Thermophysical model based on sensible enthalpy
    mixture         pureMixture;    // Only water
    transport       IAPWSTransport; // (mu, k)
    thermo          hIAPWS;         // (Cp)
    equationOfState eosIAPWS;       // (rho)
    specie          specie;
    energy          sensibleEnthalpy;
 }
 // outside the pressure and temperature range, the properties will be capped to
 // the min and max values at the range limits
 mixture
 {
    IAPWSProperties
    {
        pMax    300e5;  // max allowed pressure
        pMin    221e5;  // min allowed pressure
    }
    specie
    {
        nMoles          1;
        molWeight       18;   // Water
    }
 }
  • The pressure limits can be used to stabilise the computations at startup, however, they are not necessary and can be set to the limits of the properties table (for 0 < T < 800 deg C p<100 MPa and for 800 < T < 2000 deg C p < 10 MPa).

4 Support