Ifpack2 Templated Preconditioning Package  Version 1.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Ifpack2_SingletonFilter_decl.hpp
1 // @HEADER
2 // *****************************************************************************
3 // Ifpack2: Templated Object-Oriented Algebraic Preconditioner Package
4 //
5 // Copyright 2009 NTESS and the Ifpack2 contributors.
6 // SPDX-License-Identifier: BSD-3-Clause
7 // *****************************************************************************
8 // @HEADER
9 
10 #ifndef IFPACK2_SINGLETONFILTER_DECL_HPP
11 #define IFPACK2_SINGLETONFILTER_DECL_HPP
12 
13 #include "Ifpack2_ConfigDefs.hpp"
14 #include "Tpetra_ConfigDefs.hpp"
15 #include "Ifpack2_Details_RowMatrix.hpp"
16 #include "Tpetra_MultiVector.hpp"
17 #include "Teuchos_RefCountPtr.hpp"
18 #include "Teuchos_ScalarTraits.hpp"
19 #include <type_traits>
20 #include <vector>
21 
22 
23 namespace Ifpack2 {
24 
30 template<class MatrixType>
32  virtual public Ifpack2::Details::RowMatrix<MatrixType> {
33 public:
34  typedef typename MatrixType::scalar_type Scalar;
35  typedef typename MatrixType::local_ordinal_type LocalOrdinal;
36  typedef typename MatrixType::global_ordinal_type GlobalOrdinal;
37  typedef typename MatrixType::node_type Node;
38  typedef typename MatrixType::global_inds_host_view_type global_inds_host_view_type;
39  typedef typename MatrixType::local_inds_host_view_type local_inds_host_view_type;
40  typedef typename MatrixType::values_host_view_type values_host_view_type;
41 
42  typedef typename MatrixType::nonconst_global_inds_host_view_type nonconst_global_inds_host_view_type;
43  typedef typename MatrixType::nonconst_local_inds_host_view_type nonconst_local_inds_host_view_type;
44  typedef typename MatrixType::nonconst_values_host_view_type nonconst_values_host_view_type;
45 
46  typedef typename Teuchos::ScalarTraits<Scalar>::magnitudeType magnitudeType;
47  typedef Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> row_matrix_type;
48  typedef typename row_matrix_type::mag_type mag_type;
49 
50  static_assert(std::is_same<MatrixType, row_matrix_type>::value, "Ifpack2::SingletonFilter: The template parameter MatrixType must be a Tpetra::RowMatrix specialization. Please don't use Tpetra::CrsMatrix (a subclass of Tpetra::RowMatrix) here anymore.");
51 
53 
54 
56  explicit SingletonFilter(const Teuchos::RCP<const Tpetra::RowMatrix<Scalar,LocalOrdinal,GlobalOrdinal,Node> >& Matrix);
57 
59  virtual ~SingletonFilter();
60 
62 
64 
65 
68 
69 
72 
75 
78 
81 
84 
86  virtual global_size_t getGlobalNumRows() const;
87 
89  virtual global_size_t getGlobalNumCols() const;
90 
92  virtual size_t getLocalNumRows() const;
93 
95  virtual size_t getLocalNumCols() const;
96 
98  virtual GlobalOrdinal getIndexBase() const;
99 
101  virtual global_size_t getGlobalNumEntries() const;
102 
104  virtual size_t getLocalNumEntries() const;
105 
107 
108  virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const;
109 
111 
112  virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const;
113 
115  virtual LocalOrdinal getBlockSize () const;
116 
118  virtual size_t getGlobalMaxNumRowEntries() const;
119 
121  virtual size_t getLocalMaxNumRowEntries() const;
122 
124  virtual bool hasColMap() const;
125 
127  virtual bool isLocallyIndexed() const;
128 
130  virtual bool isGloballyIndexed() const;
131 
133  virtual bool isFillComplete() const;
134 
136  virtual bool supportsRowViews() const;
137 
139 
141 
142 
144 
154  virtual void
155  getGlobalRowCopy (GlobalOrdinal GlobalRow,
156  nonconst_global_inds_host_view_type &Indices,
157  nonconst_values_host_view_type &Values,
158  size_t& NumEntries) const;
159 
161 
171  virtual void
172  getLocalRowCopy (LocalOrdinal LocalRow,
173  nonconst_local_inds_host_view_type &Indices,
174  nonconst_values_host_view_type &Values,
175  size_t& NumEntries) const;
176 
178 
187  virtual void
188  getGlobalRowView (GlobalOrdinal GlobalRow,
189  global_inds_host_view_type &indices,
190  values_host_view_type &values) const;
191 
193 
202  virtual void
203  getLocalRowView (LocalOrdinal LocalRow,
204  local_inds_host_view_type & indices,
205  values_host_view_type & values) const;
206 
208 
210  virtual void getLocalDiagCopy(Tpetra::Vector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &diag) const;
211 
213 
215 
216 
226  virtual void leftScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
227 
237  virtual void rightScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
238 
240 
243  virtual mag_type getFrobeniusNorm() const;
244 
246 
251  virtual void apply(const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &X,
252  Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &Y,
254  Scalar alpha = Teuchos::ScalarTraits<Scalar>::one(),
255  Scalar beta = Teuchos::ScalarTraits<Scalar>::zero()) const;
256 
258  virtual bool hasTransposeApply() const;
259 
261  virtual void SolveSingletons(const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& RHS,
262  Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& LHS);
263 
264  template <class DomainScalar, class RangeScalar>
265  void SolveSingletonsTempl(const Tpetra::MultiVector<DomainScalar,LocalOrdinal,GlobalOrdinal,Node>& RHS,
266  Tpetra::MultiVector<RangeScalar,LocalOrdinal,GlobalOrdinal,Node>& LHS);
267 
269  virtual void CreateReducedRHS(const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& LHS,
270  const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& RHS,
271  Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& ReducedRHS);
272 
273  template <class DomainScalar, class RangeScalar>
274  void CreateReducedRHSTempl(const Tpetra::MultiVector<DomainScalar,LocalOrdinal,GlobalOrdinal,Node>& LHS,
275  const Tpetra::MultiVector<RangeScalar,LocalOrdinal,GlobalOrdinal,Node>& RHS,
276  Tpetra::MultiVector<RangeScalar,LocalOrdinal,GlobalOrdinal,Node>& ReducedRHS);
277 
279  virtual void UpdateLHS(const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& ReducedLHS,
280  Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node>& LHS);
281 
282  template <class DomainScalar, class RangeScalar>
283  void UpdateLHSTempl(const Tpetra::MultiVector<DomainScalar,LocalOrdinal,GlobalOrdinal,Node>& ReducedLHS,
284  Tpetra::MultiVector<RangeScalar,LocalOrdinal,GlobalOrdinal,Node>& LHS);
285 
286 
288 private:
289 
297  size_t NumSingletons_;
299  std::vector<LocalOrdinal> SingletonIndex_;
301  std::vector<LocalOrdinal> Reorder_;
303  std::vector<LocalOrdinal> InvReorder_;
305  size_t NumRows_;
307  size_t NumNonzeros_;
309  size_t MaxNumEntries_;
311  size_t MaxNumEntriesA_;
313  std::vector<size_t> NumEntries_;
315  mutable nonconst_local_inds_host_view_type Indices_;
317  mutable nonconst_values_host_view_type Values_;
318 };// class SingletonFilter
319 
320 }// namespace Ifpack2
321 
322 #endif /* IFPACK2_SINGLETONFILTER_DECL_HPP */
virtual bool hasTransposeApply() const
Indicates whether this operator supports applying the adjoint operator.
Definition: Ifpack2_SingletonFilter_def.hpp:381
virtual mag_type getFrobeniusNorm() const
Returns the Frobenius norm of the matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:481
virtual void rightScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the right with the Vector x.
Definition: Ifpack2_SingletonFilter_def.hpp:330
virtual ~SingletonFilter()
Destructor.
Definition: Ifpack2_SingletonFilter_def.hpp:110
virtual Teuchos::RCP< const Tpetra::RowGraph< LocalOrdinal, GlobalOrdinal, Node > > getGraph() const
Returns the RowGraph associated with this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:160
virtual void getLocalRowCopy(LocalOrdinal LocalRow, nonconst_local_inds_host_view_type &Indices, nonconst_values_host_view_type &Values, size_t &NumEntries) const
Extract a list of entries in a specified local row of the graph. Put into storage allocated by callin...
Definition: Ifpack2_SingletonFilter_def.hpp:274
All Ifpack2 implementations of Tpetra::RowMatrix must inherit from this class.
Definition: Ifpack2_Details_RowMatrix.hpp:30
virtual void UpdateLHS(const Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &ReducedLHS, Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &LHS)
Updates a full LHS from a reduces LHS.
Definition: Ifpack2_SingletonFilter_def.hpp:460
virtual LocalOrdinal getBlockSize() const
The number of degrees of freedom per mesh point.
Definition: Ifpack2_SingletonFilter_def.hpp:232
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRowMap() const
Returns the Map that describes the row distribution in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:124
virtual void CreateReducedRHS(const Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &LHS, const Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &RHS, Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &ReducedRHS)
Creates a RHS for the reduced singleton-free system.
Definition: Ifpack2_SingletonFilter_def.hpp:422
virtual size_t getLocalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on this node.
Definition: Ifpack2_SingletonFilter_def.hpp:226
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getDomainMap() const
Returns the Map that describes the domain distribution in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:142
virtual bool supportsRowViews() const
Returns true if RowViews are supported.
Definition: Ifpack2_SingletonFilter_def.hpp:387
virtual global_size_t getGlobalNumRows() const
Returns the number of global rows in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:166
virtual void getGlobalRowCopy(GlobalOrdinal GlobalRow, nonconst_global_inds_host_view_type &Indices, nonconst_values_host_view_type &Values, size_t &NumEntries) const
Extract a list of entries in a specified global row of this matrix. Put into pre-allocated storage...
Definition: Ifpack2_SingletonFilter_def.hpp:263
virtual GlobalOrdinal getIndexBase() const
Returns the index base for global indices for this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:190
virtual bool isFillComplete() const
Returns true if fillComplete() has been called.
Definition: Ifpack2_SingletonFilter_def.hpp:256
virtual global_size_t getGlobalNumCols() const
Returns the number of global columns in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:172
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRangeMap() const
Returns the Map that describes the range distribution in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:151
virtual bool isGloballyIndexed() const
If matrix indices are in the global range, this function returns true. Otherwise, this function retur...
Definition: Ifpack2_SingletonFilter_def.hpp:250
virtual global_size_t getGlobalNumEntries() const
Returns the global number of entries in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:196
virtual bool hasColMap() const
Indicates whether this matrix has a well-defined column map.
Definition: Ifpack2_SingletonFilter_def.hpp:238
virtual bool isLocallyIndexed() const
If matrix indices are in the local range, this function returns true. Otherwise, this function return...
Definition: Ifpack2_SingletonFilter_def.hpp:244
virtual void getLocalRowView(LocalOrdinal LocalRow, local_inds_host_view_type &indices, values_host_view_type &values) const
Extract a const, non-persisting view of local indices in a specified row of the matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:308
virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const
Returns the current number of entries on this node in the specified local row.
Definition: Ifpack2_SingletonFilter_def.hpp:214
virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const
Returns the current number of entries on this node in the specified global row.
Definition: Ifpack2_SingletonFilter_def.hpp:208
virtual size_t getLocalNumCols() const
Returns the number of columns needed to apply the forward operator on this node, i.e., the number of elements listed in the column map.
Definition: Ifpack2_SingletonFilter_def.hpp:184
virtual size_t getLocalNumEntries() const
Returns the local number of entries in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:202
virtual size_t getLocalNumRows() const
Returns the number of rows owned on the calling node.
Definition: Ifpack2_SingletonFilter_def.hpp:178
virtual size_t getGlobalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on all nodes.
Definition: Ifpack2_SingletonFilter_def.hpp:220
virtual void getLocalDiagCopy(Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &diag) const
Get a copy of the diagonal entries owned by this node, with local row indices.
Definition: Ifpack2_SingletonFilter_def.hpp:317
virtual void getGlobalRowView(GlobalOrdinal GlobalRow, global_inds_host_view_type &indices, values_host_view_type &values) const
Extract a const, non-persisting view of global indices in a specified row of the matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:299
SingletonFilter(const Teuchos::RCP< const Tpetra::RowMatrix< Scalar, LocalOrdinal, GlobalOrdinal, Node > > &Matrix)
Constructor.
Definition: Ifpack2_SingletonFilter_def.hpp:23
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const
Returns the communicator.
Definition: Ifpack2_SingletonFilter_def.hpp:114
virtual void apply(const Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &X, Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &Y, Teuchos::ETransp mode=Teuchos::NO_TRANS, Scalar alpha=Teuchos::ScalarTraits< Scalar >::one(), Scalar beta=Teuchos::ScalarTraits< Scalar >::zero()) const
Computes the operator-multivector application.
Definition: Ifpack2_SingletonFilter_def.hpp:336
virtual void SolveSingletons(const Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &RHS, Tpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &LHS)
Solve the singleton components of the linear system.
Definition: Ifpack2_SingletonFilter_def.hpp:393
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getColMap() const
Returns the Map that describes the column distribution in this matrix.
Definition: Ifpack2_SingletonFilter_def.hpp:133
Filter based on matrix entries.
Definition: Ifpack2_SingletonFilter_decl.hpp:31
virtual void leftScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the left with the Vector x.
Definition: Ifpack2_SingletonFilter_def.hpp:324