diff --git a/src/finiteVolume/fields/fvPatchFields/basic/fixedValue/fixedValueFvPatchField.H b/src/finiteVolume/fields/fvPatchFields/basic/fixedValue/fixedValueFvPatchField.H index 65e7abea4ab6d0b7b36d0f2353bc6664ecdd59ce..9b787760d2c53c094226b7a2eb5c3b89c7451b17 100644 --- a/src/finiteVolume/fields/fvPatchFields/basic/fixedValue/fixedValueFvPatchField.H +++ b/src/finiteVolume/fields/fvPatchFields/basic/fixedValue/fixedValueFvPatchField.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 @@ -25,7 +25,17 @@ Class Foam::fixedValueFvPatchField Description - Foam::fixedValueFvPatchField + This boundary condition supplies a fixed value constraint, and is the base + class for a number of other boundary conditions. + + Example of the boundary condition specification: + \verbatim + myPatch + { + type fixedValue; + value uniform 0; // example for scalar field usage + } + \endverbatim SourceFiles fixedValueFvPatchField.C @@ -43,7 +53,7 @@ namespace Foam { /*---------------------------------------------------------------------------*\ - Class fixedValueFvPatch Declaration + Class fixedValueFvPatchField Declaration \*---------------------------------------------------------------------------*/ template<class Type> diff --git a/src/finiteVolume/fields/fvPatchFields/derived/fixedPressureCompressibleDensity/fixedPressureCompressibleDensityFvPatchScalarField.H b/src/finiteVolume/fields/fvPatchFields/derived/fixedPressureCompressibleDensity/fixedPressureCompressibleDensityFvPatchScalarField.H index a27409e94b9f29ee4c2df79f8ce880862a3946a1..67b4184da06cebf213c5d048fdc4a690348ea98d 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/fixedPressureCompressibleDensity/fixedPressureCompressibleDensityFvPatchScalarField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/fixedPressureCompressibleDensity/fixedPressureCompressibleDensityFvPatchScalarField.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 @@ -25,12 +25,25 @@ Class Foam::fixedPressureCompressibleDensityFvPatchScalarField Description - Calculate compressible density as a function of pressure and fluid - properties. + This boundary condition calculates a (liquid) compressible density as a + function of pressure and fluid properties: + + \f[ + rho = rholSat + psil*(p - pSat) + \f] + + where + \var rho = density [kg/m3] + \var rholSat = saturation liquid density + \var p = pressure [Pa] + \var pSat = saturation pressure [Pa] + + The variables \c rholSat, \c pSat and \c psil are retrieved from the + \c thermodynamicProperties dictionary. Example of the boundary condition specification: \verbatim - inlet + myPatch { type fixedPressureCompressibleDensity; p p; // Name of static pressure field diff --git a/src/finiteVolume/fields/fvPatchFields/derived/flowRateInletVelocity/flowRateInletVelocityFvPatchVectorField.H b/src/finiteVolume/fields/fvPatchFields/derived/flowRateInletVelocity/flowRateInletVelocityFvPatchVectorField.H index a4b48c762985683f97f69192740423473d0ac503..e0564e3a5a0f9b343573890aa55ceae683f58214 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/flowRateInletVelocity/flowRateInletVelocityFvPatchVectorField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/flowRateInletVelocity/flowRateInletVelocityFvPatchVectorField.H @@ -25,31 +25,42 @@ Class Foam::flowRateInletVelocityFvPatchVectorField Description - Describes a volumetric/mass flow normal vector boundary condition by its - magnitude as an integral over its area. + This boundary condition provides a velocity boundary condition, derived + from the flux (volumetric or mass-based), whose direction is assumed + to be normal to the patch. The basis of the patch (volumetric or mass) is determined by the - dimensions of the flux, phi. + dimensions of the flux, \c phi, and the value of the density field name, + \c rhoName entry. - If the flux is mass-based - - the current density is used to correct the velocity - - volumetric flow rate can be applied by setting the 'rho' entry to 'none' + For a mass-based flux: + \li if \c rhoName is a valid density field name, the flow rate is in kg/s + \li if \c rhoName is "none" the flow rate is in m3/s + + For a volumetric-based flux: + \li the flow rate is in m3/s Example of the boundary condition specification: \verbatim - inlet - { - type flowRateInletVelocity; - flowRate 0.2; // Volumetric/mass flow rate [m3/s or kg/s] - rho rho; // none | rho [m3/s or kg/s] - value uniform (0 0 0); // placeholder - } + myPatch + { + type flowRateInletVelocity; + flowRate 0.2; // Volumetric/mass flow rate [m3/s or kg/s] + rho rho; // none | rho [m3/s or kg/s] + value uniform (0 0 0); // placeholder + } \endverbatim -Note - - The value is positive inwards - - May not work correctly for transonic inlets - - Strange behaviour with potentialFoam since the U equation is not solved + The \c flowRate entry is a \c DataEntry type, meaning that it can be + specified as constant, a polynomial fuction of time, and ... + + \note + \li the value is positive into the domain (as an inlet) + \li may not work correctly for transonic inlets + \li strange behaviour with potentialFoam since the U equation is not solved + +SeeAlso + Foam::DataEntry SourceFiles flowRateInletVelocityFvPatchVectorField.C @@ -67,7 +78,7 @@ SourceFiles namespace Foam { /*---------------------------------------------------------------------------*\ - Class flowRateInletVelocityFvPatch Declaration + Class flowRateInletVelocityFvPatchVectorField Declaration \*---------------------------------------------------------------------------*/ class flowRateInletVelocityFvPatchVectorField diff --git a/src/finiteVolume/fields/fvPatchFields/derived/fluxCorrectedVelocity/fluxCorrectedVelocityFvPatchVectorField.H b/src/finiteVolume/fields/fvPatchFields/derived/fluxCorrectedVelocity/fluxCorrectedVelocityFvPatchVectorField.H index 6631d205b47be2f4ca988107ae04d362c259e6b1..00ea99bc37690e2c080279963c22d426c46fda6c 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/fluxCorrectedVelocity/fluxCorrectedVelocityFvPatchVectorField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/fluxCorrectedVelocity/fluxCorrectedVelocityFvPatchVectorField.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 @@ -25,10 +25,38 @@ Class Foam::fluxCorrectedVelocityFvPatchVectorField Description - Velocity outlet boundary condition for patches where the pressure is - specified. The outflow velocity is obtained by "zeroGradient" and then - corrected from the flux. If reverse flow is possible or expected use - the "pressureInletOutletVelocityFvPatchVectorField" BC instead. + This boundary condition provides a velocity outlet boundary condition for + patches where the pressure is specified. The outflow velocity is obtained + by "zeroGradient" and then corrected from the flux: + + \f[ + Up = Uc - n*(n.Uc) + n*phi/mag(Sf) + \f] + + where + \var Up = velocity at the patch [m/s] + \var Uc = velocity in cells adjacent to the patch [m/s] + \var n = patch normal vectors + \var phi = flux at the patch [m3/s or kg/s] + \var Sf = patch face area vectors [m2] + + Example of the boundary condition specification: + \verbatim + myPatch + { + type fluxCorrectedVelocity; + phi phi; // name of flux field (default = phi) + rho rho; // name of density field (default = rho) + } + \endverbatim + + \note + If reverse flow is possible or expected use the + pressureInletOutletVelocity condition instead. + +SeeAlso + Foam::zeroGradientFvPatchField + Foam::pressureInletOutletVelocityFvPatchVectorField SourceFiles fluxCorrectedVelocityFvPatchVectorField.C @@ -47,7 +75,7 @@ namespace Foam { /*---------------------------------------------------------------------------*\ - Class fluxCorrectedVelocityFvPatch Declaration + Class fluxCorrectedVelocityFvPatchVectorField Declaration \*---------------------------------------------------------------------------*/ class fluxCorrectedVelocityFvPatchVectorField @@ -56,7 +84,10 @@ class fluxCorrectedVelocityFvPatchVectorField { // Private data + //- Name of flux field word phiName_; + + //- Name of density field word rhoName_; diff --git a/src/finiteVolume/fields/fvPatchFields/derived/freestream/freestreamFvPatchField.H b/src/finiteVolume/fields/fvPatchFields/derived/freestream/freestreamFvPatchField.H index 50f3d136f0eb4ce95bfcb1f87c4c7e048eb75e2b..d6936c01c9b9d2112745f0f1e32e9823b0df871d 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/freestream/freestreamFvPatchField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/freestream/freestreamFvPatchField.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 @@ -25,7 +25,23 @@ Class Foam::freestreamFvPatchField Description - Foam::freestreamFvPatchField + This boundary condition provides a free-stream condition. It is a 'mixed' + condition derived from the \c inletOutlet condition, whereby the mode of + operation switches between fixed (free stream) value and zero gradient + based on the sign of the flux. + + Example of the boundary condition specification: + \verbatim + myPatch + { + type freestream; + phi phi; // name of the flux field (default = phi) + } + \endverbatim + +SeeAlso + Foam::mixedFvPatchField + Foam::inletOutletFvPatchField SourceFiles freestreamFvPatchField.C @@ -43,7 +59,7 @@ namespace Foam { /*---------------------------------------------------------------------------*\ - Class freestreamFvPatch Declaration + Class freestreamFvPatchField Declaration \*---------------------------------------------------------------------------*/ template<class Type> diff --git a/src/finiteVolume/fields/fvPatchFields/derived/freestreamPressure/freestreamPressureFvPatchScalarField.H b/src/finiteVolume/fields/fvPatchFields/derived/freestreamPressure/freestreamPressureFvPatchScalarField.H index 6323b678d7d165b48177720e22b9bdfd060bf6f4..6107208e19b9a3e954cf99a1d7dc4856c6e05bcb 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/freestreamPressure/freestreamPressureFvPatchScalarField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/freestreamPressure/freestreamPressureFvPatchScalarField.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 @@ -25,7 +25,24 @@ Class Foam::freestreamPressureFvPatchScalarField Description - Foam::freestreamPressureFvPatchScalarField + This boundary condition provides a free-stream condition for pressure. + It is a zero-gradient condition that constrains the flux across the patch + based on the free-stream velocity. + + Example of the boundary condition specification: + \verbatim + myPatch + { + type freestreamPressure; + } + \endverbatim + + \note + This condition is designed to operate with a freestream velocity condition + +SeeAlso + Foam::zeroGradientFvPatchField + Foam::freestreamFvPatchField SourceFiles freestreamPressureFvPatchScalarField.C @@ -44,7 +61,7 @@ namespace Foam { /*---------------------------------------------------------------------------*\ - Class freestreamPressureFvPatch Declaration + Class freestreamPressureFvPatchScalarField Declaration \*---------------------------------------------------------------------------*/ class freestreamPressureFvPatchScalarField diff --git a/src/genericPatchFields/genericFvPatchField/genericFvPatchField.H b/src/genericPatchFields/genericFvPatchField/genericFvPatchField.H index 3236c3f2b9fce7535e412b60074365651f8deb26..c032a32fc271966e1fd8dbff68ee6ee40e5c3285 100644 --- a/src/genericPatchFields/genericFvPatchField/genericFvPatchField.H +++ b/src/genericPatchFields/genericFvPatchField/genericFvPatchField.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 @@ -25,8 +25,12 @@ Class Foam::genericFvPatchField Description - A generic version of calculatedFvPatchField, useful as a fallback for - handling unknown patch types. + This boundary condition provides a generic version of the \c calculated + condition, useful as a fallback for handling unknown patch types. Not + generally applicable as a user-specified condition. + +SeeAlso + Foam::calculatedFvPatchField SourceFiles genericFvPatchField.C diff --git a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H index 2199242b59204e986489e4931eb2982a05bc8252..4eab608b80738965b2faf33b28ee71c9c95297fd 100644 --- a/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.H +++ b/src/thermophysicalModels/radiationModels/derivedFvPatchFields/greyDiffusiveRadiation/greyDiffusiveRadiationMixedFvPatchScalarField.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 @@ -25,7 +25,26 @@ Class Foam::greyDiffusiveRadiationMixedFvPatchScalarField Description - Radiation temperature specified + This boundary condition provides a grey-diffuse condition for radiation + intensity, \c I, for use with the finite-volume discrete-ordinates model + (fvDOM), in which the radiation temperature is retrieved from the + temperature field boundary condition. + + 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 + } + \endverbatim + +SeeAlso + Foam::radiation::fvDOM + Foam::radiationCoupledBase + Foam::mixedFvPatchField SourceFiles greyDiffusiveRadiationMixedFvPatchScalarField.C