Ifpack2 Templated Preconditioning Package  Version 1.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Ifpack2_DiagonalFilter_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_DIAGONALFILTER_DECL_HPP
11 #define IFPACK2_DIAGONALFILTER_DECL_HPP
12 
13 #include "Ifpack2_Details_RowMatrix.hpp"
14 #include <type_traits>
15 
16 namespace Ifpack2 {
17 
19 
41 template <class MatrixType>
42 class DiagonalFilter : virtual public Ifpack2::Details::RowMatrix<MatrixType> {
43  public:
44  typedef typename MatrixType::scalar_type Scalar;
45  typedef typename MatrixType::local_ordinal_type LocalOrdinal;
46  typedef typename MatrixType::global_ordinal_type GlobalOrdinal;
47  typedef typename MatrixType::node_type Node;
48  typedef typename MatrixType::global_inds_host_view_type global_inds_host_view_type;
49  typedef typename MatrixType::local_inds_host_view_type local_inds_host_view_type;
50  typedef typename MatrixType::values_host_view_type values_host_view_type;
51 
52  typedef typename MatrixType::nonconst_global_inds_host_view_type nonconst_global_inds_host_view_type;
53  typedef typename MatrixType::nonconst_local_inds_host_view_type nonconst_local_inds_host_view_type;
54  typedef typename MatrixType::nonconst_values_host_view_type nonconst_values_host_view_type;
55 
56  typedef typename Teuchos::ScalarTraits<Scalar>::magnitudeType magnitudeType;
57  typedef Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> row_matrix_type;
58  typedef typename row_matrix_type::mag_type mag_type;
59 
60  static_assert(std::is_same<MatrixType, Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> >::value, "Ifpack2::DiagonalFilter: The template parameter MatrixType must be a Tpetra::RowMatrix specialization. Please don't use Tpetra::CrsMatrix (a subclass of Tpetra::RowMatrix) here anymore. The constructor can take either a RowMatrix or a CrsMatrix just fine.");
61 
63 
64 
66  explicit DiagonalFilter(const Teuchos::RCP<const Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> > &Matrix,
67  magnitudeType AbsoluteThreshold,
68  magnitudeType RelativeThreshold);
69 
71  virtual ~DiagonalFilter();
72 
74 
76 
77 
80 
83 
86 
89 
92 
95 
97  virtual global_size_t getGlobalNumRows() const;
98 
100  virtual global_size_t getGlobalNumCols() const;
101 
103  virtual size_t getLocalNumRows() const;
104 
106  virtual size_t getLocalNumCols() const;
107 
109  virtual GlobalOrdinal getIndexBase() const;
110 
112  virtual global_size_t getGlobalNumEntries() const;
113 
115  virtual size_t getLocalNumEntries() const;
116 
118 
119  virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const;
120 
122 
123  virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const;
124 
126  virtual size_t getGlobalMaxNumRowEntries() const;
127 
129  virtual size_t getLocalMaxNumRowEntries() const;
130 
132  virtual LocalOrdinal getBlockSize() const;
133 
135  virtual bool hasColMap() const;
136 
138  virtual bool isLocallyIndexed() const;
139 
141  virtual bool isGloballyIndexed() const;
142 
144  virtual bool isFillComplete() const;
145 
147  virtual bool supportsRowViews() const;
148 
150 
152 
153 
155 
165  virtual void
166  getGlobalRowCopy(GlobalOrdinal GlobalRow,
167  nonconst_global_inds_host_view_type &Indices,
168  nonconst_values_host_view_type &Values,
169  size_t &NumEntries) const;
170 
172 
182  virtual void
183  getLocalRowCopy(LocalOrdinal LocalRow,
184  nonconst_local_inds_host_view_type &Indices,
185  nonconst_values_host_view_type &Values,
186  size_t &NumEntries) const;
187 
189 
198  virtual void
199  getGlobalRowView(GlobalOrdinal GlobalRow,
200  global_inds_host_view_type &indices,
201  values_host_view_type &values) const;
202 
204 
213  virtual void
214  getLocalRowView(LocalOrdinal LocalRow,
215  local_inds_host_view_type &indices,
216  values_host_view_type &values) const;
217 
219 
221  virtual void getLocalDiagCopy(Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &diag) const;
222 
224 
226 
227 
237  virtual void leftScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &x);
238 
248  virtual void rightScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &x);
249 
251 
254  virtual mag_type getFrobeniusNorm() const;
255 
257 
264  virtual void apply(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &X,
265  Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &Y,
267  Scalar alpha = Teuchos::ScalarTraits<Scalar>::one(),
268  Scalar beta = Teuchos::ScalarTraits<Scalar>::zero()) const;
269 
271  virtual bool hasTransposeApply() const;
272 
274  private:
278  magnitudeType AbsoluteThreshold_;
280  magnitudeType RelativeThreshold_;
282  std::vector<LocalOrdinal> pos_;
285 
286 }; // class DiagonalFilter
287 
288 } // namespace Ifpack2
289 
290 #endif /* IFPACK2_DIAGONALFILTER_DECL_HPP */
virtual mag_type getFrobeniusNorm() const
Returns the Frobenius norm of the matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:274
Ifpack2_DiagonalFilter: Filter to modify the diagonal entries of a given Tpetra_RowMatrix.
Definition: Ifpack2_DiagonalFilter_decl.hpp:42
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const
Returns the communicator.
Definition: Ifpack2_DiagonalFilter_def.hpp:62
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_DiagonalFilter_def.hpp:250
All Ifpack2 implementations of Tpetra::RowMatrix must inherit from this class.
Definition: Ifpack2_Details_RowMatrix.hpp:30
virtual global_size_t getGlobalNumRows() const
Returns the number of global rows in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:107
virtual global_size_t getGlobalNumEntries() const
Returns the global number of entries in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:132
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_DiagonalFilter_def.hpp:188
virtual LocalOrdinal getBlockSize() const
The number of degrees of freedom per mesh point.
Definition: Ifpack2_DiagonalFilter_def.hpp:162
virtual ~DiagonalFilter()
Destructor.
Definition: Ifpack2_DiagonalFilter_def.hpp:59
virtual size_t getLocalNumEntries() const
Returns the local number of entries in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:137
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_DiagonalFilter_def.hpp:122
virtual bool hasTransposeApply() const
Indicates whether this operator supports applying the adjoint operator.
Definition: Ifpack2_DiagonalFilter_def.hpp:264
virtual size_t getGlobalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on all nodes.
Definition: Ifpack2_DiagonalFilter_def.hpp:152
virtual GlobalOrdinal getIndexBase() const
Returns the index base for global indices for this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:127
virtual bool isGloballyIndexed() const
If matrix indices are in the global range, this function returns true. Otherwise, this function retur...
Definition: Ifpack2_DiagonalFilter_def.hpp:177
virtual void leftScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the left with the Vector x.
Definition: Ifpack2_DiagonalFilter_def.hpp:239
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_DiagonalFilter_def.hpp:205
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRowMap() const
Returns the Map that describes the row distribution in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:70
virtual bool hasColMap() const
Indicates whether this matrix has a well-defined column map.
Definition: Ifpack2_DiagonalFilter_def.hpp:167
virtual void rightScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the right with the Vector x.
Definition: Ifpack2_DiagonalFilter_def.hpp:244
virtual size_t getLocalNumRows() const
Returns the number of rows owned on the calling node.
Definition: Ifpack2_DiagonalFilter_def.hpp:117
virtual Teuchos::RCP< const Tpetra::RowGraph< LocalOrdinal, GlobalOrdinal, Node > > getGraph() const
Returns the RowGraph associated with this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:102
virtual bool isFillComplete() const
Returns true if fillComplete() has been called.
Definition: Ifpack2_DiagonalFilter_def.hpp:182
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_DiagonalFilter_def.hpp:232
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_DiagonalFilter_def.hpp:218
virtual bool isLocallyIndexed() const
If matrix indices are in the local range, this function returns true. Otherwise, this function return...
Definition: Ifpack2_DiagonalFilter_def.hpp:172
DiagonalFilter(const Teuchos::RCP< const Tpetra::RowMatrix< Scalar, LocalOrdinal, GlobalOrdinal, Node > > &Matrix, magnitudeType AbsoluteThreshold, magnitudeType RelativeThreshold)
Constructor.
Definition: Ifpack2_DiagonalFilter_def.hpp:24
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRangeMap() const
Returns the Map that describes the range distribution in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:94
virtual global_size_t getGlobalNumCols() const
Returns the number of global columns in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:112
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getDomainMap() const
Returns the Map that describes the domain distribution in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:86
virtual size_t getLocalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on this node.
Definition: Ifpack2_DiagonalFilter_def.hpp:157
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getColMap() const
Returns the Map that describes the column distribution in this matrix.
Definition: Ifpack2_DiagonalFilter_def.hpp:78
virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const
Returns the current number of entries on this node in the specified global row.
Definition: Ifpack2_DiagonalFilter_def.hpp:142
virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const
Returns the current number of entries on this node in the specified local row.
Definition: Ifpack2_DiagonalFilter_def.hpp:147
virtual bool supportsRowViews() const
Returns true if RowViews are supported.
Definition: Ifpack2_DiagonalFilter_def.hpp:269
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_DiagonalFilter_def.hpp:225