View source for Contrib/IAPWS-IF97-OF

; Source code repository: [https://github.com/romansCode/IAPWS-IF97-OF IAPWS-IF97-OF at GitHub]

= 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].

= Installation =

== 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&deg;C < T < 800&deg;C p<100 MPa and for 800&deg;C < 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]