From 5e86700b8571f7ecc5939d5be0f4bdda783f7ffa Mon Sep 17 00:00:00 2001
From: andy <andy>
Date: Fri, 13 Jul 2012 16:16:50 +0100
Subject: [PATCH] ENH: Added doxygen documentation for thermo BCs

---
 .../fvPatchFields/doc/boundaryConditions.dox  | 31 ++++++++++++++----
 .../doc/thermophysicalBoundaryConditionsDoc.H | 31 ++++++++++++++++++
 .../energyJump/energyJumpFvPatchScalarField.H | 27 ++++++++++++++--
 .../fixedEnergyFvPatchScalarField.H           | 21 ++++++++++--
 .../gradientEnergyFvPatchScalarField.H        | 22 +++++++++++--
 .../mixedEnergyFvPatchScalarField.H           | 10 ++++--
 .../wallHeatTransferFvPatchScalarField.H      | 32 ++++++++++++++++---
 .../MarshakRadiationFvPatchScalarField.C      |  6 ++--
 .../MarshakRadiationFvPatchScalarField.H      | 26 +++++++++++----
 ...iationFixedTemperatureFvPatchScalarField.H | 26 +++++++++++----
 ...iffusiveRadiationMixedFvPatchScalarField.C |  8 ++---
 ...iffusiveRadiationMixedFvPatchScalarField.H | 27 +++++++++++-----
 ...veViewFactorFixedValueFvPatchScalarField.H | 29 +++++++++++------
 ...iffusiveRadiationMixedFvPatchScalarField.C |  7 ++--
 ...iffusiveRadiationMixedFvPatchScalarField.H | 25 +++++++++++++--
 15 files changed, 265 insertions(+), 63 deletions(-)
 create mode 100644 src/thermophysicalModels/basic/derivedFvPatchFields/doc/thermophysicalBoundaryConditionsDoc.H

diff --git a/src/finiteVolume/fields/fvPatchFields/doc/boundaryConditions.dox b/src/finiteVolume/fields/fvPatchFields/doc/boundaryConditions.dox
index 89aef25aa3e..b8787fe010d 100644
--- a/src/finiteVolume/fields/fvPatchFields/doc/boundaryConditions.dox
+++ b/src/finiteVolume/fields/fvPatchFields/doc/boundaryConditions.dox
@@ -27,13 +27,32 @@ License
 
 \ref grpBoundaryConditions
 
+
 \section secBoundaryConditionsOverview Overview
 
-- \ref grpConstraintBoundaryConditions
-- \ref grpInletBoundaryConditions
-- \ref grpOutletBoundaryConditions
-- \ref grpGenericBoundaryConditions
-- \ref grpCoupledBoundaryConditions
-- \ref grpWallBoundaryConditions
+\subsection secBC1 Basic boundary conditions
+    - \ref grpConstraintBoundaryConditions
+    - \ref grpInletBoundaryConditions
+    - \ref grpOutletBoundaryConditions
+    - \ref grpGenericBoundaryConditions
+    - \ref grpCoupledBoundaryConditions
+    - \ref grpWallBoundaryConditions
+
+\subsection secBC2 Turbulent flow boundary conditions
+    - \ref grpIcoRASBoundaryConditions
+    - \ref grpCmpRASBoundaryConditions
+
+\subsection secBC3 Thermophysical boundary conditions
+    - \ref grpThermoBoundaryConditions
+
+
+\section secWallFunctions Wall functions
+
+Wall functions for incompressible flow
+    - \ref grpIcoWallFunctions
+
+Wall functions for compressible flow
+    - \ref grpCmpWallFunctions
+
 
 \*---------------------------------------------------------------------------*/
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/doc/thermophysicalBoundaryConditionsDoc.H b/src/thermophysicalModels/basic/derivedFvPatchFields/doc/thermophysicalBoundaryConditionsDoc.H
new file mode 100644
index 00000000000..610d5544548
--- /dev/null
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/doc/thermophysicalBoundaryConditionsDoc.H
@@ -0,0 +1,31 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  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/>.
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+\defgroup grpThermoBoundaryConditions Thermophysical boundary conditions
+@{
+    This group contains thermophysical model boundary conditions
+@}
+
+\*---------------------------------------------------------------------------*/
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/energyJump/energyJumpFvPatchScalarField.H b/src/thermophysicalModels/basic/derivedFvPatchFields/energyJump/energyJumpFvPatchScalarField.H
index 6fb7820ee3c..806c33e6c32 100644
--- a/src/thermophysicalModels/basic/derivedFvPatchFields/energyJump/energyJumpFvPatchScalarField.H
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/energyJump/energyJumpFvPatchScalarField.H
@@ -24,7 +24,31 @@ License
 Class
     Foam::energyJumpFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions grpCoupledBoundaryConditions
+
 Description
+    This boundary condition provides an energy jump condition across a pair
+    of coupled patches.
+
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        jump         | energy jump values      | yes         |
+    /endtable
+
+    Example of the boundary condition specification:
+    \verbatim
+    myPatch
+    {
+        type            energyJump;
+        jump            uniform 100;
+    }
+    \endverbatim
+
+SeeAlso
+    Foam::fixedJumpFvPatchField
 
 SourceFiles
     energyJumpFvPatchScalarField.C
@@ -43,7 +67,7 @@ namespace Foam
 {
 
 /*---------------------------------------------------------------------------*\
-                    Class energyJumpFvPatchScalarField Declaration
+                Class energyJumpFvPatchScalarField Declaration
 \*---------------------------------------------------------------------------*/
 
 class energyJumpFvPatchScalarField
@@ -120,7 +144,6 @@ public:
 
     // Member functions
 
-
         // Evaluation functions
 
             //- Update the coefficients
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/fixedEnergy/fixedEnergyFvPatchScalarField.H b/src/thermophysicalModels/basic/derivedFvPatchFields/fixedEnergy/fixedEnergyFvPatchScalarField.H
index 2c3b83ed601..a86577d02ae 100644
--- a/src/thermophysicalModels/basic/derivedFvPatchFields/fixedEnergy/fixedEnergyFvPatchScalarField.H
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/fixedEnergy/fixedEnergyFvPatchScalarField.H
@@ -24,8 +24,25 @@ License
 Class
     Foam::fixedEnergyFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions
+
 Description
-    A fixed boundary condition for internal energy
+    This boundary condition provides a fixed condition for internal energy
+
+    /heading Patch usage
+
+    Example of the boundary condition specification:
+    \verbatim
+    myPatch
+    {
+        type            fixedEnergy;
+        value           uniform 100;
+    }
+    \endverbatim
+
+SeeAlso
+    Foam::fixedValueFvPatchField
 
 SourceFiles
     fixedEnergyFvPatchScalarField.C
@@ -43,7 +60,7 @@ namespace Foam
 {
 
 /*---------------------------------------------------------------------------*\
-              Class fixedEnergyFvPatchScalarField Declaration
+               Class fixedEnergyFvPatchScalarField Declaration
 \*---------------------------------------------------------------------------*/
 
 class fixedEnergyFvPatchScalarField
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/gradientEnergy/gradientEnergyFvPatchScalarField.H b/src/thermophysicalModels/basic/derivedFvPatchFields/gradientEnergy/gradientEnergyFvPatchScalarField.H
index 6a5bc19f9e7..074a8b2f800 100644
--- a/src/thermophysicalModels/basic/derivedFvPatchFields/gradientEnergy/gradientEnergyFvPatchScalarField.H
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/gradientEnergy/gradientEnergyFvPatchScalarField.H
@@ -22,10 +22,26 @@ License
     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
 Class
-    Foam::gradientInternalEnergyFvPatchScalarField
+    Foam::gradientEnergyFvPatchScalarField
+
+Group
+    grpThermoBoundaryConditions
 
 Description
-    Gradient boundary condition for internal energy
+    This boundary condition provides a gradient condition for internal energy
+
+    /heading Patch usage
+    Example of the boundary condition specification:
+    \verbatim
+    myPatch
+    {
+        type            gradientEnergy;
+        gradient        uniform 10;
+    }
+    \endverbatim
+
+SeeAlso
+    Foam::fixedGradientFvPatchField
 
 SourceFiles
     gradientEnergyFvPatchScalarField.C
@@ -43,7 +59,7 @@ namespace Foam
 {
 
 /*---------------------------------------------------------------------------*\
-          Class gradientEnergyFvPatchScalarField Declaration
+             Class gradientEnergyFvPatchScalarField Declaration
 \*---------------------------------------------------------------------------*/
 
 class gradientEnergyFvPatchScalarField
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/mixedEnergy/mixedEnergyFvPatchScalarField.H b/src/thermophysicalModels/basic/derivedFvPatchFields/mixedEnergy/mixedEnergyFvPatchScalarField.H
index 204e7c29382..97c55cbd1eb 100644
--- a/src/thermophysicalModels/basic/derivedFvPatchFields/mixedEnergy/mixedEnergyFvPatchScalarField.H
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/mixedEnergy/mixedEnergyFvPatchScalarField.H
@@ -24,8 +24,14 @@ License
 Class
     Foam::mixedEnergyFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions
+
 Description
-    Mixed boundary conditions for internal energy
+    This boundary condition provides a mixed condition for internal energy
+
+SeeAlso
+    Foam::mixedFvPatchField
 
 SourceFiles
     mixedEnergyFvPatchScalarField.C
@@ -43,7 +49,7 @@ namespace Foam
 {
 
 /*---------------------------------------------------------------------------*\
-            Class mixedEnergyFvPatchScalarField Declaration
+               Class mixedEnergyFvPatchScalarField Declaration
 \*---------------------------------------------------------------------------*/
 
 class mixedEnergyFvPatchScalarField
diff --git a/src/thermophysicalModels/basic/derivedFvPatchFields/wallHeatTransfer/wallHeatTransferFvPatchScalarField.H b/src/thermophysicalModels/basic/derivedFvPatchFields/wallHeatTransfer/wallHeatTransferFvPatchScalarField.H
index 3a30ea1660f..8661df5c616 100644
--- a/src/thermophysicalModels/basic/derivedFvPatchFields/wallHeatTransfer/wallHeatTransferFvPatchScalarField.H
+++ b/src/thermophysicalModels/basic/derivedFvPatchFields/wallHeatTransfer/wallHeatTransferFvPatchScalarField.H
@@ -2,7 +2,7 @@
   =========                 |
   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
    \\    /   O peration     |
-    \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+    \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
 License
@@ -24,8 +24,30 @@ License
 Class
     Foam::wallHeatTransferFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions grpWallBoundaryConditions
+
 Description
-    Enthalpy boundary conditions for wall heat transfer
+    This boundary condition provides an enthalpy condition for wall heat
+    transfer
+
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        Tinf         | wall temperature        | yes         |
+        alphaWall    | thermal diffusivity     | yes         |
+    /endtable
+
+    Example of the boundary condition specification:
+    \verbatim
+    myPatch
+    {
+        type            wallHeatTransfer;
+        Tif             uniform 500;
+        alphaWall       uniform 1;
+    }
+    \endverbatim
 
 SourceFiles
     wallHeatTransferFvPatchScalarField.C
@@ -43,7 +65,7 @@ namespace Foam
 {
 
 /*---------------------------------------------------------------------------*\
-                  Class wallHeatTransferFvPatch Declaration
+            Class wallHeatTransferFvPatchScalarField Declaration
 \*---------------------------------------------------------------------------*/
 
 class wallHeatTransferFvPatchScalarField
@@ -52,10 +74,10 @@ class wallHeatTransferFvPatchScalarField
 {
     // Private data
 
-        //- Tinf
+        //- Temperature at the wall
         scalarField Tinf_;
 
-        //- alphaWall
+        //- Thermal diffusivity at the wall
         scalarField alphaWall_;
 
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.C b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.C
index 9bd7d0f8276..2bd7a38f3d7 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.C
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.C
@@ -40,7 +40,7 @@ Foam::MarshakRadiationFvPatchScalarField::MarshakRadiationFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, "undefined", scalarField::null()),
-    TName_("undefined")
+    TName_("T")
 {
     refValue() = 0.0;
     refGrad() = 0.0;
@@ -76,7 +76,7 @@ Foam::MarshakRadiationFvPatchScalarField::MarshakRadiationFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, dict),
-    TName_(dict.lookup("T"))
+    TName_(dict.lookupOrDefault<word>("T", "T"))
 {
     if (dict.found("value"))
     {
@@ -191,7 +191,7 @@ void Foam::MarshakRadiationFvPatchScalarField::write(Ostream& os) const
 {
     mixedFvPatchScalarField::write(os);
     radiationCoupledBase::write(os);
-    os.writeKeyword("T") << TName_ << token::END_STATEMENT << nl;
+    writeEntryIfDifferent<word>(os, "T", "T", TName_);
 }
 
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.H
index bb159c3b8be..5d9de5c2138 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.H
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiation/MarshakRadiationFvPatchScalarField.H
@@ -24,6 +24,9 @@ License
 Class
     Foam::MarshakRadiationFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions
+
 Description
     A 'mixed' boundary condition that implements a Marshak condition for the
     incident radiation field (usually written as G)
@@ -31,16 +34,27 @@ Description
     The radiation temperature is retrieved from the mesh database, using a
     user specified temperature field name.
 
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        T            | temperature field name  | no          | T
+    /endtable
+
     Example of the boundary condition specification:
     \verbatim
-        myPatch
-        {
-            type            MarshakRadiation;
-            T               T;                  // name of temperature field
-            value           uniform 0;          // optional value entry
-        }
+    myPatch
+    {
+        type            MarshakRadiation;
+        T               T;
+        value           uniform 0;
+    }
     \endverbatim
 
+SeeAlso
+    Foam::radiationCoupledBase
+    Foam::mixedFvPatchField
+
 SourceFiles
     MarshakRadiationFvPatchScalarField.C
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiationFixedTemperature/MarshakRadiationFixedTemperatureFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiationFixedTemperature/MarshakRadiationFixedTemperatureFvPatchScalarField.H
index 32b003ccd00..b2b913c7637 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiationFixedTemperature/MarshakRadiationFixedTemperatureFvPatchScalarField.H
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/MarshakRadiationFixedTemperature/MarshakRadiationFixedTemperatureFvPatchScalarField.H
@@ -24,6 +24,9 @@ License
 Class
     Foam::MarshakRadiationFixedTemperatureFvPatchScalarField
 
+Group
+    grpThermoBoundaryConditions
+
 Description
     A 'mixed' boundary condition that implements a Marshak condition for the
     incident radiation field (usually written as G)
@@ -31,16 +34,27 @@ Description
     The radiation temperature field across the patch is supplied by the user
     using the \c Trad entry.
 
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        T            | temperature field name  | no          | T
+    /endtable
+
     Example of the boundary condition specification:
     \verbatim
-        myPatch
-        {
-            type            MarshakRadiationFixedT;
-            Trad            uniform 1000;       // radiation temperature field
-            value           uniform 0;          // place holder
-        }
+    myPatch
+    {
+        type            MarshakRadiationFixedTemperature;
+        Trad            uniform 1000;       // radiation temperature field
+        value           uniform 0;          // place holder
+    }
     \endverbatim
 
+SeeAlso
+    Foam::radiationCoupledBase
+    Foam::mixedFvPatchField
+
 SourceFiles
     MarshakRadiationFixedTemperatureFvPatchScalarField.C
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.C b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.C
index 02637c203a1..5817279076f 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.C
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.C
@@ -2,7 +2,7 @@
   =========                 |
   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
    \\    /   O peration     |
-    \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+    \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
 License
@@ -45,7 +45,7 @@ greyDiffusiveRadiationMixedFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, "undefined", scalarField::null()),
-    TName_("undefinedT")
+    TName_("T")
 {
     refValue() = 0.0;
     refGrad() = 0.0;
@@ -83,7 +83,7 @@ greyDiffusiveRadiationMixedFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, dict),
-    TName_(dict.lookup("T"))
+    TName_(dict.lookupOrDefault<word>("T", "T"))
 {
     if (dict.found("refValue"))
     {
@@ -262,7 +262,7 @@ void Foam::radiation::greyDiffusiveRadiationMixedFvPatchScalarField::write
 {
     mixedFvPatchScalarField::write(os);
     radiationCoupledBase::write(os);
-    os.writeKeyword("T") << TName_ << token::END_STATEMENT << nl;
+    writeEntryIfDifferent<word>(os, "T", "T", TName_);
 }
 
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H
index 51dd2d4ad3d..cdd4b09a051 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H
@@ -22,7 +22,10 @@ License
     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
 Class
-    Foam::greyDiffusiveRadiationMixedFvPatchScalarField
+    Foam::radiation::greyDiffusiveRadiationMixedFvPatchScalarField
+
+Group
+    grpThermoBoundaryConditions
 
 Description
     This boundary condition provides a grey-diffuse condition for radiation
@@ -30,15 +33,23 @@ Description
     (fvDOM), in which the radiation temperature is retrieved from the
     temperature field boundary condition.
 
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        T            | temperature field name  | no          | T
+        emissivityMode | emissivity mode: solidThermo or lookup | yes |
+    /endtable
+
     Example of the boundary condition specification:
     \verbatim
-        myPatch
-        {
-            type            greyDiffusiveRadiation;
-            T               T;              // name of temperature field
-            emissivityMode  solidThermo;    // solidThermo | lookup
-            value           uniform 0;      // initial value
-        }
+    myPatch
+    {
+        type            greyDiffusiveRadiation;
+        T               T;
+        emissivityMode  solidThermo;
+        value           uniform 0;
+    }
     \endverbatim
 
 SeeAlso
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveViewFactor/greyDiffusiveViewFactorFixedValueFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveViewFactor/greyDiffusiveViewFactorFixedValueFvPatchScalarField.H
index e2ada393e9d..3197e50c2e3 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveViewFactor/greyDiffusiveViewFactorFixedValueFvPatchScalarField.H
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveViewFactor/greyDiffusiveViewFactorFixedValueFvPatchScalarField.H
@@ -2,7 +2,7 @@
   =========                 |
   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
    \\    /   O peration     |
-    \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+    \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
 License
@@ -22,21 +22,32 @@ License
     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
 Class
-    Foam::greyDiffusiveViewFactorFixedValueFvPatchScalarField
+    Foam::radiation::greyDiffusiveViewFactorFixedValueFvPatchScalarField
+
+Group
+    grpThermoBoundaryConditions
 
 Description
     This boundary condition provides a grey-diffuse condition for radiative
     heat flux, \c Qr, for use with the view factor model
 
+    /heading Patch usage
+
+    /table
+        Property     | Description             | Required    | Default value
+        Qro          | external radiative heat flux | yes    |
+        emissivityMode | emissivity mode: solidThermo or lookup | yes |
+    /endtable
+
     Example of the boundary condition specification:
     \verbatim
-        myPatch
-        {
-            type            greyDiffusiveRadiationViewFactor;
-            Qro             uniform 0;      // external radiative heat flux
-            emissivityMode  solidThermo;    // solidThermo | lookup
-            value           uniform 0;      // initial value
-        }
+    myPatch
+    {
+        type            greyDiffusiveRadiationViewFactor;
+        Qro             uniform 0;
+        emissivityMode  solidThermo;
+        value           uniform 0;
+    }
     \endverbatim
 
 SeeAlso
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.C b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.C
index ff0bb83b460..e6e7b4b2259 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.C
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.C
@@ -46,7 +46,7 @@ wideBandDiffusiveRadiationMixedFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, "undefined", scalarField::null()),
-    TName_("undefinedT")
+    TName_("T")
 {
     refValue() = 0.0;
     refGrad() = 0.0;
@@ -84,7 +84,7 @@ wideBandDiffusiveRadiationMixedFvPatchScalarField
 :
     mixedFvPatchScalarField(p, iF),
     radiationCoupledBase(p, dict),
-    TName_(dict.lookup("T"))
+    TName_(dict.lookupOrDefault<word>("T", "T"))
 {
     if (dict.found("value"))
     {
@@ -249,8 +249,7 @@ void Foam::radiation::wideBandDiffusiveRadiationMixedFvPatchScalarField::write
 {
     mixedFvPatchScalarField::write(os);
     radiationCoupledBase::write(os);
-    os.writeKeyword("T") << TName_ << token::END_STATEMENT << nl;
-
+    writeEntryIfDifferent<word>(os, "T", "T", TName_);
 }
 
 
diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.H
index cd9fb9aeced..f23cd3e6e27 100644
--- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.H
+++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/wideBandDiffusiveRadiation/wideBandDiffusiveRadiationMixedFvPatchScalarField.H
@@ -2,7 +2,7 @@
   =========                 |
   \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
    \\    /   O peration     |
-    \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+    \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
 License
@@ -22,10 +22,29 @@ License
     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
 Class
-    Foam::wideBandDiffusiveRadiationMixedFvPatchScalarField
+    Foam::radiation::wideBandDiffusiveRadiationMixedFvPatchScalarField
+
+Group
+    grpThermoBoundaryConditions
 
 Description
-    Radiation temperature specified
+    This boundary condition provides a wide-band, diffusive radiation
+    condition, where the patch temperature is specified.
+
+    /heading Patch usage
+
+    Example of the boundary condition specification:
+    \verbatim
+    myPatch
+    {
+        type            wideBandDiffusiveRadiation;
+        value           uniform 0;
+    }
+    \endverbatim
+
+SeeAlso
+    Foam::mixedFvPatchScalarField
+    Foam::radiationCoupledBase
 
 SourceFiles
     wideBandDiffusiveRadiationMixedFvPatchScalarField.C
-- 
GitLab