openfoam/src/OpenFOAM/matrices/lduMatrix/solvers/GAMG/GAMGSolver.H
Mark Olesen 6e393ccbc8 ENH: runTime selectable disabling of matrix norm (#2500)
For example,

    T
    {
        solver          PBiCGStab;
        preconditioner  DILU;
        tolerance       1e-6;
        norm            none;
    }

STYLE: define defaultMaxIter, defaultTolerance directly in lduMatrix
2022-07-08 11:40:53 +02:00

375 lines
12 KiB
C++

/*---------------------------------------------------------------------------*\
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | www.openfoam.com
\\/ M anipulation |
-------------------------------------------------------------------------------
Copyright (C) 2011-2016 OpenFOAM Foundation
Copyright (C) 2019-2022 OpenCFD Ltd.
-------------------------------------------------------------------------------
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/>.
Class
Foam::GAMGSolver
Group
grpLduMatrixSolvers
Description
Geometric agglomerated algebraic multigrid solver.
Characteristics:
- Requires positive definite, diagonally dominant matrix.
- Agglomeration algorithm: selectable and optionally cached.
- Restriction operator: summation.
- Prolongation operator: injection.
- Smoother: Gauss-Seidel.
- Coarse matrix creation: central coefficient: summation of fine grid
central coefficients with the removal of intra-cluster face;
off-diagonal coefficient: summation of off-diagonal faces.
- Coarse matrix scaling: performed by correction scaling, using steepest
descent optimisation.
- Type of cycle: V-cycle with optional pre-smoothing.
- Coarsest-level matrix solved using PCG or PBiCGStab.
SourceFiles
GAMGSolver.C
GAMGSolverAgglomerateMatrix.C
GAMGSolverInterpolate.C
GAMGSolverScale.C
GAMGSolverSolve.C
\*---------------------------------------------------------------------------*/
#ifndef Foam_GAMGSolver_H
#define Foam_GAMGSolver_H
#include "GAMGAgglomeration.H"
#include "lduMatrix.H"
#include "primitiveFields.H"
#include "LUscalarMatrix.H"
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
namespace Foam
{
/*---------------------------------------------------------------------------*\
Class GAMGSolver Declaration
\*---------------------------------------------------------------------------*/
class GAMGSolver
:
public lduMatrix::solver
{
// Private Data
//- Number of pre-smoothing sweeps
label nPreSweeps_;
//- Lever multiplier for the number of pre-smoothing sweeps
label preSweepsLevelMultiplier_;
//- Maximum number of pre-smoothing sweeps
label maxPreSweeps_;
//- Number of post-smoothing sweeps
label nPostSweeps_;
//- Lever multiplier for the number of post-smoothing sweeps
label postSweepsLevelMultiplier_;
//- Maximum number of post-smoothing sweeps
label maxPostSweeps_;
//- Number of smoothing sweeps on finest mesh
label nFinestSweeps_;
//- Cache the agglomeration (default: true)
bool cacheAgglomeration_;
//- Choose if the corrections should be interpolated after injection.
// By default corrections are not interpolated.
bool interpolateCorrection_;
//- Choose if the corrections should be scaled.
// By default corrections for symmetric matrices are scaled
// but not for asymmetric matrices.
bool scaleCorrection_;
//- Direct or iteratively solve the coarsest level
bool directSolveCoarsest_;
//- The agglomeration
const GAMGAgglomeration& agglomeration_;
//- Hierarchy of matrix levels
PtrList<lduMatrix> matrixLevels_;
//- Hierarchy of interfaces.
PtrList<PtrList<lduInterfaceField>> primitiveInterfaceLevels_;
//- Hierarchy of interfaces in lduInterfaceFieldPtrs form
PtrList<lduInterfaceFieldPtrsList> interfaceLevels_;
//- Hierarchy of interface boundary coefficients
PtrList<FieldField<Field, scalar>> interfaceLevelsBouCoeffs_;
//- Hierarchy of interface internal coefficients
PtrList<FieldField<Field, scalar>> interfaceLevelsIntCoeffs_;
//- LU decomposed coarsest matrix
autoPtr<LUscalarMatrix> coarsestLUMatrixPtr_;
//- Sparse coarsest matrix solver
autoPtr<lduMatrix::solver> coarsestSolverPtr_;
// Private Member Functions
//- Read control parameters from the control dictionary
virtual void readControls();
//- Simplified access to interface level
const lduInterfaceFieldPtrsList& interfaceLevel
(
const label i
) const;
//- Simplified access to matrix level
const lduMatrix& matrixLevel(const label i) const;
//- Simplified access to interface boundary coeffs level
const FieldField<Field, scalar>& interfaceBouCoeffsLevel
(
const label i
) const;
//- Simplified access to interface internal coeffs level
const FieldField<Field, scalar>& interfaceIntCoeffsLevel
(
const label i
) const;
//- Agglomerate coarse matrix. Supply mesh to use - so we can
// construct temporary matrix on the fine mesh (instead of the coarse
// mesh)
void agglomerateMatrix
(
const label fineLevelIndex,
const lduMesh& coarseMesh,
const lduInterfacePtrsList& coarseMeshInterfaces
);
//- Agglomerate coarse interface coefficients
void agglomerateInterfaceCoefficients
(
const label fineLevelIndex,
const lduInterfacePtrsList& coarseMeshInterfaces,
PtrList<lduInterfaceField>& coarsePrimInterfaces,
lduInterfaceFieldPtrsList& coarseInterfaces,
FieldField<Field, scalar>& coarseInterfaceBouCoeffs,
FieldField<Field, scalar>& coarseInterfaceIntCoeffs
) const;
//- Collect matrices from other processors
void gatherMatrices
(
const labelList& procIDs,
const lduMesh& dummyMesh,
const label meshComm,
const lduMatrix& mat,
const FieldField<Field, scalar>& interfaceBouCoeffs,
const FieldField<Field, scalar>& interfaceIntCoeffs,
const lduInterfaceFieldPtrsList& interfaces,
PtrList<lduMatrix>& otherMats,
PtrList<FieldField<Field, scalar>>& otherBouCoeffs,
PtrList<FieldField<Field, scalar>>& otherIntCoeffs,
List<boolList>& otherTransforms,
List<List<label>>& otherRanks
) const;
//- Agglomerate processor matrices
void procAgglomerateMatrix
(
// Agglomeration information
const labelList& procAgglomMap,
const List<label>& agglomProcIDs,
const label levelI,
// Resulting matrix
autoPtr<lduMatrix>& allMatrixPtr,
FieldField<Field, scalar>& allInterfaceBouCoeffs,
FieldField<Field, scalar>& allInterfaceIntCoeffs,
PtrList<lduInterfaceField>& allPrimitiveInterfaces,
lduInterfaceFieldPtrsList& allInterfaces
) const;
//- Agglomerate processor matrices
void procAgglomerateMatrix
(
const labelList& procAgglomMap,
const List<label>& agglomProcIDs,
const label levelI
);
//- Interpolate the correction after injected prolongation
void interpolate
(
solveScalarField& psi,
solveScalarField& Apsi,
const lduMatrix& m,
const FieldField<Field, scalar>& interfaceBouCoeffs,
const lduInterfaceFieldPtrsList& interfaces,
const direction cmpt
) const;
//- Interpolate the correction after injected prolongation and
// re-normalise
void interpolate
(
solveScalarField& psi,
solveScalarField& Apsi,
const lduMatrix& m,
const FieldField<Field, scalar>& interfaceBouCoeffs,
const lduInterfaceFieldPtrsList& interfaces,
const labelList& restrictAddressing,
const solveScalarField& psiC,
const direction cmpt
) const;
//- Calculate and apply the scaling factor from Acf, coarseSource
// and coarseField.
// At the same time do a Jacobi iteration on the coarseField using
// the Acf provided after the coarseField values are used for the
// scaling factor.
void scale
(
solveScalarField& field,
solveScalarField& Acf,
const lduMatrix& A,
const FieldField<Field, scalar>& interfaceLevelBouCoeffs,
const lduInterfaceFieldPtrsList& interfaceLevel,
const solveScalarField& source,
const direction cmpt
) const;
//- Initialise the data structures for the V-cycle
void initVcycle
(
PtrList<solveScalarField>& coarseCorrFields,
PtrList<solveScalarField>& coarseSources,
PtrList<lduMatrix::smoother>& smoothers,
solveScalarField& scratch1,
solveScalarField& scratch2
) const;
//- Perform a single GAMG V-cycle with pre, post and finest smoothing.
void Vcycle
(
const PtrList<lduMatrix::smoother>& smoothers,
solveScalarField& psi,
const scalarField& source,
solveScalarField& Apsi,
solveScalarField& finestCorrection,
solveScalarField& finestResidual,
solveScalarField& scratch1,
solveScalarField& scratch2,
PtrList<solveScalarField>& coarseCorrFields,
PtrList<solveScalarField>& coarseSources,
const direction cmpt=0
) const;
//- Create and return the dictionary to specify the PCG solver
// to solve the coarsest level
dictionary PCGsolverDict
(
const scalar tol,
const scalar relTol
) const;
//- Create and return the dictionary to specify the PBiCGStab solver
// to solve the coarsest level
dictionary PBiCGStabSolverDict
(
const scalar tol,
const scalar relTol
) const;
//- Solve the coarsest level with either an iterative or direct solver
void solveCoarsestLevel
(
solveScalarField& coarsestCorrField,
const solveScalarField& coarsestSource
) const;
public:
friend class GAMGPreconditioner;
//- Runtime type information
TypeName("GAMG");
// Constructors
//- Construct from lduMatrix and solver controls
GAMGSolver
(
const word& fieldName,
const lduMatrix& matrix,
const FieldField<Field, scalar>& interfaceBouCoeffs,
const FieldField<Field, scalar>& interfaceIntCoeffs,
const lduInterfaceFieldPtrsList& interfaces,
const dictionary& solverControls
);
//- Destructor
virtual ~GAMGSolver();
// Member Functions
//- Solve
virtual solverPerformance solve
(
scalarField& psi,
const scalarField& source,
const direction cmpt=0
) const;
};
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
} // End namespace Foam
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
#endif
// ************************************************************************* //