realizableKE.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration | Website: https://openfoam.org
5  \\ / A nd | Copyright (C) 2011-2026 OpenFOAM Foundation
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8 License
9  This file is part of OpenFOAM.
10 
11  OpenFOAM is free software: you can redistribute it and/or modify it
12  under the terms of the GNU General Public License as published by
13  the Free Software Foundation, either version 3 of the License, or
14  (at your option) any later version.
15 
16  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
17  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19  for more details.
20 
21  You should have received a copy of the GNU General Public License
22  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
23 
24 \*---------------------------------------------------------------------------*/
25 
26 #include "realizableKE.H"
27 #include "fvModels.H"
28 #include "fvConstraints.H"
29 #include "bound.H"
30 
31 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
32 
33 namespace Foam
34 {
35 namespace RASModels
36 {
37 
38 // * * * * * * * * * * * Protected Member Functions * * * * * * * * * * * * //
39 
40 template<class BasicMomentumTransportModel>
42 {
43  epsilon_ = max(epsilon_, 0.09*sqr(k_)/(this->nutMaxCoeff_*this->nu()));
44 }
45 
46 
47 template<class BasicMomentumTransportModel>
49 (
50  const volTensorField& gradU,
51  const volScalarField& S2,
52  const volScalarField& magS
53 )
54 {
55  tmp<volSymmTensorField> tS = dev(symm(gradU));
56  const volSymmTensorField& S = tS();
57 
58  const volScalarField W
59  (
60  (2*sqrt(2.0))*((S&S)&&S)
61  /(
62  magS*S2
63  + dimensionedScalar(dimensionSet(0, 0, -3, 0, 0), small)
64  )
65  );
66 
67  tS.clear();
68 
69  const volScalarField phis
70  (
71  (1.0/3.0)*acos(min(max(sqrt(6.0)*W, -scalar(1)), scalar(1)))
72  );
73  const volScalarField As(sqrt(6.0)*cos(phis));
74  const volScalarField Us(sqrt(S2/2.0 + magSqr(skew(gradU))));
75 
76  return 1.0/(A0_ + As*Us*k_/epsilon_);
77 }
78 
79 
80 template<class BasicMomentumTransportModel>
82 (
83  const volTensorField& gradU,
84  const volScalarField& S2,
85  const volScalarField& magS
86 )
87 {
88  boundEpsilon();
89  this->nut_ = rCmu(gradU, S2, magS)*sqr(k_)/epsilon_;
90  this->nut_.correctBoundaryConditions();
91  fvConstraints::New(this->mesh_).constrain(this->nut_);
92 }
93 
94 
95 template<class BasicMomentumTransportModel>
97 {
98  const volTensorField gradU(fvc::grad(this->U_));
99  const volScalarField S2(typedName("S2"), 2*magSqr(dev(symm(gradU))));
100  const volScalarField magS(typedName("magS"), sqrt(S2));
101 
102  correctNut(gradU, S2, magS);
103 }
104 
105 
106 template<class BasicMomentumTransportModel>
108 {
109  return tmp<fvScalarMatrix>
110  (
111  new fvScalarMatrix
112  (
113  k_,
114  dimVolume*this->rho_.dimensions()*k_.dimensions()
115  /dimTime
116  )
117  );
118 }
119 
120 
121 template<class BasicMomentumTransportModel>
124 {
125  return tmp<fvScalarMatrix>
126  (
127  new fvScalarMatrix
128  (
129  epsilon_,
130  dimVolume*this->rho_.dimensions()*epsilon_.dimensions()
131  /dimTime
132  )
133  );
134 }
135 
136 
137 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
138 
139 template<class BasicMomentumTransportModel>
141 (
142  const alphaField& alpha,
143  const rhoField& rho,
144  const volVectorField& U,
145  const surfaceScalarField& alphaRhoPhi,
146  const surfaceScalarField& phi,
147  const viscosity& viscosity,
148  const word& type
149 )
150 :
151  eddyViscosity<RASModel<BasicMomentumTransportModel>>
152  (
153  type,
154  alpha,
155  rho,
156  U,
157  alphaRhoPhi,
158  phi,
159  viscosity
160  ),
161 
162  A0_("A0", this->typeDict(type), 4.0),
163  C2_
164  ("C2", this->typeDict(type), 1.9),
165  sigmak_("sigmak", this->typeDict(type), 1.0),
166  sigmaEps_("sigmaEps", this->typeDict(type), 1.2),
167 
168  k_
169  (
170  IOobject
171  (
172  this->groupName("k"),
173  this->runTime_.name(),
174  this->mesh_,
175  IOobject::MUST_READ,
176  IOobject::AUTO_WRITE
177  ),
178  this->mesh_,
179  dimensions::turbulentKineticEnergy
180  ),
181  epsilon_
182  (
183  IOobject
184  (
185  this->groupName("epsilon"),
186  this->runTime_.name(),
187  this->mesh_,
188  IOobject::MUST_READ,
189  IOobject::AUTO_WRITE
190  ),
191  this->mesh_,
192  dimensions::turbulentEpsilon
193  )
194 {
195  bound(k_, this->kMin_);
196  boundEpsilon();
197 }
198 
199 
200 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
201 
202 template<class BasicMomentumTransportModel>
204 {
206  {
207  A0_.readIfPresent(this->typeDict());
208  C2_.readIfPresent(this->typeDict());
209  sigmak_.readIfPresent(this->typeDict());
210  sigmaEps_.readIfPresent(this->typeDict());
211 
212  return true;
213  }
214  else
215  {
216  return false;
217  }
218 }
219 
220 
221 template<class BasicMomentumTransportModel>
223 {
224  if (!this->turbulence_)
225  {
226  return;
227  }
228 
229  // Local references
230  const alphaField& alpha = this->alpha_;
231  const rhoField& rho = this->rho_;
232  const surfaceScalarField& alphaRhoPhi = this->alphaRhoPhi_;
233  const volVectorField& U = this->U_;
234  volScalarField& nut = this->nut_;
235  const Foam::fvModels& fvModels(Foam::fvModels::New(this->mesh_));
237  (
238  Foam::fvConstraints::New(this->mesh_)
239  );
240 
242 
244  (
245  typedName("divU"),
246  fvc::div(fvc::absolute(this->phi(), U))()
247  );
248 
249  const volTensorField gradU(fvc::grad(U));
250  const volScalarField S2(typedName("S2"), 2*magSqr(dev(symm(gradU))));
251  const volScalarField magS(typedName("magS"), sqrt(S2));
252 
253  const volScalarField::Internal eta
254  (
255  typedName("eta"), magS()*k_()/epsilon_()
256  );
257  const volScalarField::Internal C1
258  (
259  typedName("C1"),
260  max(eta/(scalar(5) + eta), scalar(0.43))
261  );
262 
264  (
265  this->GName(),
266  nut*(gradU.v() && dev(twoSymm(gradU.v())))
267  );
268 
269  // Update epsilon and G at the wall
270  epsilon_.boundaryFieldRef().updateCoeffs();
271 
272  // Dissipation equation
273  tmp<fvScalarMatrix> epsEqn
274  (
275  fvm::ddt(alpha, rho, epsilon_)
276  + fvm::div(alphaRhoPhi, epsilon_)
277  - fvm::laplacian(alpha*rho*DepsilonEff(), epsilon_)
278  ==
279  C1*alpha()*rho()*magS()*epsilon_()
280  - fvm::Sp
281  (
282  C2_*alpha()*rho()*epsilon_()/(k_() + sqrt(this->nu()()*epsilon_())),
283  epsilon_
284  )
285  + epsilonSource()
286  + fvModels.source(alpha, rho, epsilon_)
287  );
288 
289  epsEqn.ref().relax();
290  fvConstraints.constrain(epsEqn.ref());
291  epsEqn.ref().boundaryManipulate(epsilon_.boundaryFieldRef());
292  solve(epsEqn);
293  fvConstraints.constrain(epsilon_);
294  boundEpsilon();
295 
296 
297  // Turbulent kinetic energy equation
298 
300  (
301  fvm::ddt(alpha, rho, k_)
302  + fvm::div(alphaRhoPhi, k_)
303  - fvm::laplacian(alpha*rho*DkEff(), k_)
304  ==
305  alpha()*rho()*G
306  - fvm::SuSp(2.0/3.0*alpha()*rho()*divU, k_)
307  - fvm::Sp(alpha()*rho()*epsilon_()/k_(), k_)
308  + kSource()
309  + fvModels.source(alpha, rho, k_)
310  );
311 
312  kEqn.ref().relax();
313  fvConstraints.constrain(kEqn.ref());
314  solve(kEqn);
316  bound(k_, this->kMin_);
317 
318  correctNut(gradU, S2, magS);
319 }
320 
321 
322 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
323 
324 } // End namespace RASModels
325 } // End namespace Foam
326 
327 // ************************************************************************* //
Bound the given scalar field where it is below the specified minimum.
static fvConstraints & New(const word &name, const fvMesh &mesh)
Construct and return the named DemandDrivenMeshObject.
Field with dimensions and associated with geometry type GeoMesh which is used to size the field and a...
Generic GeometricField class.
const Internal & v() const
Return a const-reference to the dimensioned internal field.
Definition: volFieldsI.H:29
IOobject defines the attributes of an object for which implicit objectRegistry management is supporte...
Definition: IOobject.H:99
Templated abstract base class for RAS turbulence models.
Definition: RASModel.H:56
tmp< volScalarField > rCmu(const volTensorField &gradU, const volScalarField &S2, const volScalarField &magS)
Definition: realizableKE.C:49
virtual tmp< fvScalarMatrix > epsilonSource() const
Source term for the epsilon equation.
Definition: realizableKE.C:123
virtual void correct()
Solve the turbulence equations and correct the turbulence viscosity.
Definition: realizableKE.C:222
void boundEpsilon()
Bound epsilon.
Definition: realizableKE.C:41
virtual void correctNut()
Correct the eddy-viscosity nut.
Definition: realizableKE.C:96
virtual tmp< fvScalarMatrix > kSource() const
Source term for the k equation.
Definition: realizableKE.C:107
realizableKE(const alphaField &alpha, const rhoField &rho, const volVectorField &U, const surfaceScalarField &alphaRhoPhi, const surfaceScalarField &phi, const viscosity &viscosity, const word &type=typeName)
Construct from components.
Definition: realizableKE.C:141
virtual bool read()
Re-read model coefficients if they have changed.
Definition: realizableKE.C:203
Dimension set for the base types.
Definition: dimensionSet.H:125
Eddy viscosity turbulence model base class.
Definition: eddyViscosity.H:52
Finite volume constraints.
Definition: fvConstraints.H:68
bool constrain(fvMatrix< Type > &eqn) const
Apply constraints to an equation.
A special matrix type and solver, designed for finite volume solutions of scalar equations....
Definition: fvMatrix.H:118
Finite volume models.
Definition: fvModels.H:69
tmp< fvMatrix< Type > > source(const VolField< Type > &field) const
Return source for an equation.
BasicMomentumTransportModel::alphaField alphaField
BasicMomentumTransportModel::rhoField rhoField
A class for managing temporary objects.
Definition: tmp.H:55
void clear() const
If object pointer points to valid object:
Definition: tmpI.H:253
T & ref() const
Return non-const reference or generate a fatal error.
Definition: tmpI.H:197
Abstract base class for all fluid physical properties.
Definition: viscosity.H:50
A class for handling words, derived from string.
Definition: word.H:63
Foam::fvConstraints & fvConstraints(Foam::fvConstraints::New(mesh))
Foam::fvModels & fvModels(Foam::fvModels::New(mesh))
const scalar nut
U
Definition: pEqn.H:72
rho
Definition: pEqn.H:1
volScalarField alpha(IOobject("alpha", runTime.name(), mesh, IOobject::READ_IF_PRESENT, IOobject::AUTO_WRITE), lambda *max(Ua &U, zeroSensitivity))
void correct(const RdeltaTType &rDeltaT, const RhoType &rho, volScalarField &psi, const surfaceScalarField &phiCorr, const SpType &Sp)
const dimensionedScalar G
Newtonian constant of gravitation.
const dimensionSet turbulentKineticEnergy
const dimensionSet turbulentEpsilon
tmp< VolField< typename outerProduct< vector, Type >::type > > grad(const SurfaceField< Type > &ssf)
Definition: fvcGrad.C:46
tmp< VolField< Type > > div(const SurfaceField< Type > &ssf)
Definition: fvcDiv.C:47
tmp< surfaceScalarField > absolute(const tmp< surfaceScalarField > &tphi, const volVectorField &U)
Return the given relative flux in absolute form.
Definition: fvcMeshPhi.C:202
tmp< fvMatrix< Type > > S(const Pair< tmp< volScalarField::Internal >> &, const VolField< Type > &)
tmp< fvMatrix< Type > > laplacian(const VolField< Type > &vf, const word &name)
Definition: fvmLaplacian.C:47
tmp< fvMatrix< Type > > div(const surfaceScalarField &flux, const VolField< Type > &vf, const word &name)
Definition: fvmDiv.C:48
tmp< fvMatrix< Type > > Sp(const volScalarField::Internal &, const VolField< Type > &)
tmp< fvMatrix< Type > > SuSp(const volScalarField::Internal &, const VolField< Type > &)
tmp< fvMatrix< Type > > ddt(const VolField< Type > &vf)
Definition: fvmDdt.C:46
Namespace for OpenFOAM.
void skew(pointPatchField< tensor > &, const pointPatchField< tensor > &)
bool read(const char *, int32_t &)
Definition: int32IO.C:85
const dimensionSet & dimVolume
Definition: dimensions.C:282
tmp< DimensionedField< typename outerProduct< Type, Type >::type, GeoMesh, Field >> sqr(const DimensionedField< Type, GeoMesh, PrimitiveField > &df)
scalarList W(const fluidMulticomponentThermo &thermo)
const dimensionSet & dimTime
Definition: dimensions.C:277
void dev(pointPatchField< tensor > &, const pointPatchField< tensor > &)
dimensioned< Type > min(const DimensionedField< Type, GeoMesh, PrimitiveField > &df)
word typedName(Name name)
Return the name of the object within the given type.
Definition: typeInfo.H:188
void symm(pointPatchField< tensor > &, const pointPatchField< tensor > &)
bool bound(volScalarField &, const dimensionedScalar &min)
Bound the given scalar field where it is below the specified min value.
Definition: bound.C:31
word name(const LagrangianState state)
Return a string representation of a Lagrangian state enumeration.
void twoSymm(pointPatchField< tensor > &, const pointPatchField< tensor > &)
void sqrt(LagrangianPatchField< scalar > &f, const LagrangianPatchField< scalar > &f1)
tmp< DimensionedField< scalar, GeoMesh, Field > > magSqr(const DimensionedField< Type, GeoMesh, PrimitiveField > &df)
dimensionedScalar cos(const dimensionedScalar &ds)
dimensionedScalar acos(const dimensionedScalar &ds)
dimensioned< Type > max(const DimensionedField< Type, GeoMesh, PrimitiveField > &df)
dimensioned< scalar > dimensionedScalar
Dimensioned scalar obtained from generic dimensioned type.
fileType type(const fileName &, const bool checkVariants=true, const bool followLink=true)
Return the file type: directory or file.
Definition: POSIX.C:488
SolverPerformance< Type > solve(fvMatrix< Type > &, const word &)
Solve returning the solution statistics given convergence tolerance.