Ifpack2 Templated Preconditioning Package Version 1.0
Loading...
Searching...
No Matches
Ifpack2_SparsityFilter_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_SPARSITYFILTER_DECL_HPP
11#define IFPACK2_SPARSITYFILTER_DECL_HPP
12
13#include "Ifpack2_ConfigDefs.hpp"
14#include "Ifpack2_Details_RowMatrix.hpp"
15#include "Teuchos_ScalarTraits.hpp"
16
17namespace Ifpack2 {
18
48template<class MatrixType>
50 virtual public Ifpack2::Details::RowMatrix<MatrixType> {
51public:
52 typedef typename MatrixType::scalar_type Scalar;
53 typedef typename MatrixType::local_ordinal_type LocalOrdinal;
54 typedef typename MatrixType::global_ordinal_type GlobalOrdinal;
55 typedef typename MatrixType::node_type Node;
56 typedef typename MatrixType::global_inds_host_view_type global_inds_host_view_type;
57 typedef typename MatrixType::local_inds_host_view_type local_inds_host_view_type;
58 typedef typename MatrixType::values_host_view_type values_host_view_type;
59
60 typedef typename MatrixType::nonconst_global_inds_host_view_type nonconst_global_inds_host_view_type;
61 typedef typename MatrixType::nonconst_local_inds_host_view_type nonconst_local_inds_host_view_type;
62 typedef typename MatrixType::nonconst_values_host_view_type nonconst_values_host_view_type;
63
64 typedef typename Teuchos::ScalarTraits<Scalar>::magnitudeType magnitudeType;
65 typedef Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> row_matrix_type;
66 typedef typename row_matrix_type::mag_type mag_type;
67
68 static_assert(std::is_same<MatrixType, row_matrix_type>::value, "Ifpack2::SparsityFilter: The template parameter MatrixType must be a Tpetra::RowMatrix specialization. Please don't use Tpetra::CrsMatrix (a subclass of Tpetra::RowMatrix) here anymore.");
69
70
72
73
75 explicit SparsityFilter (const Teuchos::RCP<const row_matrix_type>& Matrix,
76 size_t AllowedNumEntries,
77 LocalOrdinal AllowedBandwidth = -Teuchos::ScalarTraits<LocalOrdinal>::one());
79 virtual ~SparsityFilter();
80
82
84
86 virtual Teuchos::RCP<const Teuchos::Comm<int> > getComm() const;
87
88
90 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal,GlobalOrdinal,Node> > getRowMap() const;
91
93 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal,GlobalOrdinal,Node> > getColMap() const;
94
96 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal,GlobalOrdinal,Node> > getDomainMap() const;
97
99 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal,GlobalOrdinal,Node> > getRangeMap() const;
100
102 virtual Teuchos::RCP<const Tpetra::RowGraph<LocalOrdinal,GlobalOrdinal,Node> > getGraph() const;
103
105 virtual global_size_t getGlobalNumRows() const;
106
108 virtual global_size_t getGlobalNumCols() const;
109
111 virtual size_t getLocalNumRows() const;
112
114 virtual size_t getLocalNumCols() const;
115
117 virtual GlobalOrdinal getIndexBase() const;
118
120 virtual global_size_t getGlobalNumEntries() const;
121
123 virtual size_t getLocalNumEntries() const;
124
126
127 virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const;
128
130
131 virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const;
132
134 virtual size_t getGlobalMaxNumRowEntries() const;
135
137 virtual size_t getLocalMaxNumRowEntries() const;
138
140 virtual LocalOrdinal getBlockSize () const;
141
143 virtual bool hasColMap() const;
144
146 virtual bool isLocallyIndexed() const;
147
149 virtual bool isGloballyIndexed() const;
150
152 virtual bool isFillComplete() const;
153
155 virtual bool supportsRowViews() const;
156
158
160
161
163
173 virtual void
174 getGlobalRowCopy (GlobalOrdinal GlobalRow,
175 nonconst_global_inds_host_view_type &Indices,
176 nonconst_values_host_view_type &Values,
177 size_t& NumEntries) const;
178
180
190
191 virtual void
192 getLocalRowCopy (LocalOrdinal LocalRow,
193 nonconst_local_inds_host_view_type &Indices,
194 nonconst_values_host_view_type &Values,
195 size_t& NumEntries) const;
196
198
207 virtual void
208 getGlobalRowView (GlobalOrdinal GlobalRow,
209 global_inds_host_view_type &indices,
210 values_host_view_type &values) const;
211
213
222 virtual void
223 getLocalRowView (LocalOrdinal LocalRow,
224 local_inds_host_view_type & indices,
225 values_host_view_type & values) const;
226
228
230 virtual void getLocalDiagCopy(Tpetra::Vector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &diag) const;
231
233
235
236
246 virtual void leftScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
247
257 virtual void rightScale(const Tpetra::Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& x);
258
260
263 virtual mag_type getFrobeniusNorm() const;
264
266
271 virtual void apply(const Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &X,
272 Tpetra::MultiVector<Scalar,LocalOrdinal,GlobalOrdinal,Node> &Y,
273 Teuchos::ETransp mode = Teuchos::NO_TRANS,
274 Scalar alpha = Teuchos::ScalarTraits<Scalar>::one(),
275 Scalar beta = Teuchos::ScalarTraits<Scalar>::zero()) const;
276
278 virtual bool hasTransposeApply() const;
279
281private:
282
284 Teuchos::RCP<const Tpetra::RowMatrix<Scalar,LocalOrdinal,GlobalOrdinal,Node> > A_;
285
287 size_t AllowedNumEntries_;
289 LocalOrdinal AllowedBandwidth_;
291 size_t NumRows_;
293 size_t NumNonzeros_;
295 size_t MaxNumEntries_;
297 size_t MaxNumEntriesA_;
299 std::vector<size_t> NumEntries_;
301 mutable nonconst_local_inds_host_view_type Indices_;
303 mutable nonconst_values_host_view_type Values_;
304
305};// class SparsityFilter
306
307}// namespace Ifpack2
308
309#endif /* IFPACK2_SPARSITYFILTER_DECL_HPP */
All Ifpack2 implementations of Tpetra::RowMatrix must inherit from this class.
Definition Ifpack2_Details_RowMatrix.hpp:34
virtual global_size_t getGlobalNumRows() const
Returns the number of global rows in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:138
virtual size_t getNumEntriesInLocalRow(LocalOrdinal localRow) const
Returns the current number of entries on this node in the specified local row.
Definition Ifpack2_SparsityFilter_def.hpp:195
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_SparsityFilter_def.hpp:331
virtual bool hasTransposeApply() const
Indicates whether this operator supports applying the adjoint operator.
Definition Ifpack2_SparsityFilter_def.hpp:406
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getDomainMap() const
Returns the Map that describes the domain distribution in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:111
virtual GlobalOrdinal getIndexBase() const
Returns the index base for global indices for this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:167
virtual mag_type getFrobeniusNorm() const
Returns the Frobenius norm of the matrix.
Definition Ifpack2_SparsityFilter_def.hpp:420
virtual global_size_t getGlobalNumEntries() const
Returns the global number of entries in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:174
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const
Returns the communicator.
Definition Ifpack2_SparsityFilter_def.hpp:80
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRowMap() const
Returns the Map that describes the row distribution in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:91
virtual size_t getLocalNumCols() const
Returns the number of columns needed to apply the forward operator on this node, i....
Definition Ifpack2_SparsityFilter_def.hpp:160
virtual LocalOrdinal getBlockSize() const
The number of degrees of freedom per mesh point.
Definition Ifpack2_SparsityFilter_def.hpp:216
virtual size_t getNumEntriesInGlobalRow(GlobalOrdinal globalRow) const
Returns the current number of entries on this node in the specified global row.
Definition Ifpack2_SparsityFilter_def.hpp:188
virtual size_t getLocalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on this node.
Definition Ifpack2_SparsityFilter_def.hpp:209
virtual ~SparsityFilter()
Destructor.
Definition Ifpack2_SparsityFilter_def.hpp:76
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_SparsityFilter_def.hpp:322
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_SparsityFilter_def.hpp:340
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_SparsityFilter_def.hpp:252
virtual bool isLocallyIndexed() const
If matrix indices are in the local range, this function returns true. Otherwise, this function return...
Definition Ifpack2_SparsityFilter_def.hpp:230
virtual global_size_t getGlobalNumCols() const
Returns the number of global columns in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:145
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRangeMap() const
Returns the Map that describes the range distribution in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:121
virtual bool hasColMap() const
Indicates whether this matrix has a well-defined column map.
Definition Ifpack2_SparsityFilter_def.hpp:223
virtual void rightScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the right with the Vector x.
Definition Ifpack2_SparsityFilter_def.hpp:355
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_SparsityFilter_def.hpp:362
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getColMap() const
Returns the Map that describes the column distribution in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:101
virtual bool supportsRowViews() const
Returns true if RowViews are supported.
Definition Ifpack2_SparsityFilter_def.hpp:413
virtual bool isFillComplete() const
Returns true if fillComplete() has been called.
Definition Ifpack2_SparsityFilter_def.hpp:244
virtual void leftScale(const Tpetra::Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &x)
Scales the RowMatrix on the left with the Vector x.
Definition Ifpack2_SparsityFilter_def.hpp:348
virtual Teuchos::RCP< const Tpetra::RowGraph< LocalOrdinal, GlobalOrdinal, Node > > getGraph() const
Returns the RowGraph associated with this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:131
virtual size_t getLocalNumRows() const
Returns the number of rows owned on the calling node.
Definition Ifpack2_SparsityFilter_def.hpp:152
SparsityFilter(const Teuchos::RCP< const row_matrix_type > &Matrix, size_t AllowedNumEntries, LocalOrdinal AllowedBandwidth=-Teuchos::ScalarTraits< LocalOrdinal >::one())
Constructor.
Definition Ifpack2_SparsityFilter_def.hpp:24
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_SparsityFilter_def.hpp:262
virtual size_t getGlobalMaxNumRowEntries() const
Returns the maximum number of entries across all rows/columns on all nodes.
Definition Ifpack2_SparsityFilter_def.hpp:202
virtual size_t getLocalNumEntries() const
Returns the local number of entries in this matrix.
Definition Ifpack2_SparsityFilter_def.hpp:181
virtual bool isGloballyIndexed() const
If matrix indices are in the global range, this function returns true. Otherwise, this function retur...
Definition Ifpack2_SparsityFilter_def.hpp:237
Preconditioners and smoothers for Tpetra sparse matrices.
Definition Ifpack2_AdditiveSchwarz_decl.hpp:41