Ifpack2 Templated Preconditioning Package Version 1.0
Loading...
Searching...
No Matches
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
22namespace Ifpack2 {
23
29template <class MatrixType>
30class SingletonFilter : virtual public Ifpack2::Details::RowMatrix<MatrixType> {
31 public:
32 typedef typename MatrixType::scalar_type Scalar;
33 typedef typename MatrixType::local_ordinal_type LocalOrdinal;
34 typedef typename MatrixType::global_ordinal_type GlobalOrdinal;
35 typedef typename MatrixType::node_type Node;
36 typedef typename MatrixType::global_inds_host_view_type global_inds_host_view_type;
37 typedef typename MatrixType::local_inds_host_view_type local_inds_host_view_type;
38 typedef typename MatrixType::values_host_view_type values_host_view_type;
39
40 typedef typename MatrixType::nonconst_global_inds_host_view_type nonconst_global_inds_host_view_type;
41 typedef typename MatrixType::nonconst_local_inds_host_view_type nonconst_local_inds_host_view_type;
42 typedef typename MatrixType::nonconst_values_host_view_type nonconst_values_host_view_type;
43
44 typedef typename Teuchos::ScalarTraits<Scalar>::magnitudeType magnitudeType;
45 typedef Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> row_matrix_type;
46 typedef typename row_matrix_type::mag_type mag_type;
47
48 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.");
49
51
52
54 explicit SingletonFilter(const Teuchos::RCP<const Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> >& Matrix);
55
57 virtual ~SingletonFilter();
58
60
62
63
65 virtual Teuchos::RCP<const Teuchos::Comm<int> > getComm() const;
66
68 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > getRowMap() const;
69
71 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > getColMap() const;
72
74 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > getDomainMap() const;
75
77 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > getRangeMap() const;
78
80 virtual Teuchos::RCP<const Tpetra::RowGraph<LocalOrdinal, GlobalOrdinal, Node> > getGraph() const;
81
83 virtual global_size_t getGlobalNumRows() const;
84
86 virtual global_size_t getGlobalNumCols() const;
87
89 virtual size_t getLocalNumRows() const;
90
92 virtual size_t getLocalNumCols() const;
93
95 virtual GlobalOrdinal getIndexBase() const;
96
98 virtual global_size_t getGlobalNumEntries() const;
99
101 virtual size_t getLocalNumEntries() const;
102
104
105 virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const;
106
108
109 virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const;
110
112 virtual LocalOrdinal getBlockSize() const;
113
115 virtual size_t getGlobalMaxNumRowEntries() const;
116
118 virtual size_t getLocalMaxNumRowEntries() const;
119
121 virtual bool hasColMap() const;
122
124 virtual bool isLocallyIndexed() const;
125
127 virtual bool isGloballyIndexed() const;
128
130 virtual bool isFillComplete() const;
131
133 virtual bool supportsRowViews() const;
134
136
138
139
141
151 virtual void
152 getGlobalRowCopy(GlobalOrdinal GlobalRow,
153 nonconst_global_inds_host_view_type& Indices,
154 nonconst_values_host_view_type& Values,
155 size_t& NumEntries) const;
156
158
168 virtual void
169 getLocalRowCopy(LocalOrdinal LocalRow,
170 nonconst_local_inds_host_view_type& Indices,
171 nonconst_values_host_view_type& Values,
172 size_t& NumEntries) const;
173
175
184 virtual void
185 getGlobalRowView(GlobalOrdinal GlobalRow,
186 global_inds_host_view_type& indices,
187 values_host_view_type& values) const;
188
190
199 virtual void
200 getLocalRowView(LocalOrdinal LocalRow,
201 local_inds_host_view_type& indices,
202 values_host_view_type& values) const;
203
205
207 virtual void getLocalDiagCopy(Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& diag) const;
208
210
212
213
223 virtual void leftScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
224
234 virtual void rightScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
235
237
240 virtual mag_type getFrobeniusNorm() const;
241
243
248 virtual void apply(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& X,
249 Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& Y,
250 Teuchos::ETransp mode = Teuchos::NO_TRANS,
251 Scalar alpha = Teuchos::ScalarTraits<Scalar>::one(),
252 Scalar beta = Teuchos::ScalarTraits<Scalar>::zero()) const;
253
255 virtual bool hasTransposeApply() const;
256
258 virtual void SolveSingletons(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& RHS,
259 Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& LHS);
260
261 template <class DomainScalar, class RangeScalar>
262 void SolveSingletonsTempl(const Tpetra::MultiVector<DomainScalar, LocalOrdinal, GlobalOrdinal, Node>& RHS,
263 Tpetra::MultiVector<RangeScalar, LocalOrdinal, GlobalOrdinal, Node>& LHS);
264
266 virtual void CreateReducedRHS(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& LHS,
267 const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& RHS,
268 Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& ReducedRHS);
269
270 template <class DomainScalar, class RangeScalar>
271 void CreateReducedRHSTempl(const Tpetra::MultiVector<DomainScalar, LocalOrdinal, GlobalOrdinal, Node>& LHS,
272 const Tpetra::MultiVector<RangeScalar, LocalOrdinal, GlobalOrdinal, Node>& RHS,
273 Tpetra::MultiVector<RangeScalar, LocalOrdinal, GlobalOrdinal, Node>& ReducedRHS);
274
276 virtual void UpdateLHS(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& ReducedLHS,
277 Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& LHS);
278
279 template <class DomainScalar, class RangeScalar>
280 void UpdateLHSTempl(const Tpetra::MultiVector<DomainScalar, LocalOrdinal, GlobalOrdinal, Node>& ReducedLHS,
281 Tpetra::MultiVector<RangeScalar, LocalOrdinal, GlobalOrdinal, Node>& LHS);
282
284 private:
286 Teuchos::RCP<const Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> > A_;
288 Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > ReducedMap_;
290 Teuchos::RCP<Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> > Diagonal_;
292 size_t NumSingletons_;
294 std::vector<LocalOrdinal> SingletonIndex_;
296 std::vector<LocalOrdinal> Reorder_;
298 std::vector<LocalOrdinal> InvReorder_;
300 size_t NumRows_;
302 size_t NumNonzeros_;
304 size_t MaxNumEntries_;
306 size_t MaxNumEntriesA_;
308 std::vector<size_t> NumEntries_;
310 mutable nonconst_local_inds_host_view_type Indices_;
312 mutable nonconst_values_host_view_type Values_;
313}; // class SingletonFilter
314
315} // namespace Ifpack2
316
317#endif /* IFPACK2_SINGLETONFILTER_DECL_HPP */
All Ifpack2 implementations of Tpetra::RowMatrix must inherit from this class.
Definition Ifpack2_Details_RowMatrix.hpp:33
Filter based on matrix entries.
Definition Ifpack2_SingletonFilter_decl.hpp:30
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:287
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:117
virtual size_t getLocalNumEntries() const
Returns the local number of entries in this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:184
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:348
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:281
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:274
virtual size_t getLocalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on this node.
Definition Ifpack2_SingletonFilter_def.hpp:204
virtual size_t getLocalNumCols() const
Returns the number of columns needed to apply the forward operator on this node, i....
Definition Ifpack2_SingletonFilter_def.hpp:169
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:224
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:194
virtual global_size_t getGlobalNumCols() const
Returns the number of global columns in this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:159
virtual mag_type getFrobeniusNorm() const
Returns the Frobenius norm of the matrix.
Definition Ifpack2_SingletonFilter_def.hpp:429
virtual LocalOrdinal getBlockSize() const
The number of degrees of freedom per mesh point.
Definition Ifpack2_SingletonFilter_def.hpp:209
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:125
virtual global_size_t getGlobalNumEntries() const
Returns the global number of entries in this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:179
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:292
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:235
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:141
virtual bool hasTransposeApply() const
Indicates whether this operator supports applying the adjoint operator.
Definition Ifpack2_SingletonFilter_def.hpp:338
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:244
virtual Teuchos::RCP< const Tpetra::RowGraph< LocalOrdinal, GlobalOrdinal, Node > > getGraph() const
Returns the RowGraph associated with this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:149
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:189
virtual bool hasColMap() const
Indicates whether this matrix has a well-defined column map.
Definition Ifpack2_SingletonFilter_def.hpp:214
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:411
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:375
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:219
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:133
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:297
virtual global_size_t getGlobalNumRows() const
Returns the number of global rows in this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:154
virtual size_t getGlobalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on all nodes.
Definition Ifpack2_SingletonFilter_def.hpp:199
virtual GlobalOrdinal getIndexBase() const
Returns the index base for global indices for this matrix.
Definition Ifpack2_SingletonFilter_def.hpp:174
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:267
virtual bool isFillComplete() const
Returns true if fillComplete() has been called.
Definition Ifpack2_SingletonFilter_def.hpp:229
virtual ~SingletonFilter()
Destructor.
Definition Ifpack2_SingletonFilter_def.hpp:105
virtual size_t getLocalNumRows() const
Returns the number of rows owned on the calling node.
Definition Ifpack2_SingletonFilter_def.hpp:164
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const
Returns the communicator.
Definition Ifpack2_SingletonFilter_def.hpp:109
virtual bool supportsRowViews() const
Returns true if RowViews are supported.
Definition Ifpack2_SingletonFilter_def.hpp:343
Preconditioners and smoothers for Tpetra sparse matrices.
Definition Ifpack2_AdditiveSchwarz_decl.hpp:40