Ifpack2 Templated Preconditioning Package Version 1.0
Loading...
Searching...
No Matches
Ifpack2_Preconditioner.hpp
Go to the documentation of this file.
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
11
12#ifndef IFPACK2_PRECONDITIONER_HPP
13#define IFPACK2_PRECONDITIONER_HPP
14
15#include "Ifpack2_ConfigDefs.hpp"
16#include "Tpetra_Operator.hpp"
17#include "Tpetra_RowMatrix.hpp"
18#include "Teuchos_ParameterList.hpp"
19#include "Teuchos_ScalarTraits.hpp"
20#include <iostream>
21
22namespace Ifpack2 {
23
66template <class Scalar =
67 Tpetra::Operator<>::scalar_type,
68 class LocalOrdinal =
69 typename Tpetra::Operator<Scalar>::local_ordinal_type,
70 class GlobalOrdinal =
71 typename Tpetra::Operator<Scalar, LocalOrdinal>::global_ordinal_type,
72 class Node =
73 typename Tpetra::Operator<Scalar, LocalOrdinal, GlobalOrdinal>::node_type>
74class Preconditioner : virtual public Tpetra::Operator<Scalar, LocalOrdinal, GlobalOrdinal, Node> {
75 public:
77 typedef typename Teuchos::ScalarTraits<Scalar>::magnitudeType magnitude_type;
78
80 virtual ~Preconditioner() {}
81
83
84
89 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> >
90 getDomainMap() const = 0;
91
96 virtual Teuchos::RCP<const Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node> >
97 getRangeMap() const = 0;
98
104 virtual void
105 apply(const Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &X,
106 Tpetra::MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &Y,
107 Teuchos::ETransp mode = Teuchos::NO_TRANS,
108 Scalar alpha = Teuchos::ScalarTraits<Scalar>::one(),
109 Scalar beta = Teuchos::ScalarTraits<Scalar>::zero()) const = 0;
111
113 virtual void setParameters(const Teuchos::ParameterList &List) = 0;
114
115 virtual bool supportsZeroStartingSolution() { return false; };
116
118 virtual void setZeroStartingSolution(bool zeroStartingSolution) { TEUCHOS_ASSERT(false); };
119
129 virtual void initialize() = 0;
130
132 virtual bool isInitialized() const = 0;
133
143 virtual void compute() = 0;
144
146 virtual bool isComputed() const = 0;
147
149 virtual Teuchos::RCP<const Tpetra::RowMatrix<Scalar, LocalOrdinal, GlobalOrdinal, Node> > getMatrix() const = 0;
150
152 virtual int getNumInitialize() const = 0;
153
155 virtual int getNumCompute() const = 0;
156
158 virtual int getNumApply() const = 0;
159
161 virtual double getInitializeTime() const = 0;
162
164 virtual double getComputeTime() const = 0;
165
167 virtual double getApplyTime() const = 0;
168};
169
170} // namespace Ifpack2
171
172#endif // IFPACK2_PRECONDITIONER_HPP
Interface for all Ifpack2 preconditioners.
Definition Ifpack2_Preconditioner.hpp:74
virtual double getComputeTime() const =0
The time (in seconds) spent in compute().
virtual void setZeroStartingSolution(bool zeroStartingSolution)
Set this preconditioner's parameters.
Definition Ifpack2_Preconditioner.hpp:118
virtual bool isInitialized() const =0
True if the preconditioner has been successfully initialized, else false.
Teuchos::ScalarTraits< Scalar >::magnitudeType magnitude_type
The type of the magnitude (absolute value) of a matrix entry.
Definition Ifpack2_Preconditioner.hpp:77
virtual void compute()=0
Set up the numerical values in this preconditioner.
virtual int getNumCompute() const =0
The number of calls to compute().
virtual Teuchos::RCP< const Tpetra::RowMatrix< Scalar, LocalOrdinal, GlobalOrdinal, Node > > getMatrix() const =0
The input matrix given to the constructor.
virtual int getNumApply() const =0
The number of calls to apply().
virtual double getApplyTime() const =0
The time (in seconds) spent in apply().
virtual void setParameters(const Teuchos::ParameterList &List)=0
Set this preconditioner's parameters.
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 =0
Apply the preconditioner to X, putting the result in Y.
virtual ~Preconditioner()
Destructor.
Definition Ifpack2_Preconditioner.hpp:80
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getRangeMap() const =0
The range Map of this operator.
virtual Teuchos::RCP< const Tpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getDomainMap() const =0
The domain Map of this operator.
virtual bool isComputed() const =0
True if the preconditioner has been successfully computed, else false.
virtual void initialize()=0
Set up the graph structure of this preconditioner.
virtual double getInitializeTime() const =0
The time (in seconds) spent in initialize().
virtual int getNumInitialize() const =0
The number of calls to initialize().
Preconditioners and smoothers for Tpetra sparse matrices.
Definition Ifpack2_AdditiveSchwarz_decl.hpp:40