Belos  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | List of all members
Belos::details::StubTsqrAdapter< MultiVectorType > Class Template Reference

"Stub" TSQR adaptor for unsupported multivector types. More...

#include <BelosStubTsqrAdapter.hpp>

Inheritance diagram for Belos::details::StubTsqrAdapter< MultiVectorType >:
Inheritance graph
[legend]

Public Types

typedef MultiVectorType MV
 
typedef double scalar_type
 
typedef int ordinal_type
 
typedef int node_type
 
typedef
Teuchos::SerialDenseMatrix
< ordinal_type, scalar_type
dense_matrix_type
 
typedef Teuchos::ScalarTraits
< scalar_type >::magnitudeType 
magnitude_type
 

Public Member Functions

 StubTsqrAdapter (const Teuchos::RCP< Teuchos::ParameterList > &plist)
 Constructor (that accepts a parameter list). More...
 
 StubTsqrAdapter ()
 Default constructor (stub; throws std::logic_error). More...
 
 StubTsqrAdapter (const StubTsqrAdapter &rhs)
 Copy constructor (throws std::logic_error). More...
 
Teuchos::RCP< const
Teuchos::ParameterList
getValidParameters () const
 Get list of valid default parameters (stub; throws std::logic_error). More...
 
void setParameterList (const Teuchos::RCP< Teuchos::ParameterList > &plist)
 Set parameters (stub; throws std::logic_error). More...
 
void factorExplicit (MV &A, MV &Q, dense_matrix_type &R, const bool forceNonnegativeDiagonal=false)
 Compute QR factorization [Q,R] = qr(A,0) (stub; throws std::logic_error). More...
 
int revealRank (MV &Q, dense_matrix_type &R, const magnitude_type &tol)
 Rank-revealing decomposition (stub; does nothing). More...
 
- Public Member Functions inherited from Teuchos::ParameterListAcceptorDefaultBase
RCP< ParameterListgetNonconstParameterList ()
 
RCP< ParameterListunsetParameterList ()
 
RCP< const ParameterListgetParameterList () const
 

Additional Inherited Members

- Protected Member Functions inherited from Teuchos::ParameterListAcceptorDefaultBase
void setMyParamList (const RCP< ParameterList > &paramList)
 
RCP< ParameterListgetMyNonconstParamList ()
 
RCP< const ParameterListgetMyParamList () const
 

Detailed Description

template<class MultiVectorType>
class Belos::details::StubTsqrAdapter< MultiVectorType >

"Stub" TSQR adaptor for unsupported multivector types.

TSQR (Tall Skinny QR factorization) is an orthogonalization kernel that is as accurate as Householder QR, yet requires only $2 \log P$ messages between $P$ MPI processes, independently of the number of columns in the multivector.

TSQR works independently of the particular multivector implementation, and interfaces to the latter via an adapter class. Each multivector type MV needs its own adapter class. The specialization of MultiVecTraits for MV refers to its corresponding adapter class as its tsqr_adaptor_type [sic; sorry about the lack of standard spelling of "adapter"] typedef. For examples, please refer to the Epetra_MultiVector and Tpetra::MultiVector specializations of Belos::MultiVecTraits.

Nevertheless, there may be multivector types for which a TSQR adapter has not yet been written. This "stub" adapter implements the interface that TSQR adapters must implement, but all of its methods throw std::logic_error to indicate that this is a stub. Thus, it allows Belos classes like TsqrOrthoManagerImpl to compile successfully for unsupported MV types. This in turn allows OrthoManagerFactory to be templated on the MV type.

Definition at line 71 of file BelosStubTsqrAdapter.hpp.

Member Typedef Documentation

template<class MultiVectorType >
typedef MultiVectorType Belos::details::StubTsqrAdapter< MultiVectorType >::MV

Definition at line 73 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
typedef double Belos::details::StubTsqrAdapter< MultiVectorType >::scalar_type

Definition at line 74 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
typedef int Belos::details::StubTsqrAdapter< MultiVectorType >::ordinal_type

Definition at line 75 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
typedef int Belos::details::StubTsqrAdapter< MultiVectorType >::node_type

Definition at line 76 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
typedef Teuchos::SerialDenseMatrix<ordinal_type, scalar_type> Belos::details::StubTsqrAdapter< MultiVectorType >::dense_matrix_type

Definition at line 77 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
typedef Teuchos::ScalarTraits<scalar_type>::magnitudeType Belos::details::StubTsqrAdapter< MultiVectorType >::magnitude_type

Definition at line 78 of file BelosStubTsqrAdapter.hpp.

Constructor & Destructor Documentation

template<class MultiVectorType >
Belos::details::StubTsqrAdapter< MultiVectorType >::StubTsqrAdapter ( const Teuchos::RCP< Teuchos::ParameterList > &  plist)
inline

Constructor (that accepts a parameter list).

Parameters
plist[in] List of parameters for configuring TSQR. The specific parameter keys that are read depend on the TSQR implementation. For details, call getValidParameters() and examine the documentation embedded therein.

Definition at line 86 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
Belos::details::StubTsqrAdapter< MultiVectorType >::StubTsqrAdapter ( )
inline

Default constructor (stub; throws std::logic_error).

Definition at line 94 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
Belos::details::StubTsqrAdapter< MultiVectorType >::StubTsqrAdapter ( const StubTsqrAdapter< MultiVectorType > &  rhs)
inline

Copy constructor (throws std::logic_error).

Definition at line 102 of file BelosStubTsqrAdapter.hpp.

Member Function Documentation

template<class MultiVectorType >
Teuchos::RCP<const Teuchos::ParameterList> Belos::details::StubTsqrAdapter< MultiVectorType >::getValidParameters ( ) const
inlinevirtual

Get list of valid default parameters (stub; throws std::logic_error).

Reimplemented from Teuchos::ParameterListAcceptor.

Definition at line 112 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
void Belos::details::StubTsqrAdapter< MultiVectorType >::setParameterList ( const Teuchos::RCP< Teuchos::ParameterList > &  plist)
inlinevirtual

Set parameters (stub; throws std::logic_error).

Implements Teuchos::ParameterListAcceptor.

Definition at line 121 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
void Belos::details::StubTsqrAdapter< MultiVectorType >::factorExplicit ( MV A,
MV Q,
dense_matrix_type R,
const bool  forceNonnegativeDiagonal = false 
)
inline

Compute QR factorization [Q,R] = qr(A,0) (stub; throws std::logic_error).

Definition at line 130 of file BelosStubTsqrAdapter.hpp.

template<class MultiVectorType >
int Belos::details::StubTsqrAdapter< MultiVectorType >::revealRank ( MV Q,
dense_matrix_type R,
const magnitude_type tol 
)
inline

Rank-revealing decomposition (stub; does nothing).

Definition at line 142 of file BelosStubTsqrAdapter.hpp.


The documentation for this class was generated from the following file:

Generated on Fri Aug 14 2020 10:48:35 for Belos by doxygen 1.8.5