faMatrixSolve.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) 2016-2017 Wikki Ltd
9  Copyright (C) 2019-2021 OpenCFD Ltd.
10 -------------------------------------------------------------------------------
11 License
12  This file is part of OpenFOAM.
13 
14  OpenFOAM is free software: you can redistribute it and/or modify it
15  under the terms of the GNU General Public License as published by
16  the Free Software Foundation, either version 3 of the License, or
17  (at your option) any later version.
18 
19  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
20  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
21  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22  for more details.
23 
24  You should have received a copy of the GNU General Public License
25  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
26 
27 Description
28  Finite-Area matrix basic solvers.
29 
30 \*---------------------------------------------------------------------------*/
31 
32 #include "PrecisionAdaptor.H"
33 
34 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
35 
36 template<class Type>
38 (
39  const label patchi,
40  const label facei,
41  const direction cmpt,
42  const scalar value
43 )
44 {
45  internalCoeffs_[patchi][facei].component(cmpt) +=
46  diag()[psi_.mesh().boundary()[patchi].faceCells()[facei]];
47 
48  boundaryCoeffs_[patchi][facei].component(cmpt) +=
49  diag()[psi_.mesh().boundary()[patchi].faceCells()[facei]]*value;
50 }
51 
52 
53 template<class Type>
55 (
56  const dictionary& solverControls
57 )
58 {
60  << "solving faMatrix<Type>"
61  << endl;
62 
63  const int logLevel =
64  solverControls.getOrDefault<int>
65  (
66  "log",
68  );
69 
70  auto& psi =
72 
73  SolverPerformance<Type> solverPerfVec
74  (
75  "faMatrix<Type>::solve",
76  psi.name()
77  );
78 
79  scalarField saveDiag(diag());
80 
81  Field<Type> source(source_);
82  addBoundarySource(source);
83 
84  // Note: make a copy of interfaces: no longer a reference
85  lduInterfaceFieldPtrsList interfaces =
86  psi_.boundaryField().scalarInterfaces();
87 
88  for (direction cmpt = 0; cmpt < Type::nComponents; ++cmpt)
89  {
90  // copy field and source
91 
92  scalarField psiCmpt(psi_.primitiveField().component(cmpt));
93  addBoundaryDiag(diag(), cmpt);
94 
95  scalarField sourceCmpt(source.component(cmpt));
96 
97  FieldField<Field, scalar> bouCoeffsCmpt
98  (
99  boundaryCoeffs_.component(cmpt)
100  );
101 
102  FieldField<Field, scalar> intCoeffsCmpt
103  (
104  internalCoeffs_.component(cmpt)
105  );
106 
107  // Use the initMatrixInterfaces and updateMatrixInterfaces to correct
108  // bouCoeffsCmpt for the explicit part of the coupled boundary
109  // conditions
110  {
111  PrecisionAdaptor<solveScalar, scalar> sourceCmpt_ss(sourceCmpt);
112  ConstPrecisionAdaptor<solveScalar, scalar> psiCmpt_ss(psiCmpt);
113 
114  const label startRequest = Pstream::nRequests();
115 
116  initMatrixInterfaces
117  (
118  true,
119  bouCoeffsCmpt,
120  interfaces,
121  psiCmpt_ss(),
122  sourceCmpt_ss.ref(),
123  cmpt
124  );
125 
126  updateMatrixInterfaces
127  (
128  true,
129  bouCoeffsCmpt,
130  interfaces,
131  psiCmpt_ss(),
132  sourceCmpt_ss.ref(),
133  cmpt,
134  startRequest
135  );
136  }
137 
138  solverPerformance solverPerf;
139 
140  // Solver call
141  solverPerf = lduMatrix::solver::New
142  (
143  psi_.name() + pTraits<Type>::componentNames[cmpt],
144  *this,
145  bouCoeffsCmpt,
146  intCoeffsCmpt,
147  interfaces,
148  solverControls
149  )->solve(psiCmpt, sourceCmpt, cmpt);
150 
151  if (logLevel)
152  {
153  solverPerf.print(Info);
154  }
155 
156  solverPerfVec.replace(cmpt, solverPerf);
157  solverPerfVec.solverName() = solverPerf.solverName();
158 
159  psi.primitiveFieldRef().replace(cmpt, psiCmpt);
160  diag() = saveDiag;
161  }
162 
163  psi.correctBoundaryConditions();
164 
165  psi.mesh().setSolverPerformance(psi.name(), solverPerfVec);
166 
167  return solverPerfVec;
168 }
169 
170 
171 template<class Type>
173 {
174  return solve(faMat_.psi().mesh().solverDict(faMat_.psi().name()));
175 }
176 
177 
178 template<class Type>
180 {
181  return solve(this->psi().mesh().solverDict(this->psi().name()));
182 }
183 
184 
185 template<class Type>
187 {
188  tmp<Field<Type>> tres(new Field<Type>(source_));
189  Field<Type>& res = tres().ref();
190 
191  addBoundarySource(res);
192 
193  // Loop over field components
194  for (direction cmpt = 0; cmpt < Type::nComponents; ++cmpt)
195  {
196  scalarField psiCmpt(psi_.internalField().component(cmpt));
197 
198  scalarField boundaryDiagCmpt(psi_.size(), Zero);
199  addBoundaryDiag(boundaryDiagCmpt, cmpt);
200 
201  FieldField<Field, scalar> bouCoeffsCmpt
202  (
203  boundaryCoeffs_.component(cmpt)
204  );
205 
206  res.replace
207  (
208  cmpt,
210  (
211  psiCmpt,
212  res.component(cmpt) - boundaryDiagCmpt*psiCmpt,
213  bouCoeffsCmpt,
215  cmpt
216  )
217  );
218  }
219 
220  return tres;
221 }
222 
223 
224 // ************************************************************************* //
Foam::FieldField
A field of fields is a PtrList of fields with reference counting.
Definition: FieldField.H:53
Foam::tmp
A class for managing temporary objects.
Definition: PtrList.H:61
Foam::Zero
static constexpr const zero Zero
Global zero (0)
Definition: zero.H:131
Foam::diag
void diag(pointPatchField< vector > &, const pointPatchField< tensor > &)
Definition: pointPatchFieldFunctions.H:287
PrecisionAdaptor.H
Foam::endl
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition: Ostream.H:369
Foam::faMatrix::setComponentReference
void setComponentReference(const label patchi, const label facei, const direction cmpt, const scalar value)
Definition: faMatrixSolve.C:38
Foam::GeometricField::internalField
const Internal & internalField() const
Return a const-reference to the dimensioned internal field.
Definition: GeometricFieldI.H:43
solve
CEqn solve()
Foam::SolverPerformance::print
void print(Ostream &os) const
Print summary of solver performance to the given stream.
Definition: SolverPerformance.C:93
Foam::faMatrix::addBoundaryDiag
void addBoundaryDiag(scalarField &diag, const direction cmpt) const
Definition: faMatrix.C:117
Foam::tmp::ref
T & ref() const
Definition: tmpI.H:227
Foam::Field< scalar >
Foam::Info
messageStream Info
Information stream (stdout output on master, null elsewhere)
DebugInFunction
#define DebugInFunction
Report an information message using Foam::Info.
Definition: messageStream.H:388
Foam::UPtrList< const lduInterfaceField >
Foam::faMatrix::solve
SolverPerformance< Type > solve()
Solve returning the solution statistics.
Definition: faMatrixSolve.C:179
Foam::Field::replace
void replace(const direction, const UList< cmptType > &)
Replace a component field of the field.
Definition: Field.C:551
Foam::faMatrix::addBoundarySource
void addBoundarySource(Field< Type > &source, const bool couples=true) const
Definition: faMatrix.C:151
Foam::dictionary
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:123
mesh
dynamicFvMesh & mesh
Definition: createDynamicFvMesh.H:6
Foam::Field::component
tmp< Field< cmptType > > component(const direction) const
Return a component field of the field.
Definition: Field.C:539
Foam::New
tmp< DimensionedField< TypeR, GeoMesh > > New(const tmp< DimensionedField< TypeR, GeoMesh >> &tdf1, const word &name, const dimensionSet &dimensions)
Global function forwards to reuseTmpDimensionedField::New.
Definition: DimensionedFieldReuseFunctions.H:105
Foam::PrecisionAdaptor
A non-const Field/List wrapper with possible data conversion.
Definition: PrecisionAdaptor.H:186
Foam::faMatrix::psi
const GeometricField< Type, faPatchField, areaMesh > & psi() const
Definition: faMatrix.H:255
Foam::pTraits
A traits class, which is primarily used for primitives.
Definition: pTraits.H:56
Foam::ConstPrecisionAdaptor
A const Field/List wrapper with possible data conversion.
Definition: PrecisionAdaptor.H:57
Foam::direction
uint8_t direction
Definition: direction.H:52
Foam::name
word name(const expressions::valueTypeCode typeCode)
A word representation of a valueTypeCode. Empty for INVALID.
Definition: exprTraits.C:59
Foam::DimensionedField::component
tmp< DimensionedField< cmptType, GeoMesh > > component(const direction d) const
Return a component field of the field.
Foam::faMatrix::residual
tmp< Field< Type > > residual() const
Return the matrix residual.
Definition: faMatrixSolve.C:186
Foam::refPtr< Container< Type > >::ref
Container< Type > & ref() const
Definition: refPtrI.H:203
Foam::faMatrix::faSolver::solve
SolverPerformance< Type > solve()
Solve returning the solution statistics.
Definition: faMatrixSolve.C:172
Foam::dictionary::getOrDefault
T getOrDefault(const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) const
Definition: dictionaryTemplates.C:148
Foam::GeometricField
Generic GeometricField class.
Definition: areaFieldsFwd.H:53
Foam::SolverPerformance::solverName
const word & solverName() const noexcept
Return solver name.
Definition: SolverPerformance.H:150
psi
const volScalarField & psi
Definition: createFieldRefs.H:1
Foam::lduMatrix::residual
void residual(solveScalarField &rA, const solveScalarField &psi, const scalarField &source, const FieldField< Field, scalar > &interfaceBouCoeffs, const lduInterfaceFieldPtrsList &interfaces, const direction cmpt) const
Definition: lduMatrixATmul.C:217
Foam::SolverPerformance
SolverPerformance is the class returned by the LduMatrix solver containing performance statistics.
Definition: SolverPerformance.H:52
Foam::GeometricField::boundaryField
const Boundary & boundaryField() const
Return const-reference to the boundary field.
Definition: GeometricFieldI.H:62
Foam::GeometricField::Boundary::scalarInterfaces
lduInterfaceFieldPtrsList scalarInterfaces() const
Definition: GeometricBoundaryField.C:527