MueLu  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
MueLu_ParameterListInterpreter_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_PARAMETERLISTINTERPRETER_DECL_HPP
47 #define MUELU_PARAMETERLISTINTERPRETER_DECL_HPP
48 
50 
51 #include <Xpetra_Matrix_fwd.hpp>
52 #include <Xpetra_Operator_fwd.hpp>
53 
54 #include "MueLu_ConfigDefs.hpp"
56 
66 #include "MueLu_FacadeClassBase.hpp"
67 #include "MueLu_FacadeClassFactory.hpp"
74 #include "MueLu_PgPFactory_fwd.hpp"
75 #include "MueLu_RAPFactory_fwd.hpp"
80 #include "MueLu_SaPFactory_fwd.hpp"
90 #ifdef HAVE_MUELU_MATLAB
94 #endif
95 
96 
97 #ifdef HAVE_MUELU_KOKKOS_REFACTOR
105 #endif
106 
107 #ifdef HAVE_MUELU_INTREPID2
109 #endif
110 
111 namespace MueLu {
112 
113  template <class Scalar = double, class LocalOrdinal = int, class GlobalOrdinal = LocalOrdinal, class Node = KokkosClassic::DefaultNode::DefaultNodeType>
115  public HierarchyManager<Scalar, LocalOrdinal, GlobalOrdinal, Node> {
116 #undef MUELU_PARAMETERLISTINTERPRETER_SHORT
117 #include "MueLu_UseShortNames.hpp"
118  typedef std::pair<std::string, const FactoryBase*> keep_pair;
119 
120  public:
122 
123 
124  protected:
130  factFact_ = Teuchos::null;
132  }
133 
134  public:
147  ParameterListInterpreter(Teuchos::ParameterList& paramList, Teuchos::RCP<const Teuchos::Comm<int> > comm = Teuchos::null, Teuchos::RCP<FactoryFactory> factFact = Teuchos::null, Teuchos::RCP<FacadeClassFactory> facadeFact = Teuchos::null);
148 
159  ParameterListInterpreter(const std::string& xmlFileName, const Teuchos::Comm<int>& comm, Teuchos::RCP<FactoryFactory> factFact = Teuchos::null, Teuchos::RCP<FacadeClassFactory> facadeFact = Teuchos::null);
160 
163 
165 
182  void SetParameterList(const Teuchos::ParameterList& paramList);
183 
185  void SetupHierarchy(Hierarchy& H) const;
186 
187  private:
189  virtual void SetupOperator(Operator& A) const;
190 
193  double scalingFactor_;
194  GlobalOrdinal dofOffset_;
195 
197 
198  // These two variables are only needed to print out proper [default]
201 
202  void SetEasyParameterList(const Teuchos::ParameterList& paramList);
203  void Validate(const Teuchos::ParameterList& paramList) const;
204 
205  void UpdateFactoryManager(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
206  int levelID, std::vector<keep_pair>& keeps) const;
207 
208  // "Generic components" for UpdateFactoryManager
210  int levelID, std::vector<keep_pair>& keeps) const;
212  int levelID, std::vector<keep_pair>& keeps) const;
214  int levelID, std::vector<keep_pair>& keeps) const;
216  int levelID, std::vector<keep_pair>& keeps) const;
217  void UpdateFactoryManager_RAP(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
218  int levelID, std::vector<keep_pair>& keeps) const;
220  int levelID, std::vector<keep_pair>& keeps) const;
222  int levelID, std::vector<keep_pair>& keeps, RCP<Factory> & nullSpaceFactory) const;
224  int levelID, std::vector<keep_pair>& keeps, RCP<Factory> & nullSpaceFactory) const;
225 
226  // Algorithm-specific components for UpdateFactoryManager
228  int levelID, std::vector<keep_pair>& keeps) const;
230  int levelID, std::vector<keep_pair>& keeps) const;
231  void UpdateFactoryManager_SA(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
232  int levelID, std::vector<keep_pair>& keeps) const;
233  void UpdateFactoryManager_Emin(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
234  int levelID, std::vector<keep_pair>& keeps) const;
235  void UpdateFactoryManager_PG(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
236  int levelID, std::vector<keep_pair>& keeps) const;
237  void UpdateFactoryManager_Matlab(Teuchos::ParameterList& paramList, const Teuchos::ParameterList& defaultList, FactoryManager& manager,
238  int levelID, std::vector<keep_pair>& keeps) const;
239 
243 
245  // TODO:
246  // - parameter list validator
247  // - SetParameterList
248  // - Set/Get directly Level manager
249  // - build per level
250  // - comments/docs
251  // - use FactoryManager instead of FactoryMap
253  void SetFactoryParameterList(const Teuchos::ParameterList& paramList);
254 
255  typedef std::map<std::string, RCP<const FactoryBase> > FactoryMap; //TODO: remove this line
256  typedef std::map<std::string, RCP<FactoryManagerBase> > FactoryManagerMap;
257 
258  void BuildFactoryMap(const Teuchos::ParameterList& paramList, const FactoryMap& factoryMapIn, FactoryMap& factoryMapOut, FactoryManagerMap& factoryManagers) const;
259 
262 
265 
267  };
268 
269 } // namespace MueLu
270 
271 #define MUELU_PARAMETERLISTINTERPRETER_SHORT
272 #endif /* MUELU_PARAMETERLISTINTERPRETER_DECL_HPP */
This class specifies the default factory that should generate some data on a Level if the data does n...
void SetupHierarchy(Hierarchy &H) const
Call the SetupHierarchy routine from the HiearchyManager object.
double scalingFactor_
prolongator scaling factor
void UpdateFactoryManager(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_Matlab(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_SemiCoarsen(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
std::map< std::string, RCP< FactoryManagerBase > > FactoryManagerMap
std::map< std::string, RCP< const FactoryBase > > FactoryMap
void UpdateFactoryManager_Nullspace(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps, RCP< Factory > &nullSpaceFactory) const
virtual void SetupOperator(Operator &A) const
Setup Operator object.
void UpdateFactoryManager_PG(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
Teuchos::RCP< MueLu::FacadeClassFactory< Scalar, LocalOrdinal, GlobalOrdinal, Node > > facadeFact_
FacadeClass factory.
int blockSize_
block size of matrix (fixed block size)
Teuchos::RCP< FactoryFactory > factFact_
Internal factory for factories.
void UpdateFactoryManager_Emin(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
TEUCHOS_DEPRECATED RCP< T > rcp(T *p, Dealloc_T dealloc, bool owns_mem)
void UpdateFactoryManager_Coordinates(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
std::map< std::string, RCP< const FactoryBase > > FactoryMap
void SetFactoryParameterList(const Teuchos::ParameterList &paramList)
Factory interpreter stuff.
std::pair< std::string, const FactoryBase * > keep_pair
void UpdateFactoryManager_RAP(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_Restriction(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_Aggregation_TentativeP(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
GlobalOrdinal dofOffset_
global offset variable describing offset of DOFs in operator
void BuildFactoryMap(const Teuchos::ParameterList &paramList, const FactoryMap &factoryMapIn, FactoryMap &factoryMapOut, FactoryManagerMap &factoryManagers) const
Interpret &quot;Factories&quot; sublist.
void SetParameterList(const Teuchos::ParameterList &paramList)
Set parameter list for Parameter list interpreter.
void UpdateFactoryManager_SA(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void Validate(const Teuchos::ParameterList &paramList) const
void UpdateFactoryManager_PCoarsen(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_Repartition(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps, RCP< Factory > &nullSpaceFactory) const
void UpdateFactoryManager_Smoothers(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void UpdateFactoryManager_CoarseSolvers(Teuchos::ParameterList &paramList, const Teuchos::ParameterList &defaultList, FactoryManager &manager, int levelID, std::vector< keep_pair > &keeps) const
void SetEasyParameterList(const Teuchos::ParameterList &paramList)
Provides methods to build a multigrid hierarchy and apply multigrid cycles.
CycleType Cycle_
multigrid cycle type (V-cycle or W-cycle)