Thermodynamics: Changed all eEqn to EEqn and reformulated to conserve E in sonic solvers

To support these changes the need for "Sp" corrections on div-terms has been
eliminated by introducing a "bounded" convection scheme which subtracts the Sp
term from the selected scheme.  The equivalent will be needed for the ddt term.

A warning message is generated for steady-state solvers in which the "bounded"
scheme is not selected for the convection terms.

applications/solvers/compressible/rhoSimpleFoam/EEqn.H

@@ -0,0 +1,19 @@
+{
+    volScalarField& he = thermo.he();
+
+    fvScalarMatrix EEqn
+    (
+        fvm::div(phi, he)
+      + (
+            he.name() == "e"
+          ? fvc::div(phi, volScalarField("Ekp", 0.5*magSqr(U) + p/rho))
+          : fvc::div(phi, volScalarField("K", 0.5*magSqr(U)))
+        )
+      - fvm::laplacian(turbulence->alphaEff(), he)
+    );
+
+    EEqn.relax();
+    EEqn.solve();
+
+    thermo.correct();
+}

applications/solvers/compressible/rhoSimpleFoam/createFields.H

@@ -5,6 +5,7 @@
         psiThermo::New(mesh)
     );
     psiThermo& thermo = pThermo();
+    thermo.validate(args.executable(), "h", "e");
 
     volScalarField rho
     (
@@ -20,7 +21,6 @@
     );
 
     volScalarField& p = thermo.p();
-    volScalarField& e = thermo.he();
     const volScalarField& psi = thermo.psi();
 
     Info<< "Reading field U\n" << endl;

applications/solvers/compressible/rhoSimpleFoam/eEqn.H

@@ -1,18 +0,0 @@
-{
-    // Kinetic + pressure energy
-    volScalarField Ekp("Ekp", 0.5*magSqr(U) + p/rho);
-
-    fvScalarMatrix eEqn
-    (
-        fvm::div(phi, e)
-      - fvm::Sp(fvc::div(phi), e)
-      - fvm::laplacian(turbulence->alphaEff(), e)
-     ==
-        fvc::div(phi)*Ekp - fvc::div(phi, Ekp)
-    );
-
-    eEqn.relax();
-    eEqn.solve();
-
-    thermo.correct();
-}

applications/solvers/compressible/rhoSimpleFoam/rhoPorousMRFSimpleFoam/EEqn.H

@@ -0,0 +1,21 @@
+{
+    volScalarField& he = thermo.he();
+
+    fvScalarMatrix EEqn
+    (
+        fvm::div(phi, he)
+      + (
+            he.name() == "e"
+          ? fvc::div(phi, volScalarField("Ekp", 0.5*magSqr(U) + p/rho))
+          : fvc::div(phi, volScalarField("K", 0.5*magSqr(U)))
+        )
+      - fvm::laplacian(turbulence->alphaEff(), he)
+    );
+
+    pZones.addEnergySource(thermo, rho, EEqn);
+
+    EEqn.relax();
+    EEqn.solve();
+
+    thermo.correct();
+}

applications/solvers/compressible/rhoSimpleFoam/rhoPorousMRFSimpleFoam/createFields.H

@@ -5,6 +5,7 @@
         rhoThermo::New(mesh)
     );
     rhoThermo& thermo = pThermo();
+    thermo.validate(args.executable(), "h", "e");
 
     volScalarField rho
     (
@@ -20,7 +21,6 @@
     );
 
     volScalarField& p = thermo.p();
-    volScalarField& e = thermo.he();
 
     Info<< "Reading field U\n" << endl;
     volVectorField U

applications/solvers/compressible/rhoSimpleFoam/rhoPorousMRFSimpleFoam/eEqn.H

@@ -1,20 +0,0 @@
-{
-    // Kinetic + pressure energy
-    volScalarField Ekp("Ekp", 0.5*magSqr(U) + p/rho);
-
-    fvScalarMatrix eEqn
-    (
-        fvm::div(phi, e)
-      - fvm::Sp(fvc::div(phi), e)
-      - fvm::laplacian(turbulence->alphaEff(), e)
-     ==
-        fvc::div(phi)*Ekp - fvc::div(phi, Ekp)
-    );
-
-    pZones.addEnergySource(thermo, rho, eEqn);
-
-    eEqn.relax();
-    eEqn.solve();
-
-    thermo.correct();
-}

applications/solvers/compressible/rhoSimpleFoam/rhoPorousMRFSimpleFoam/rhoPorousMRFSimpleFoam.C

@@ -63,7 +63,7 @@ int main(int argc, char *argv[])
         // Pressure-velocity SIMPLE corrector
         {
             #include "UEqn.H"
-            #include "eEqn.H"
+            #include "EEqn.H"
             #include "pEqn.H"
         }
 

applications/solvers/compressible/rhoSimpleFoam/rhoSimpleFoam.C

@@ -59,7 +59,7 @@ int main(int argc, char *argv[])
         // Pressure-velocity SIMPLE corrector
         {
             #include "UEqn.H"
-            #include "eEqn.H"
+            #include "EEqn.H"
             #include "pEqn.H"
         }
 

applications/solvers/compressible/rhoSimpleFoam/rhoSimplecFoam/rhoSimplecFoam.C

@@ -61,7 +61,7 @@ int main(int argc, char *argv[])
         // Velocity-pressure-enthalpy SIMPLEC corrector
         {
             #include "UEqn.H"
-            #include "eEqn.H"
+            #include "EEqn.H"
             #include "pEqn.H"
         }
 

applications/solvers/compressible/sonicFoam/EEqn.H

@@ -0,0 +1,10 @@
+{
+    solve
+    (
+        fvm::ddt(rho, e) + fvm::div(phi, e)
+      + fvc::ddt(rho, K) + fvc::div(phi, volScalarField("Ekp", K + p/rho))
+      - fvm::laplacian(turbulence->alphaEff(), e)
+    );
+
+    thermo.correct();
+}

applications/solvers/compressible/sonicFoam/createFields.H

@@ -5,6 +5,7 @@
         psiThermo::New(mesh)
     );
     psiThermo& thermo = pThermo();
+    thermo.validate(args.executable(), "e");
 
     volScalarField& p = thermo.p();
     volScalarField& e = thermo.he();

applications/solvers/compressible/sonicFoam/eEqn.H

@@ -1,12 +0,0 @@
-{
-    solve
-    (
-        fvm::ddt(rho, e)
-      + fvm::div(phi, e)
-      - fvm::laplacian(turbulence->alphaEff(), e)
-     ==
-      - (fvc::ddt(rho, K) + fvc::div(phi, volScalarField("Ekp", K + p/rho)))
-    );
-
-    thermo.correct();
-}

applications/solvers/compressible/sonicFoam/pEqn.H

@@ -17,7 +17,8 @@ surfaceScalarField phid
 
 volScalarField Dp("Dp", rho*rAU);
 
-for (int nonOrth=0; nonOrth<=nNonOrthCorr; nonOrth++)
+// Non-orthogonal pressure corrector loop
+while (pimple.correctNonOrthogonal())
 {
     fvScalarMatrix pEqn
     (
@@ -28,7 +29,7 @@ for (int nonOrth=0; nonOrth<=nNonOrthCorr; nonOrth++)
 
     pEqn.solve();
 
-    if (nonOrth == nNonOrthCorr)
+    if (pimple.finalNonOrthogonalIter())
     {
         phi = pEqn.flux();
     }

applications/solvers/compressible/sonicFoam/sonicDyMFoam/EEqn.H

@@ -0,0 +1,11 @@
+{
+    solve
+    (
+        fvm::ddt(rho, e) + fvm::div(phi, e)
+      + fvc::ddt(rho, K) + fvc::div(phi, K)
+      + fvc::div(phi/fvc::interpolate(rho) + mesh.phi(), p, "div(phiv,p)")
+      - fvm::laplacian(turbulence->alphaEff(), e)
+    );
+
+    thermo.correct();
+}

applications/solvers/compressible/sonicFoam/sonicDyMFoam/eEqn.H

@@ -1,12 +0,0 @@
-{
-    solve
-    (
-        fvm::ddt(rho, e)
-      + fvm::div(phi, e)
-      - fvm::laplacian(turbulence->alphaEff(), e)
-     ==
-      - p*fvc::div(phi/fvc::interpolate(rho) + mesh.phi())
-    );
-
-    thermo.correct();
-}

applications/solvers/compressible/sonicFoam/sonicDyMFoam/sonicDyMFoam.C

@@ -34,6 +34,7 @@ Description
 #include "psiThermo.H"
 #include "turbulenceModel.H"
 #include "motionSolver.H"
+#include "pimpleControl.H"
 
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
@@ -45,6 +46,8 @@ int main(int argc, char *argv[])
     #include "createFields.H"
     #include "initContinuityErrs.H"
 
+    pimpleControl pimple(mesh);
+
     // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
     Info<< "\nStarting time loop\n" << endl;
@@ -62,19 +65,23 @@ int main(int argc, char *argv[])
 
         #include "rhoEqn.H"
 
+        // --- Pressure-velocity PIMPLE corrector loop
+        while (pimple.loop())
+        {
             #include "UEqn.H"
+            #include "EEqn.H"
 
-        #include "eEqn.H"
+            // --- Pressure corrector loop
-
+            while (pimple.correct())
-
-        // --- PISO loop
-
-        for (int corr=0; corr<nCorr; corr++)
             {
                 #include "pEqn.H"
             }
 
+            if (pimple.turbCorr())
+            {
                 turbulence->correct();
+            }
+        }
 
         rho = thermo.rho();
 

applications/solvers/compressible/sonicFoam/sonicFoam.C

@@ -33,6 +33,7 @@ Description
 #include "fvCFD.H"
 #include "psiThermo.H"
 #include "turbulenceModel.H"
+#include "pimpleControl.H"
 
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
@@ -44,6 +45,8 @@ int main(int argc, char *argv[])
     #include "createFields.H"
     #include "initContinuityErrs.H"
 
+    pimpleControl pimple(mesh);
+
     // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
     Info<< "\nStarting time loop\n" << endl;
@@ -52,20 +55,28 @@ int main(int argc, char *argv[])
     {
         Info<< "Time = " << runTime.timeName() << nl << endl;
 
-        #include "readPISOControls.H"
+        #include "readTimeControls.H"
         #include "compressibleCourantNo.H"
 
         #include "rhoEqn.H"
-        #include "UEqn.H"
 
-        // --- PISO loop
+        // --- Pressure-velocity PIMPLE corrector loop
-        for (int corr=0; corr<nCorr; corr++)
+        while (pimple.loop())
+        {
+            #include "UEqn.H"
+            #include "EEqn.H"
+
+            // --- Pressure corrector loop
+            while (pimple.correct())
             {
-            #include "eEqn.H"
                 #include "pEqn.H"
             }
 
+            if (pimple.turbCorr())
+            {
                 turbulence->correct();
+            }
+        }
 
         rho = thermo.rho();
 

applications/solvers/compressible/sonicFoam/sonicLiquidFoam/sonicLiquidFoam.C

@@ -31,6 +31,7 @@ Description
 \*---------------------------------------------------------------------------*/
 
 #include "fvCFD.H"
+#include "pimpleControl.H"
 
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
@@ -44,6 +45,8 @@ int main(int argc, char *argv[])
     #include "createFields.H"
     #include "initContinuityErrs.H"
 
+    pimpleControl pimple(mesh);
+
     // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
     Info<< "\nStarting time loop\n" << endl;
@@ -52,11 +55,14 @@ int main(int argc, char *argv[])
     {
         Info<< "Time = " << runTime.timeName() << nl << endl;
 
-        #include "readPISOControls.H"
+        #include "readTimeControls.H"
         #include "compressibleCourantNo.H"
 
         #include "rhoEqn.H"
 
+        // --- Pressure-velocity PIMPLE corrector loop
+        while (pimple.loop())
+        {
             fvVectorMatrix UEqn
             (
                 fvm::ddt(rho, U)
@@ -66,10 +72,8 @@ int main(int argc, char *argv[])
 
             solve(UEqn == -fvc::grad(p));
 
-
+            // --- Pressure corrector loop
-        // --- PISO loop
+            while (pimple.correct())
-
-        for (int corr=0; corr<nCorr; corr++)
             {
                 volScalarField rAU(1.0/UEqn.A());
                 U = rAU*UEqn.H();
@@ -104,6 +108,7 @@ int main(int argc, char *argv[])
                 U -= rAU*fvc::grad(p);
                 U.correctBoundaryConditions();
             }
+        }
 
         rho = rhoO + psi*p;
 

applications/solvers/heatTransfer/buoyantPimpleFoam/EEqn.H

@@ -0,0 +1,20 @@
+{
+    volScalarField& he = thermo.he();
+
+    fvScalarMatrix EEqn
+    (
+        fvm::ddt(rho, he) + fvm::div(phi, he)
+      + fvc::ddt(rho, K) + fvc::div(phi, K)
+      + (
+            he.name() == "e"
+          ? fvc::div(phi, volScalarField("Ep", p/rho))
+          : -dpdt
+        )
+      - fvm::laplacian(turbulence->alphaEff(), he)
+    );
+
+    EEqn.relax();
+    EEqn.solve();
+
+    thermo.correct();
+}

applications/solvers/heatTransfer/buoyantPimpleFoam/buoyantPimpleFoam.C

@@ -75,7 +75,7 @@ int main(int argc, char *argv[])
         while (pimple.loop())
         {
             #include "UEqn.H"
-            #include "hEqn.H"
+            #include "EEqn.H"
 
             // --- Pressure corrector loop
             while (pimple.correct())

applications/solvers/heatTransfer/buoyantPimpleFoam/createFields.H

@@ -5,6 +5,7 @@
         rhoThermo::New(mesh)
     );
     rhoThermo& thermo = pThermo();
+    thermo.validate(args.executable(), "h", "e");
 
     volScalarField rho
     (
@@ -20,7 +21,6 @@
     );
 
     volScalarField& p = thermo.p();
-    volScalarField& h = thermo.he();
     const volScalarField& psi = thermo.psi();
 
 

applications/solvers/heatTransfer/buoyantPimpleFoam/hEqn.H

@@ -1,16 +0,0 @@
-{
-    fvScalarMatrix hEqn
-    (
-        fvm::ddt(rho, h)
-      + fvm::div(phi, h)
-      - fvm::laplacian(turbulence->alphaEff(), h)
-     ==
-        dpdt
-      - (fvc::ddt(rho, K) + fvc::div(phi, K))
-    );
-
-    hEqn.relax();
-    hEqn.solve();
-
-    thermo.correct();
-}

applications/solvers/heatTransfer/buoyantSimpleFoam/Allwmake

@@ -0,0 +1,8 @@
+#!/bin/sh
+cd ${0%/*} || exit 1    # run from this directory
+set -x
+
+wmake
+wmake buoyantSimpleRadiationFoam
+
+# ----------------------------------------------------------------- end-of-file

applications/solvers/heatTransfer/buoyantSimpleFoam/EEqn.H

@@ -0,0 +1,19 @@
+{
+    volScalarField& he = thermo.he();
+
+    fvScalarMatrix EEqn
+    (
+        fvm::div(phi, he)
+      + (
+            he.name() == "e"
+          ? fvc::div(phi, volScalarField("Ekp", 0.5*magSqr(U) + p/rho))
+          : fvc::div(phi, volScalarField("K", 0.5*magSqr(U)))
+        )
+      - fvm::laplacian(turbulence->alphaEff(), he)
+    );
+
+    EEqn.relax();
+    EEqn.solve();
+
+    thermo.correct();
+}

applications/solvers/heatTransfer/buoyantSimpleFoam/buoyantSimpleFoam.C

@@ -59,7 +59,7 @@ int main(int argc, char *argv[])
         // Pressure-velocity SIMPLE corrector
         {
             #include "UEqn.H"
-            #include "hEqn.H"
+            #include "EEqn.H"
             #include "pEqn.H"
         }
 

applications/solvers/heatTransfer/buoyantSimpleFoam/buoyantSimpleRadiationFoam/EEqn.H

@@ -0,0 +1,22 @@
+{
+    volScalarField& he = thermo.he();
+
+    fvScalarMatrix EEqn
+    (
+        fvm::div(phi, he)
+      + (
+            he.name() == "e"
+          ? fvc::div(phi, volScalarField("Ekp", 0.5*magSqr(U) + p/rho))
+          : fvc::div(phi, volScalarField("K", 0.5*magSqr(U)))
+        )
+      - fvm::laplacian(turbulence->alphaEff(), he)
+     ==
+        radiation->Sh(thermo)
+    );
+
+    EEqn.relax();
+    EEqn.solve();
+
+    thermo.correct();
+    radiation->correct();
+}

applications/solvers/heatTransfer/buoyantSimpleFoam/buoyantSimpleRadiationFoam/Make/files

@@ -1,4 +1,3 @@
 buoyantSimpleRadiationFoam.C
 
 EXE = $(FOAM_APPBIN)/buoyantSimpleRadiationFoam
-

applications/solvers/heatTransfer/buoyantSimpleFoam/buoyantSimpleRadiationFoam/Make/options

@@ -1,5 +1,5 @@
 EXE_INC = \
-    -I../buoyantSimpleFoam \
+    -I.. \
     -I$(LIB_SRC)/thermophysicalModels/basic/lnInclude \
     -I$(LIB_SRC)/thermophysicalModels/radiationModels/lnInclude \
     -I$(LIB_SRC)/turbulenceModels \

applications/solvers/heatTransfer/buoyantSimpleFoam/buoyantSimpleRadiationFoam/buoyantSimpleRadiationFoam.C

@@ -62,7 +62,7 @@ int main(int argc, char *argv[])
         // Pressure-velocity SIMPLE corrector
         {
             #include "UEqn.H"
-            #include "hEqn.H"
+            #include "EEqn.H"
             #include "pEqn.H"
         }
 

applications/solvers/heatTransfer/buoyantSimpleFoam/createFields.H

@@ -5,6 +5,7 @@
         psiThermo::New(mesh)
     );
     psiThermo& thermo = pThermo();
+    thermo.validate(args.executable(), "h", "e");
 
     volScalarField rho
     (
@@ -20,7 +21,6 @@
     );
 
     volScalarField& p = thermo.p();
-    volScalarField& h = thermo.he();
     const volScalarField& psi = thermo.psi();
 
     Info<< "Reading field U\n" << endl;

applications/solvers/heatTransfer/buoyantSimpleFoam/hEqn.H

@@ -1,15 +0,0 @@
-{
-    fvScalarMatrix hEqn
-    (
-        fvm::div(phi, h)
-      - fvm::Sp(fvc::div(phi), h)
-      - fvm::laplacian(turbulence->alphaEff(), h)
-     ==
-      - fvc::div(phi, 0.5*magSqr(U), "div(phi,K)")
-    );
-
-    hEqn.relax();
-    hEqn.solve();
-
-    thermo.correct();
-}

applications/solvers/heatTransfer/buoyantSimpleRadiationFoam/hEqn.H

@@ -1,19 +0,0 @@
-{
-    fvScalarMatrix hEqn
-    (
-        fvm::div(phi, h)
-      - fvm::Sp(fvc::div(phi), h)
-      - fvm::laplacian(turbulence->alphaEff(), h)
-     ==
-      - fvc::div(phi, 0.5*magSqr(U), "div(phi,K)")
-      + radiation->Sh(thermo)
-    );
-
-    hEqn.relax();
-
-    hEqn.solve();
-
-    thermo.correct();
-
-    radiation->correct();
-}

etc/controlDict

@@ -884,6 +884,7 @@ DebugSwitches
     wallHeatTransfer    0;
     wallLayerCells      0;
     wallModel           0;
+    warnUnboundedGauss  1;
     waveTransmissive    0;
     wedge               0;
     weighted            0;

src/finiteVolume/Make/files

@@ -345,6 +345,7 @@ convectionSchemes = finiteVolume/convectionSchemes
 $(convectionSchemes)/convectionScheme/convectionSchemes.C
 $(convectionSchemes)/gaussConvectionScheme/gaussConvectionSchemes.C
 $(convectionSchemes)/multivariateGaussConvectionScheme/multivariateGaussConvectionSchemes.C
+$(convectionSchemes)/boundedConvectionScheme/boundedConvectionSchemes.C
 
 laplacianSchemes = finiteVolume/laplacianSchemes
 $(laplacianSchemes)/laplacianScheme/laplacianSchemes.C

src/finiteVolume/finiteVolume/convectionSchemes/boundedConvectionScheme/boundedConvectionScheme.C

@@ -0,0 +1,103 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2012 OpenFOAM Foundation
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+\*---------------------------------------------------------------------------*/
+
+#include "boundedConvectionScheme.H"
+#include "fvcSurfaceIntegrate.H"
+#include "fvMatrices.H"
+#include "fvmSup.H"
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+namespace Foam
+{
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+namespace fv
+{
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+template<class Type>
+tmp<GeometricField<Type, fvsPatchField, surfaceMesh> >
+boundedConvectionScheme<Type>::interpolate
+(
+    const surfaceScalarField& phi,
+    const GeometricField<Type, fvPatchField, volMesh>& vf
+) const
+{
+    return scheme_().interpolate(phi, vf);
+}
+
+
+template<class Type>
+tmp<GeometricField<Type, fvsPatchField, surfaceMesh> >
+boundedConvectionScheme<Type>::flux
+(
+    const surfaceScalarField& faceFlux,
+    const GeometricField<Type, fvPatchField, volMesh>& vf
+) const
+{
+    return scheme_().flux(faceFlux, vf);
+}
+
+
+template<class Type>
+tmp<fvMatrix<Type> >
+boundedConvectionScheme<Type>::fvmDiv
+(
+    const surfaceScalarField& faceFlux,
+    const GeometricField<Type, fvPatchField, volMesh>& vf
+) const
+{
+    return
+        scheme_().fvmDiv(faceFlux, vf)
+      - fvm::Sp(fvc::surfaceIntegrate(faceFlux), vf);
+}
+
+
+template<class Type>
+tmp<GeometricField<Type, fvPatchField, volMesh> >
+boundedConvectionScheme<Type>::fvcDiv
+(
+    const surfaceScalarField& faceFlux,
+    const GeometricField<Type, fvPatchField, volMesh>& vf
+) const
+{
+    return
+        scheme_().fvcDiv(faceFlux, vf)
+      - fvc::surfaceIntegrate(faceFlux)*vf;
+}
+
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+} // End namespace fv
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+} // End namespace Foam
+
+// ************************************************************************* //

src/finiteVolume/finiteVolume/convectionSchemes/boundedConvectionScheme/boundedConvectionScheme.H

@@ -0,0 +1,150 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2012 OpenFOAM Foundation
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+Class
+    Foam::fv::boundedConvectionScheme
+
+Description
+    Bounded form of the selected convection scheme.
+
+    Boundedness is achieved by subtracting div(phi)*vf or Sp(div(phi), vf)
+    which is non-conservative if div(phi) != 0 but conservative otherwise.
+
+    Can be used for convection of bounded scalar properties in steady-state
+    solvers to improve stability if insufficient convergence of the pressure
+    equation causes temporary divergence of the flux field.
+
+SourceFiles
+    boundedConvectionScheme.C
+
+\*---------------------------------------------------------------------------*/
+
+#ifndef boundedConvectionScheme_H
+#define boundedConvectionScheme_H
+
+#include "convectionScheme.H"
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+namespace Foam
+{
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+namespace fv
+{
+
+/*---------------------------------------------------------------------------*\
+                       Class boundedConvectionScheme Declaration
+\*---------------------------------------------------------------------------*/
+
+template<class Type>
+class boundedConvectionScheme
+:
+    public fv::convectionScheme<Type>
+{
+    // Private data
+
+        tmp<fv::convectionScheme<Type> > scheme_;
+
+
+    // Private Member Functions
+
+        //- Disallow default bitwise copy construct
+        boundedConvectionScheme(const boundedConvectionScheme&);
+
+        //- Disallow default bitwise assignment
+        void operator=(const boundedConvectionScheme&);
+
+
+public:
+
+    //- Runtime type information
+    TypeName("bounded");
+
+
+    // Constructors
+
+        //- Construct from flux and Istream
+        boundedConvectionScheme
+        (
+            const fvMesh& mesh,
+            const surfaceScalarField& faceFlux,
+            Istream& is
+        )
+        :
+            convectionScheme<Type>(mesh, faceFlux),
+            scheme_
+            (
+                fv::convectionScheme<Type>::New(mesh, faceFlux, is)
+            )
+        {}
+
+
+    // Member Functions
+
+        tmp<GeometricField<Type, fvsPatchField, surfaceMesh> > interpolate
+        (
+            const surfaceScalarField&,
+            const GeometricField<Type, fvPatchField, volMesh>&
+        ) const;
+
+        tmp<GeometricField<Type, fvsPatchField, surfaceMesh> > flux
+        (
+            const surfaceScalarField&,
+            const GeometricField<Type, fvPatchField, volMesh>&
+        ) const;
+
+        tmp<fvMatrix<Type> > fvmDiv
+        (
+            const surfaceScalarField&,
+            const GeometricField<Type, fvPatchField, volMesh>&
+        ) const;
+
+        tmp<GeometricField<Type, fvPatchField, volMesh> > fvcDiv
+        (
+            const surfaceScalarField&,
+            const GeometricField<Type, fvPatchField, volMesh>&
+        ) const;
+};
+
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+} // End namespace fv
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+} // End namespace Foam
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+#ifdef NoRepository
+#   include "boundedConvectionScheme.C"
+#endif
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+#endif
+
+// ************************************************************************* //

src/finiteVolume/finiteVolume/convectionSchemes/boundedConvectionScheme/boundedConvectionSchemes.C

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2012 OpenFOAM Foundation
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+\*---------------------------------------------------------------------------*/
+
+#include "boundedConvectionScheme.H"
+#include "fvMesh.H"
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+namespace Foam
+{
+namespace fv
+{
+    makeFvConvectionScheme(boundedConvectionScheme)
+}
+}
+
+// ************************************************************************* //

src/finiteVolume/finiteVolume/convectionSchemes/gaussConvectionScheme/gaussConvectionScheme.H

@@ -47,6 +47,10 @@ namespace Foam
 namespace fv
 {
 
+//- Temporary debug switch to provide warning about backward-compatibility
+//  issue with setting div schemes for steady-state
+extern int warnUnboundedGauss;
+
 /*---------------------------------------------------------------------------*\
                        Class gaussConvectionScheme Declaration
 \*---------------------------------------------------------------------------*/
@@ -103,7 +107,29 @@ public:
             (
                 surfaceInterpolationScheme<Type>::New(mesh, faceFlux, is)
             )
-        {}
+        {
+            is.rewind();
+            word bounded(is);
+
+            if
+            (
+                warnUnboundedGauss
+             && word(mesh.ddtScheme("default")) == "steadyState"
+             && bounded != "bounded"
+            )
+            {
+                fileNameList controlDictFiles(findEtcFiles("controlDict"));
+
+                IOWarningIn("gaussConvectionScheme", is)
+                    << "Unbounded 'Gauss' div scheme used in "
+                       "steady-state solver, use 'bounded Gauss' "
+                       "to ensure boundedness.\n"
+                    << "    To remove this warning switch off "
+                    << "'boundedGauss' in "
+                    << controlDictFiles[controlDictFiles.size()-1]
+                    << endl;
+            }
+        }
 
 
     // Member Functions

src/finiteVolume/finiteVolume/convectionSchemes/gaussConvectionScheme/gaussConvectionSchemes.C

@@ -32,6 +32,11 @@ namespace Foam
 {
 namespace fv
 {
+    int warnUnboundedGauss
+    (
+        Foam::debug::debugSwitch("warnUnboundedGauss", true)
+    );
+
     makeFvConvectionScheme(gaussConvectionScheme)
 }
 }

src/thermophysicalModels/basic/basicThermo/basicThermo.C

@@ -164,6 +164,89 @@ Foam::basicThermo::~basicThermo()
 
 // * * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * //
 
+void Foam::basicThermo::validate
+(
+    const word& app,
+    const word& a
+) const
+{
+    if (!(he().name() == a))
+    {
+        FatalErrorIn(app)
+            << "Supported energy type is " << a
+            << ", thermodynamics package provides " << he().name()
+            << exit(FatalError);
+    }
+}
+
+void Foam::basicThermo::validate
+(
+    const word& app,
+    const word& a,
+    const word& b
+) const
+{
+    if (!(he().name() == a || he().name() == b))
+    {
+        FatalErrorIn(app)
+            << "Supported energy types are " << a << " and " << b
+            << ", thermodynamics package provides " << he().name()
+            << exit(FatalError);
+    }
+}
+
+void Foam::basicThermo::validate
+(
+    const word& app,
+    const word& a,
+    const word& b,
+    const word& c
+) const
+{
+    if
+    (
+       !(
+            he().name() == a
+         || he().name() == b
+         || he().name() == c
+        )
+    )
+    {
+        FatalErrorIn(app)
+            << "Supported energy types are " << a << ", " << b << " and " << c
+            << ", thermodynamics package provides " << he().name()
+            << exit(FatalError);
+    }
+}
+
+void Foam::basicThermo::validate
+(
+    const word& app,
+    const word& a,
+    const word& b,
+    const word& c,
+    const word& d
+) const
+{
+    if
+    (
+       !(
+            he().name() == a
+         || he().name() == b
+         || he().name() == c
+         || he().name() == d
+        )
+    )
+    {
+        FatalErrorIn(app)
+            << "Supported energy types are " << a << ", " << b
+            << ", " << c << " and " << d
+            << ", thermodynamics package provides " << he().name()
+            << exit(FatalError);
+    }
+}
+
+
 Foam::volScalarField& Foam::basicThermo::p()
 {
     return p_;

src/thermophysicalModels/basic/basicThermo/basicThermo.H

@@ -111,6 +111,45 @@ public:
 
     // Member functions
 
+        //- Check that the thermodynamics package is consistent
+        //  with energy forms supported by the application
+        void validate
+        (
+            const word& app,
+            const word&
+        ) const;
+
+        //- Check that the thermodynamics package is consistent
+        //  with energy forms supported by the application
+        void validate
+        (
+            const word& app,
+            const word&,
+            const word&
+        ) const;
+
+        //- Check that the thermodynamics package is consistent
+        //  with energy forms supported by the application
+        void validate
+        (
+            const word& app,
+            const word&,
+            const word&,
+            const word&
+        ) const;
+
+        //- Check that the thermodynamics package is consistent
+        //  with energy forms supported by the application
+        void validate
+        (
+            const word& app,
+            const word&,
+            const word&,
+            const word&,
+            const word&
+        ) const;
+
+
         //- Update properties
         virtual void correct() = 0;
 

src/thermophysicalModels/basic/mixtures/basicMixture/basicMixtures.C

@@ -142,6 +142,24 @@ makeBasicMixture
 
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
+makeBasicMixture
+(
+    pureMixture,
+    constTransport,
+    sensibleInternalEnergy,
+    eConstThermo,
+    perfectGas
+);
+
+makeBasicMixture
+(
+    pureMixture,
+    sutherlandTransport,
+    sensibleInternalEnergy,
+    eConstThermo,
+    perfectGas
+);
+
 makeBasicMixture
 (
     pureMixture,

src/thermophysicalModels/basic/psiThermo/hePsiThermo/hePsiThermos.C

@@ -84,27 +84,27 @@ makeThermo
 
 /* * * * * * * * * * * * * * Internal-energy-based * * * * * * * * * * * * * */
 
-// makeThermo
+makeThermo
-// (
+(
-//     psiThermo,
+    psiThermo,
-//     hePsiThermo,
+    hePsiThermo,
-//     pureMixture,
+    pureMixture,
-//     constTransport,
+    constTransport,
-//     sensibleInternalEnergy,
+    sensibleInternalEnergy,
-//     eConstThermo,
+    eConstThermo,
-//     perfectGas
+    perfectGas
-// );
+);
 
-// makeThermo
+makeThermo
-// (
+(
-//     psiThermo,
+    psiThermo,
-//     hePsiThermo,
+    hePsiThermo,
-//     pureMixture,
+    pureMixture,
-//     sutherlandTransport,
+    sutherlandTransport,
-//     sensibleInternalEnergy,
+    sensibleInternalEnergy,
-//     eConstThermo,
+    eConstThermo,
-//     perfectGas
+    perfectGas
-// );
+);
 
 makeThermo
 (

src/turbulenceModels/compressible/RAS/kEpsilon/kEpsilon.C

@@ -292,7 +292,7 @@ void kEpsilon::correct()
     (
         fvm::ddt(rho_, epsilon_)
       + fvm::div(phi_, epsilon_)
-      - fvm::Sp(fvc::ddt(rho_) + fvc::div(phi_), epsilon_)
+      //***HGW - fvm::Sp(fvc::ddt(rho_) + fvc::div(phi_), epsilon_)
       - fvm::laplacian(DepsilonEff(), epsilon_)
      ==
         C1_*G*epsilon_/k_
@@ -314,7 +314,7 @@ void kEpsilon::correct()
     (
         fvm::ddt(rho_, k_)
       + fvm::div(phi_, k_)
-      - fvm::Sp(fvc::ddt(rho_) + fvc::div(phi_), k_)
+      //***HGW - fvm::Sp(fvc::ddt(rho_) + fvc::div(phi_), k_)
       - fvm::laplacian(DkEff(), k_)
      ==
         G

tutorials/compressible/rhoCentralFoam/shockTube/constant/polyMesh/boundary

@@ -26,6 +26,7 @@ FoamFile
     empty
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          400;
         startFace       101;
     }

tutorials/compressible/sonicFoam/laminar/forwardStep/constant/polyMesh/boundary

@@ -32,12 +32,14 @@ FoamFile
     bottom
     {
         type            symmetryPlane;
+        inGroups        1(symmetryPlane);
         nFaces          25;
         startFace       10415;
     }
     top
     {
         type            symmetryPlane;
+        inGroups        1(symmetryPlane);
         nFaces          125;
         startFace       10440;
     }
@@ -50,6 +52,7 @@ FoamFile
     defaultFaces
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          10500;
         startFace       10675;
     }

tutorials/compressible/sonicFoam/laminar/forwardStep/system/fvSolution

@@ -17,7 +17,7 @@ FoamFile
 
 solvers
 {
-    p
+    "p.*"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -25,14 +25,14 @@ solvers
         relTol          0;
     }
 
-    "(U|e)"
+    "(U|e).*"
     {
         $p;
         tolerance       1e-05;
         relTol          0;
     }
 
-    rho
+    "rho.*"
     {
         solver          PCG;
         preconditioner  DIC;
@@ -41,9 +41,10 @@ solvers
     }
 }
 
-PISO
+PIMPLE
 {
-    nCorrectors     2;
+    nOuterCorrectors 2;
+    nCorrectors      1;
     nNonOrthogonalCorrectors 0;
 }
 

tutorials/compressible/sonicFoam/laminar/shockTube/constant/polyMesh/boundary

@@ -26,6 +26,7 @@ FoamFile
     empty
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          4000;
         startFace       1001;
     }

tutorials/compressible/sonicFoam/laminar/shockTube/system/fvSolution

@@ -17,7 +17,7 @@ FoamFile
 
 solvers
 {
-    "(p|U|e)"
+    "(p|U|e).*"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -25,7 +25,7 @@ solvers
         relTol          0;
     }
 
-    rho
+    "rho.*"
     {
         solver          PCG;
         preconditioner  DIC;
@@ -34,9 +34,10 @@ solvers
     }
 }
 
-PISO
+PIMPLE
 {
-    nCorrectors     2;
+    nOuterCorrectors     2;
+    nCorrectors          1;
     nNonOrthogonalCorrectors 0;
 }
 

tutorials/compressible/sonicFoam/ras/nacaAirfoil/constant/polyMesh/boundary

@@ -32,6 +32,7 @@ FoamFile
     SYMP3
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          80000;
         startFace       80170;
     }

tutorials/compressible/sonicFoam/ras/nacaAirfoil/system/fvSolution

@@ -17,12 +17,12 @@ FoamFile
 
 solvers
 {
-    rho
+    "rho.*"
     {
         solver          diagonal;
     }
 
-    p
+    "p.*"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -30,21 +30,22 @@ solvers
         relTol          0;
     }
 
-    "(U|e)"
+    "(U|e).*"
     {
         $p;
         tolerance       1e-9;
     }
 
-    "(k|epsilon)"
+    "(k|epsilon).*"
     {
         $p;
         tolerance       1e-10;
     }
 }
 
-PISO
+PIMPLE
 {
+    nOuterCorrectors 1;
     nCorrectors      2;
     nNonOrthogonalCorrectors 0;
 }

tutorials/compressible/sonicFoam/ras/prism/constant/polyMesh/boundary

@@ -50,6 +50,7 @@ FoamFile
     defaultFaces
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          13272;
         startFace       13463;
     }

tutorials/compressible/sonicFoam/ras/prism/system/fvSolution

@@ -17,12 +17,12 @@ FoamFile
 
 solvers
 {
-    rho
+    "rho.*"
     {
         solver          diagonal;
     }
 
-    p
+    "p.*"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -30,22 +30,23 @@ solvers
         relTol          0;
     }
 
-    "(U|e|R)"
+    "(U|e|R).*"
     {
         $p;
         tolerance       1e-05;
     }
 
-    "(k|epsilon)"
+    "(k|epsilon).*"
     {
         $p;
         tolerance       1e-08;
     }
 }
 
-PISO
+PIMPLE
 {
-    nCorrectors     2;
+    nOuterCorrectors 2;
+    nCorrectors      1;
     nNonOrthogonalCorrectors 0;
 }
 

tutorials/compressible/sonicLiquidFoam/decompressionTank/constant/polyMesh/boundary

@@ -26,6 +26,7 @@ FoamFile
     axis
     {
         type            symmetryPlane;
+        inGroups        1(symmetryPlane);
         nFaces          120;
         startFace       7500;
     }
@@ -38,12 +39,14 @@ FoamFile
     back
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          3725;
         startFace       7625;
     }
     front
     {
         type            empty;
+        inGroups        1(empty);
         nFaces          3725;
         startFace       11350;
     }

tutorials/compressible/sonicLiquidFoam/decompressionTank/system/fvSolution

@@ -17,7 +17,7 @@ FoamFile
 
 solvers
 {
-    p
+    "p.*"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -25,14 +25,14 @@ solvers
         relTol          0;
     }
 
-    U
+    "U.*"
     {
         $p;
         tolerance       1e-05;
         relTol          0;
     }
 
-    rho
+    "rho.*"
     {
         solver          PCG;
         preconditioner  DIC;
@@ -41,9 +41,10 @@ solvers
     }
 }
 
-PISO
+PIMPLE
 {
-    nCorrectors     2;
+    nOuterCorrectors 2;
+    nCorrectors      1;
     nNonOrthogonalCorrectors 0;
 }
 

tutorials/heatTransfer/buoyantPimpleFoam/hotRoom/constant/thermophysicalProperties

@@ -16,6 +16,7 @@ FoamFile
 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
 
 thermoType heRhoThermo<pureMixture<constTransport<specieThermo<hConstThermo<perfectGas>,sensibleEnthalpy>>>>;
+//thermoType heRhoThermo<pureMixture<constTransport<specieThermo<hConstThermo<perfectGas>,sensibleInternalEnergy>>>>;
 
 pRef            100000;
 

tutorials/heatTransfer/buoyantPimpleFoam/hotRoom/system/fvSchemes

@@ -30,23 +30,19 @@ divSchemes
     default         none;
     div(phi,U)      Gauss upwind;
     div(phi,h)      Gauss upwind;
+    div(phi,e)      Gauss upwind;
     div(phi,k)      Gauss upwind;
     div(phi,epsilon) Gauss upwind;
     div(phi,R)      Gauss upwind;
     div(phi,K)      Gauss linear;
+    div(phi,Ekp)    Gauss linear;
     div(R)          Gauss linear;
     div((muEff*dev2(T(grad(U))))) Gauss linear;
 }
 
 laplacianSchemes
 {
-    default         none;
+    default         Gauss linear corrected;
-    laplacian(muEff,U) Gauss linear corrected;
-    laplacian(Dp,p_rgh) Gauss linear corrected;
-    laplacian(alphaEff,h) Gauss linear corrected;
-    laplacian(DkEff,k) Gauss linear corrected;
-    laplacian(DepsilonEff,epsilon) Gauss linear corrected;
-    laplacian(DREff,R) Gauss linear corrected;
 }
 
 interpolationSchemes

tutorials/heatTransfer/buoyantPimpleFoam/hotRoom/system/fvSolution

@@ -39,7 +39,7 @@ solvers
         relTol          0;
     }
 
-    "(U|h|k|epsilon|R)"
+    "(U|h|e|k|epsilon|R)"
     {
         solver          PBiCG;
         preconditioner  DILU;
@@ -47,7 +47,7 @@ solvers
         relTol          0.1;
     }
 
-    "(U|h|k|epsilon|R)Final"
+    "(U|h|e|k|epsilon|R)Final"
     {
         $U;
         relTol          0;

tutorials/heatTransfer/buoyantSimpleFoam/hotRoom/constant/g

@@ -18,5 +18,4 @@ FoamFile
 dimensions      [0 1 -2 0 0 0 0];
 value           (0 -9.81 0);
 
-
 // ************************************************************************* //

tutorials/heatTransfer/buoyantSimpleFoam/hotRoom/system/fvSchemes

@@ -28,25 +28,17 @@ gradSchemes
 divSchemes
 {
     default         none;
-    div(phi,U)      Gauss upwind;
+    div(phi,U)      bounded Gauss upwind;
-    div(phi,h)      Gauss upwind;
+    div(phi,h)      bounded Gauss upwind;
-    div(phi,K)      Gauss upwind;
+    div(phi,K)      bounded Gauss upwind;
-    div(phi,k)      Gauss upwind;
+    div(phi,k)      bounded Gauss upwind;
-    div(phi,epsilon) Gauss upwind;
+    div(phi,epsilon) bounded Gauss upwind;
-    div(phi,R)      Gauss upwind;
-    div(R)          Gauss linear;
     div((muEff*dev2(T(grad(U))))) Gauss linear;
 }
 
 laplacianSchemes
 {
-    default         none;
+    default         Gauss linear uncorrected;
-    laplacian(muEff,U) Gauss linear uncorrected;
-    laplacian(Dp,p_rgh) Gauss linear uncorrected;
-    laplacian(alphaEff,h) Gauss linear uncorrected;
-    laplacian(DkEff,k) Gauss linear uncorrected;
-    laplacian(DepsilonEff,epsilon) Gauss linear uncorrected;
-    laplacian(DREff,R) Gauss linear uncorrected;
 }
 
 interpolationSchemes

tutorials/heatTransfer/buoyantSimpleFoam/hotRoom/system/fvSolution

@@ -21,15 +21,15 @@ solvers
     {
         solver          PCG;
         preconditioner  DIC;
-        tolerance       1e-08;
+        tolerance       1e-8;
         relTol          0.01;
     }
 
-    "(U|h|k|epsilon|R)"
+    "(U|h|e|k|epsilon|R)"
     {
         solver          PBiCG;
         preconditioner  DILU;
-        tolerance       1e-05;
+        tolerance       1e-6;
         relTol          0.1;
     }
 }
@@ -45,6 +45,7 @@ SIMPLE
         p_rgh           1e-2;
         U               1e-3;
         h               1e-3;
+        e               1e-3;
 
         // possibly check turbulence fields
         "(k|epsilon|omega)" 1e-3;
@@ -60,8 +61,8 @@ relaxationFactors
     }
     equations
     {
-        U               0.2;
+        U               0.3;
-        h               0.2;
+        "(h|e)"         0.3;
         "(k|epsilon|R)" 0.5;
     }
 }