buoyancyTurbSource.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration |
5  \\ / A nd | www.openfoam.com
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8  Copyright (C) 2020 OpenCFD Ltd.
9 -------------------------------------------------------------------------------
10 License
11  This file is part of OpenFOAM.
12 
13  OpenFOAM is free software: you can redistribute it and/or modify it
14  under the terms of the GNU General Public License as published by
15  the Free Software Foundation, either version 3 of the License, or
16  (at your option) any later version.
17 
18  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
19  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
21  for more details.
22 
23  You should have received a copy of the GNU General Public License
24  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
25 
26 \*---------------------------------------------------------------------------*/
27 
28 #include "buoyancyTurbSource.H"
29 #include "gravityMeshObject.H"
31 
32 // * * * * * * * * * * * * * Static Member Functions * * * * * * * * * * * * //
33 
34 namespace Foam
35 {
36 namespace fv
37 {
38  defineTypeNameAndDebug(buoyancyTurbSource, 0);
39  addToRunTimeSelectionTable(option, buoyancyTurbSource, dictionary);
40 }
41 }
42 
43 
44 // * * * * * * * * * * * * Private Member Functions * * * * * * * * * * * * //
45 
46 Foam::tmp<Foam::volScalarField::Internal> Foam::fv::buoyancyTurbSource::
47 B() const
48 {
49  const auto& alphat = mesh_.lookupObjectRef<volScalarField>(alphatName_);
50  const auto& T = mesh_.lookupObjectRef<volScalarField>(Tname_);
51 
52  // (BMA:Eq. 8)
53  return beta_*alphat()*(fvc::grad(T) & g_)();
54 }
55 
56 
57 void Foam::fv::buoyancyTurbSource::buoyancyTurbSourceEpsilon
58 (
59  fvMatrix<scalar>& eqn
60 ) const
61 {
62  const auto* turbPtr =
63  mesh_.findObject<turbulenceModel>
64  (
66  );
67  const dictionary& turbDict = turbPtr->coeffDict();
68  const dimensionedScalar C1(turbDict.getOrDefault<scalar>("C1", 1.44));
69  const dimensionedScalar Cmu(turbDict.getOrDefault<scalar>("Cmu", 0.09));
70 
71  const volScalarField& epsilon = eqn.psi();
72  const volScalarField::Internal& k = turbPtr->k()();
73  const volVectorField::Internal& U = turbPtr->U()();
74  const dimensionedScalar k0(k.dimensions(), SMALL);
75 
76  // (BMA:Eq. 9)
77  const vector gHat(g_.value()/mag(g_.value()));
78 
79  volScalarField::Internal v(gHat & U);
81  (
82  mag(U - gHat*v)
84  );
85 
86  // (BMA:Eq. 6)
87  eqn -= fvm::SuSp(C1*tanh(mag(u/v))*B()/(k + k0), epsilon);
88 }
89 
90 
91 void Foam::fv::buoyancyTurbSource::buoyancyTurbSourceOmega
92 (
93  fvMatrix<scalar>& eqn
94 ) const
95 {
96  const auto* turbPtr =
97  mesh_.findObject<turbulenceModel>
98  (
100  );
101 
102  const volScalarField::Internal& nut = turbPtr->nut()();
103  const auto& gamma =
104  mesh_.lookupObjectRef<volScalarField::Internal>
105  (
106  word(turbPtr->type() + ":gamma")
107  );
108 
109  // (Heuristic approximation to BMA:Eq. 6)
110  eqn -= gamma/(nut + dimensionedScalar(nut.dimensions(), SMALL))*B();
111 }
112 
113 
114 void Foam::fv::buoyancyTurbSource::buoyancyTurbSourceK
115 (
116  fvMatrix<scalar>& eqn
117 ) const
118 {
119  const volScalarField& k = eqn.psi();
120  const dimensionedScalar k0(k.dimensions(), SMALL);
121 
122  // (BMA: Eq. 5)
123  eqn -= fvm::Sp(B()/(k() + k0), k);
124 }
125 
126 
127 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
128 
130 (
131  const word& sourceName,
132  const word& modelType,
133  const dictionary& dict,
134  const fvMesh& mesh
135 )
136 :
137  cellSetOption(sourceName, modelType, dict, mesh),
138  isEpsilon_(false),
139  rhoName_(coeffs_.getOrDefault<word>("rho", "rho")),
140  alphatName_(coeffs_.getOrDefault<word>("alphat", "alphat")),
141  Tname_(coeffs_.getOrDefault<word>("T", "T")),
142  beta_
143  (
145  (
147  coeffs_.getCheckOrDefault<scalar>
148  (
149  "beta",
150  3.3e-3,
151  [&](const scalar x){ return x > SMALL; }
152  )
153  )
154  ),
155  g_
156  (
158  meshObjects::gravity::New(mesh_.time()).value()
159  )
160 {
161  if (mag(g_.value()) < SMALL)
162  {
164  << "Gravitational field cannot be equal to or less than zero"
165  << exit(FatalError);
166  }
167 
168  const auto* turbPtr =
169  mesh_.findObject<turbulenceModel>
170  (
172  );
173 
174  if (!turbPtr)
175  {
177  << "Unable to find a turbulence model."
178  << exit(FatalError);
179  }
180 
181  fieldNames_.setSize(2, "undefined");
182 
183  tmp<volScalarField> tepsilon = turbPtr->epsilon();
184  tmp<volScalarField> tomega = turbPtr->omega();
185 
186  if (!tepsilon.isTmp())
187  {
188  isEpsilon_ = true;
189  fieldNames_[0] = tepsilon().name();
190  }
191  else if (!tomega.isTmp())
192  {
193  isEpsilon_ = false;
194  fieldNames_[0] = tomega().name();
195  }
196  else
197  {
199  << "Unable to find an omega or epsilon field." << nl
200  << "buoyancyTurbSource needs an omega- or epsilon-based model."
201  << exit(FatalError);
202  }
203 
204  fieldNames_[1] = turbPtr->k()().name();
205  applied_.setSize(fieldNames_.size(), false);
206 
207  Log << " Applying buoyancyTurbSource to: "
208  << fieldNames_[0] << " and " << fieldNames_[1]
209  << endl;
210 }
211 
212 
213 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
214 
216 (
217  fvMatrix<scalar>& eqn,
218  const label fieldi
219 )
220 {
221  if (fieldi == 1)
222  {
223  buoyancyTurbSourceK(eqn);
224  return;
225  }
226 
227  if (isEpsilon_)
228  {
229  buoyancyTurbSourceEpsilon(eqn);
230  }
231  else
232  {
233  buoyancyTurbSourceOmega(eqn);
234  }
235 }
236 
237 
239 (
240  const volScalarField& rho,
241  fvMatrix<scalar>& eqn,
242  const label fieldi
243 )
244 {
245  if (fieldi == 1)
246  {
247  buoyancyTurbSourceK(geometricOneField(), rho, eqn, fieldi);
248  return;
249  }
250 }
251 
252 
254 (
255  const volScalarField& alpha,
256  const volScalarField& rho,
257  fvMatrix<scalar>& eqn,
258  const label fieldi
259 )
260 {
261  if (fieldi == 1)
262  {
263  buoyancyTurbSourceK(alpha, rho, eqn, fieldi);
264  return;
265  }
266 }
267 
268 
269 // ************************************************************************* //
Log
#define Log
Definition: PDRblock.C:35
Foam::dimless
const dimensionSet dimless(0, 0, 0, 0, 0, 0, 0)
Dimensionless.
Definition: dimensionSets.H:50
Foam::fvc::grad
tmp< GeometricField< typename outerProduct< vector, Type >::type, fvPatchField, volMesh >> grad(const GeometricField< Type, fvsPatchField, surfaceMesh > &ssf)
Definition: fvcGrad.C:54
Foam::word
A class for handling words, derived from Foam::string.
Definition: word.H:62
Foam::fv::cellSetOption
Intermediate abstract class for handling cell-set options for the derived fvOptions.
Definition: cellSetOption.H:163
Foam::dimLength
const dimensionSet dimLength(0, 1, 0, 0, 0, 0, 0)
Definition: dimensionSets.H:53
Foam::tmp
A class for managing temporary objects.
Definition: PtrList.H:61
Foam::dimVelocity
const dimensionSet dimVelocity
Foam::constant::atomic::alpha
const dimensionedScalar alpha
Fine-structure constant: default SI units: [].
Definition: readThermalProperties.H:212
Foam::fv::buoyancyTurbSource::addSup
virtual void addSup(fvMatrix< scalar > &eqn, const label fieldi)
Definition: buoyancyTurbSource.C:216
gravityMeshObject.H
Foam::turbulenceModel::propertiesName
static const word propertiesName
Default name of the turbulence properties dictionary.
Definition: turbulenceModel.H:100
B
static const Foam::dimensionedScalar B("", Foam::dimless, 18.678)
Foam::geometricOneField
A class representing the concept of a GeometricField of 1 used to avoid unnecessary manipulations for...
Definition: geometricOneField.H:55
Foam::tmp::isTmp
bool isTmp() const noexcept
Identical to is_pointer()
Definition: tmp.H:181
Foam::endl
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition: Ostream.H:350
rho
rho
Definition: readInitialConditions.H:88
Foam::fv::option::mesh_
const fvMesh & mesh_
Reference to the mesh database.
Definition: fvOption.H:139
buoyancyTurbSource.H
Foam::dimTime
const dimensionSet dimTime(0, 0, 1, 0, 0, 0, 0)
Definition: dimensionSets.H:54
Foam::fvm::SuSp
tmp< fvMatrix< Type > > SuSp(const volScalarField::Internal &, const GeometricField< Type, fvPatchField, volMesh > &)
Foam::fvm::Sp
tmp< fvMatrix< Type > > Sp(const volScalarField::Internal &, const GeometricField< Type, fvPatchField, volMesh > &)
Foam::compressible::turbulenceModel
ThermalDiffusivity< CompressibleTurbulenceModel< fluidThermo > > turbulenceModel
Definition: turbulentFluidThermoModel.H:63
Foam::tanh
dimensionedScalar tanh(const dimensionedScalar &ds)
Definition: dimensionedScalar.C:272
Foam::name
word name(const complex &c)
Return string representation of complex.
Definition: complex.C:76
Foam::GeometricField< scalar, fvPatchField, volMesh >::Internal
DimensionedField< scalar, volMesh > Internal
Type of the internal field from which this GeometricField is derived.
Definition: GeometricField.H:107
Foam::T
void T(FieldField< Field, Type > &f1, const FieldField< Field, Type > &f2)
Definition: FieldFieldFunctions.C:58
Foam::dimensionedScalar
dimensioned< scalar > dimensionedScalar
Dimensioned scalar obtained from generic dimensioned type.
Definition: dimensionedScalarFwd.H:43
Foam::volScalarField
GeometricField< scalar, fvPatchField, volMesh > volScalarField
Definition: volFieldsFwd.H:57
dict
dictionary dict
Definition: searchingEngine.H:14
Foam::turbulenceModel
Abstract base class for turbulence models (RAS, LES and laminar).
Definition: turbulenceModel.H:63
Foam::FatalError
error FatalError
Foam::dictionary
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:121
mesh
dynamicFvMesh & mesh
Definition: createDynamicFvMesh.H:6
addToRunTimeSelectionTable.H
Macros for easy insertion into run-time selection tables.
Foam::dimensioned< scalar >
Foam::fvMesh
Mesh data needed to do the Finite Volume discretisation.
Definition: fvMesh.H:83
Foam
Namespace for OpenFOAM.
Definition: atmBoundaryLayer.C:33
Foam::vector
Vector< scalar > vector
A scalar version of the templated Vector.
Definition: vector.H:51
Foam::exit
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:130
Foam::fv::buoyancyTurbSource::buoyancyTurbSource
buoyancyTurbSource(const word &sourceName, const word &modelType, const dictionary &dict, const fvMesh &mesh)
Construct from explicit source name and mesh.
Definition: buoyancyTurbSource.C:130
Foam::objectRegistry::lookupObjectRef
Type & lookupObjectRef(const word &name, const bool recursive=false) const
Definition: objectRegistryTemplates.C:478
fv
labelList fv(nPoints)
U
U
Definition: pEqn.H:72
FatalErrorInFunction
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:381
Foam::sqr
dimensionedSymmTensor sqr(const dimensionedVector &dv)
Definition: dimensionedSymmTensor.C:51
Foam::nl
constexpr char nl
Definition: Ostream.H:385
Foam::mag
dimensioned< typename typeOfMag< Type >::type > mag(const dimensioned< Type > &dt)
gamma
const scalar gamma
Definition: EEqn.H:9
k
label k
Boltzmann constant.
Definition: LISASMDCalcMethod2.H:41
x
x
Definition: LISASMDCalcMethod2.H:52
Foam::fvMatrix
A special matrix type and solver, designed for finite volume solutions of scalar equations....
Definition: fvPatchField.H:76
Foam::dimTemperature
const dimensionSet dimTemperature(0, 0, 0, 1, 0, 0, 0)
Definition: dimensionSets.H:55
Foam::fv::defineTypeNameAndDebug
defineTypeNameAndDebug(atmAmbientTurbSource, 0)
epsilon
scalar epsilon
Definition: evaluateNearWall.H:7
Foam::fv::addToRunTimeSelectionTable
addToRunTimeSelectionTable(option, atmAmbientTurbSource, dictionary)
nut
scalar nut
Definition: evaluateNearWall.H:5
Foam::GeometricField< scalar, fvPatchField, volMesh >
Foam::meshObjects::gravity::New
static const gravity & New(const Time &runTime)
Construct on Time.
Definition: gravityMeshObject.H:93