LUscalarMatrix.H
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration |
5  \\ / A nd | Copyright (C) 2011-2013 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 Class
25  Foam::LUscalarMatrix
26 
27 Description
28  Foam::LUscalarMatrix
29 
30 SourceFiles
31  LUscalarMatrix.C
32 
33 \*---------------------------------------------------------------------------*/
34 
35 #ifndef LUscalarMatrix_H
36 #define LUscalarMatrix_H
37 
38 #include "scalarMatrices.H"
39 #include "labelList.H"
40 #include "FieldField.H"
42 
43 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
44 
45 namespace Foam
46 {
47 
48 class lduMatrix;
49 class procLduMatrix;
50 
51 /*---------------------------------------------------------------------------*\
52  Class LUscalarMatrix Declaration
53 \*---------------------------------------------------------------------------*/
54 
55 class LUscalarMatrix
56 :
57  public scalarSquareMatrix
58 {
59  // Private data
60 
61  //- Communicator to use
62  const label comm_;
63 
64  //- Processor matrix offsets
66 
67  //- The pivot indices used in the LU decomposition
69 
70  //- Convert the given lduMatrix into this LUscalarMatrix
71  void convert
72  (
73  const lduMatrix& ldum,
74  const FieldField<Field, scalar>& interfaceCoeffs,
75  const lduInterfaceFieldPtrsList& interfaces
76  );
77 
78  //- Convert the given list of procLduMatrix into this LUscalarMatrix
79  // on the master processor
80  void convert(const PtrList<procLduMatrix>& lduMatrices);
81 
82 
83  //- Print the ratio of the mag-sum of the off-diagonal coefficients
84  // to the mag-diagonal
85  void printDiagonalDominance() const;
86 
87 
88 public:
89 
90  // Declare name of the class and its debug switch
91  ClassName("LUscalarMatrix");
92 
93  // Constructors
94 
95  //- Construct from scalarSquareMatrix and perform LU decomposition
97 
98  //- Construct from lduMatrix and perform LU decomposition
100  (
101  const lduMatrix&,
102  const FieldField<Field, scalar>& interfaceCoeffs,
103  const lduInterfaceFieldPtrsList& interfaces
104  );
105 
106 
107  // Member Functions
108 
109  //- Solve the matrix using the LU decomposition with pivoting
110  // returning the solution in the source
111  template<class T>
112  void solve(Field<T>& source) const;
113 };
114 
115 
116 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
117 
118 } // End namespace Foam
119 
120 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
121 
122 #ifdef NoRepository
123 # include "LUscalarMatrixTemplates.C"
124 #endif
125 
126 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
127 
128 #endif
129 
130 // ************************************************************************* //
Foam::LUscalarMatrix::pivotIndices_
labelList pivotIndices_
The pivot indices used in the LU decomposition.
Definition: LUscalarMatrix.H:67
Foam::FieldField
Generic field type.
Definition: FieldField.H:51
FieldField.H
Foam::lduMatrix
lduMatrix is a general matrix class in which the coefficients are stored as three arrays,...
Definition: lduMatrix.H:77
LUscalarMatrixTemplates.C
Foam::LUscalarMatrix::comm_
const label comm_
Communicator to use.
Definition: LUscalarMatrix.H:61
lduInterfaceFieldPtrsList.H
Foam::LUscalarMatrix::solve
void solve(Field< T > &source) const
Solve the matrix using the LU decomposition with pivoting.
Foam::LUscalarMatrix::ClassName
ClassName("LUscalarMatrix")
Foam::label
intWM_LABEL_SIZE_t label
A label is an int32_t or int64_t as specified by the pre-processor macro WM_LABEL_SIZE.
Definition: label.H:59
labelList.H
Foam::Field< T >
Foam::UPtrList
A templated 1D list of pointers to objects of type <T>, where the size of the array is known and used...
Definition: UPtrList.H:53
Foam::PtrList
A templated 1D list of pointers to objects of type <T>, where the size of the array is known and used...
Definition: List.H:61
Foam::LUscalarMatrix::convert
void convert(const lduMatrix &ldum, const FieldField< Field, scalar > &interfaceCoeffs, const lduInterfaceFieldPtrsList &interfaces)
Convert the given lduMatrix into this LUscalarMatrix.
Definition: LUscalarMatrix.C:192
Foam::LUscalarMatrix
Foam::LUscalarMatrix.
Definition: LUscalarMatrix.H:54
Foam
Namespace for OpenFOAM.
Definition: combustionModel.C:30
Foam::SquareMatrix< scalar >
Foam::List
A 1D array of objects of type <T>, where the size of the vector is known and used for subscript bound...
Definition: HashTable.H:59
Foam::LUscalarMatrix::printDiagonalDominance
void printDiagonalDominance() const
Print the ratio of the mag-sum of the off-diagonal coefficients.
Definition: LUscalarMatrix.C:388
scalarMatrices.H
Foam::LUscalarMatrix::procOffsets_
labelList procOffsets_
Processor matrix offsets.
Definition: LUscalarMatrix.H:64
Foam::LUscalarMatrix::LUscalarMatrix
LUscalarMatrix(const scalarSquareMatrix &)
Construct from scalarSquareMatrix and perform LU decomposition.
Definition: LUscalarMatrix.C:42