MueLu  Version of the Day
MueLu_GeneralGeometricPFactory_decl.hpp
Go to the documentation of this file.
1 // @HEADER
2 //
3 // ***********************************************************************
4 //
5 // MueLu: A package for multigrid based preconditioning
6 // Copyright 2012 Sandia Corporation
7 //
8 // Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
9 // the U.S. Government retains certain rights in this software.
10 //
11 // Redistribution and use in source and binary forms, with or without
12 // modification, are permitted provided that the following conditions are
13 // met:
14 //
15 // 1. Redistributions of source code must retain the above copyright
16 // notice, this list of conditions and the following disclaimer.
17 //
18 // 2. Redistributions in binary form must reproduce the above copyright
19 // notice, this list of conditions and the following disclaimer in the
20 // documentation and/or other materials provided with the distribution.
21 //
22 // 3. Neither the name of the Corporation nor the names of the
23 // contributors may be used to endorse or promote products derived from
24 // this software without specific prior written permission.
25 //
26 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
27 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
30 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
31 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
32 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
33 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
34 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
35 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
36 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37 //
38 // Questions? Contact
39 // Jonathan Hu (jhu@sandia.gov)
40 // Andrey Prokopenko (aprokop@sandia.gov)
41 // Ray Tuminaro (rstumin@sandia.gov)
42 //
43 // ***********************************************************************
44 //
45 // @HEADER
46 #ifndef MUELU_GENERALGEOMETRICPFACTORY_DECL_HPP
47 #define MUELU_GENERALGEOMETRICPFACTORY_DECL_HPP
48 
49 #include <Teuchos_SerialDenseVector.hpp>
50 
51 #include <Xpetra_MultiVector.hpp>
52 #include <Xpetra_Matrix_fwd.hpp>
53 
54 #include "MueLu_ConfigDefs.hpp"
55 #include "MueLu_PFactory.hpp"
57 
58 #include "MueLu_Level_fwd.hpp"
59 
60 namespace MueLuTests {
61  // Forward declaration of friend tester class used to UnitTest GeneralGeometricPFactory
62  template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
64 }
65 
66 namespace MueLu {
67 
115  template <class Scalar = double, class LocalOrdinal = int, class GlobalOrdinal = LocalOrdinal, class Node = KokkosClassic::DefaultNode::DefaultNodeType>
117 #undef MUELU_GENERALGEOMETRICPFACTORY_SHORT
118 #include "MueLu_UseShortNames.hpp"
119 
120  public:
121 
122  friend class MueLuTests::GeneralGeometricPFactoryTester<Scalar, LocalOrdinal, GlobalOrdinal, Node>;
123 
125 
126 
129 
133 
134  RCP<const ParameterList> GetValidParameterList() const;
135 
137 
138 
139  void DeclareInput(Level& fineLevel, Level& coarseLevel) const;
140 
142 
144 
145 
146  void Build (Level& fineLevel, Level& coarseLevel) const;
147  void BuildP(Level& fineLevel, Level& coarseLevel) const;
148 
150 
151  private:
152  void MakeGeneralGeometricP(LO const numDimension, const Array<LO> mapDirL2G, const Array<LO> mapDirG2L, const Array<LO> lFineNodesPerDir,
153  const Array<LO> lCoarseNodesPerDir, Array<GO> gCoarseNodesPerDir, Array<GO> gFineNodesPerDir,
154  ArrayRCP<LO> const coarseRate, LO const endRate[3], LO const offsets[6], bool const ghostInterface[6],
155  const RCP<Xpetra::MultiVector<double,LO,GO,NO> >& fCoords, LO const nnzP, LO const dofsPerNode,
156  RCP<const Map>& stridedDomainMapP, RCP<Matrix> & Amat, RCP<Matrix>& P,
157  RCP<Xpetra::MultiVector<double,LO,GO,NO> >& cCoords, Array<GO> ghostsGIDs, int interpolationOrder) const;
158 
159  void ComputeStencil(const LO numDimension, const Array<GO> currentNodeIndices, const Array<GO> coarseNodeIndices,
160  const LO rate[3], const double coord[9][3], const int interpolationOrder, SC stencil[8]) const;
161 
162  void ComputeConstantInterpolationStencil(const LO numDimension, const Array<GO> currentNodeIndices, const Array<GO> coarseNodeIndices,
163  const LO rate[3], SC stencil[8]) const;
164 
165  void ComputeLinearInterpolationStencil(const LO numDimension, const double coord[9][3], SC stencil[8]) const;
166  void GetInterpolationFunctions(const LO numDimension, const Teuchos::SerialDenseVector<LO,double> parameters, double functions[4][8]) const;
167 
168  void sh_sort_permute(
169  const typename Teuchos::Array<LocalOrdinal>::iterator& first1,
170  const typename Teuchos::Array<LocalOrdinal>::iterator& last1,
171  const typename Teuchos::Array<LocalOrdinal>::iterator& first2,
172  const typename Teuchos::Array<LocalOrdinal>::iterator& last2) const;
173 
174  void sh_sort2(
175  const typename Teuchos::Array<LocalOrdinal>::iterator& first1,
176  const typename Teuchos::Array<LocalOrdinal>::iterator& last1,
177  const typename Teuchos::Array<LocalOrdinal>::iterator& first2,
178  const typename Teuchos::Array<LocalOrdinal>::iterator& last2) const;
179 
180  }; //class GeneralGeometricPFactory
181 
182 } //namespace MueLu
183 
184 #define MUELU_GENERALGEOMETRICPFACTORY_SHORT
185 #endif // MUELU_GENERALGEOMETRICPFACTORY_DECL_HPP
Namespace for MueLu classes and methods.
Prolongator factory performing geometric coarsening.
Class that holds all level-specific information.
Definition: MueLu_Level.hpp:99
Factory that provides an interface for a concrete implementation of a prolongation operator...