NDDEM
Public Types | Public Member Functions | Protected Types | Protected Attributes | Friends | List of all members
Eigen::SPQR< _MatrixType > Class Template Reference

Sparse QR factorization based on SuiteSparseQR library. More...

#include <SuiteSparseQRSupport.h>

+ Inheritance diagram for Eigen::SPQR< _MatrixType >:

Public Types

enum  { ColsAtCompileTime = Dynamic , MaxColsAtCompileTime = Dynamic }
 
typedef _MatrixType::Scalar Scalar
 
typedef _MatrixType::RealScalar RealScalar
 
typedef SuiteSparse_long StorageIndex
 
typedef SparseMatrix< Scalar, ColMajor, StorageIndexMatrixType
 
typedef Map< PermutationMatrix< Dynamic, Dynamic, StorageIndex > > PermutationType
 

Public Member Functions

 SPQR ()
 
 SPQR (const _MatrixType &matrix)
 
 ~SPQR ()
 
void SPQR_free ()
 
void compute (const _MatrixType &matrix)
 
Index rows () const
 
Index cols () const
 
template<typename Rhs , typename Dest >
void _solve_impl (const MatrixBase< Rhs > &b, MatrixBase< Dest > &dest) const
 
const MatrixType matrixR () const
 
SPQRMatrixQReturnType< SPQRmatrixQ () const
 Get an expression of the matrix Q. More...
 
PermutationType colsPermutation () const
 Get the permutation that was applied to columns of A. More...
 
Index rank () const
 
void setSPQROrdering (int ord)
 Set the fill-reducing ordering method to be used. More...
 
void setPivotThreshold (const RealScalar &tol)
 Set the tolerance tol to treat columns with 2-norm < =tol as zero. More...
 
cholmod_common * cholmodCommon () const
 
ComputationInfo info () const
 Reports whether previous computation was successful. More...
 
- Public Member Functions inherited from Eigen::SparseSolverBase< SPQR< _MatrixType > >
 SparseSolverBase ()
 
 ~SparseSolverBase ()
 
SPQR< _MatrixType > & derived ()
 
const SPQR< _MatrixType > & derived () const
 
const Solve< SPQR< _MatrixType >, Rhs > solve (const MatrixBase< Rhs > &b) const
 
const Solve< SPQR< _MatrixType >, Rhs > solve (const SparseMatrixBase< Rhs > &b) const
 
void _solve_impl (const SparseMatrixBase< Rhs > &b, SparseMatrixBase< Dest > &dest) const
 

Protected Types

typedef SparseSolverBase< SPQR< _MatrixType > > Base
 

Protected Attributes

bool m_analysisIsOk
 
bool m_factorizationIsOk
 
bool m_isRUpToDate
 
ComputationInfo m_info
 
int m_ordering
 
int m_allow_tol
 
RealScalar m_tolerance
 
cholmod_sparse * m_cR
 
MatrixType m_R
 
StorageIndexm_E
 
cholmod_sparse * m_H
 
StorageIndexm_HPinv
 
cholmod_dense * m_HTau
 
Index m_rank
 
cholmod_common m_cc
 
bool m_useDefaultThreshold
 
Index m_rows
 
- Protected Attributes inherited from Eigen::SparseSolverBase< SPQR< _MatrixType > >
bool m_isInitialized
 

Friends

template<typename , typename >
struct SPQR_QProduct
 

Detailed Description

template<typename _MatrixType>
class Eigen::SPQR< _MatrixType >

Sparse QR factorization based on SuiteSparseQR library.

This class is used to perform a multithreaded and multifrontal rank-revealing QR decomposition of sparse matrices. The result is then used to solve linear leasts_square systems. Clearly, a QR factorization is returned such that A*P = Q*R where :

P is the column permutation. Use colsPermutation() to get it.

Q is the orthogonal matrix represented as Householder reflectors. Use matrixQ() to get an expression and matrixQ().transpose() to get the transpose. You can then apply it to a vector.

R is the sparse triangular factor. Use matrixQR() to get it as SparseMatrix. NOTE : The Index type of R is always SuiteSparse_long. You can get it with SPQR::Index

Template Parameters
_MatrixTypeThe type of the sparse matrix A, must be a column-major SparseMatrix<>

\implsparsesolverconcept

Member Typedef Documentation

◆ Base

template<typename _MatrixType >
typedef SparseSolverBase<SPQR<_MatrixType> > Eigen::SPQR< _MatrixType >::Base
protected

◆ MatrixType

template<typename _MatrixType >
typedef SparseMatrix<Scalar, ColMajor, StorageIndex> Eigen::SPQR< _MatrixType >::MatrixType

◆ PermutationType

template<typename _MatrixType >
typedef Map<PermutationMatrix<Dynamic, Dynamic, StorageIndex> > Eigen::SPQR< _MatrixType >::PermutationType

◆ RealScalar

template<typename _MatrixType >
typedef _MatrixType::RealScalar Eigen::SPQR< _MatrixType >::RealScalar

◆ Scalar

template<typename _MatrixType >
typedef _MatrixType::Scalar Eigen::SPQR< _MatrixType >::Scalar

◆ StorageIndex

template<typename _MatrixType >
typedef SuiteSparse_long Eigen::SPQR< _MatrixType >::StorageIndex

Member Enumeration Documentation

◆ anonymous enum

template<typename _MatrixType >
anonymous enum
Enumerator
ColsAtCompileTime 
MaxColsAtCompileTime 

Constructor & Destructor Documentation

◆ SPQR() [1/2]

template<typename _MatrixType >
Eigen::SPQR< _MatrixType >::SPQR ( )
inline

◆ SPQR() [2/2]

template<typename _MatrixType >
Eigen::SPQR< _MatrixType >::SPQR ( const _MatrixType &  matrix)
inlineexplicit

◆ ~SPQR()

template<typename _MatrixType >
Eigen::SPQR< _MatrixType >::~SPQR ( )
inline

Member Function Documentation

◆ _solve_impl()

template<typename _MatrixType >
template<typename Rhs , typename Dest >
void Eigen::SPQR< _MatrixType >::_solve_impl ( const MatrixBase< Rhs > &  b,
MatrixBase< Dest > &  dest 
) const
inline

◆ cholmodCommon()

template<typename _MatrixType >
cholmod_common* Eigen::SPQR< _MatrixType >::cholmodCommon ( ) const
inline
Returns
a pointer to the SPQR workspace

◆ cols()

template<typename _MatrixType >
Index Eigen::SPQR< _MatrixType >::cols ( void  ) const
inline

Get the number of columns of the input matrix.

◆ colsPermutation()

template<typename _MatrixType >
PermutationType Eigen::SPQR< _MatrixType >::colsPermutation ( ) const
inline

Get the permutation that was applied to columns of A.

◆ compute()

template<typename _MatrixType >
void Eigen::SPQR< _MatrixType >::compute ( const _MatrixType &  matrix)
inline

◆ info()

template<typename _MatrixType >
ComputationInfo Eigen::SPQR< _MatrixType >::info ( ) const
inline

Reports whether previous computation was successful.

Returns
Success if computation was successful, NumericalIssue if the sparse QR can not be computed

◆ matrixQ()

template<typename _MatrixType >
SPQRMatrixQReturnType<SPQR> Eigen::SPQR< _MatrixType >::matrixQ ( void  ) const
inline

Get an expression of the matrix Q.

◆ matrixR()

template<typename _MatrixType >
const MatrixType Eigen::SPQR< _MatrixType >::matrixR ( ) const
inline
Returns
the sparse triangular factor R. It is a sparse matrix

◆ rank()

template<typename _MatrixType >
Index Eigen::SPQR< _MatrixType >::rank ( ) const
inline

Gets the rank of the matrix. It should be equal to matrixQR().cols if the matrix is full-rank

◆ rows()

template<typename _MatrixType >
Index Eigen::SPQR< _MatrixType >::rows ( void  ) const
inline

Get the number of rows of the input matrix and the Q matrix

◆ setPivotThreshold()

template<typename _MatrixType >
void Eigen::SPQR< _MatrixType >::setPivotThreshold ( const RealScalar tol)
inline

Set the tolerance tol to treat columns with 2-norm < =tol as zero.

◆ setSPQROrdering()

template<typename _MatrixType >
void Eigen::SPQR< _MatrixType >::setSPQROrdering ( int  ord)
inline

Set the fill-reducing ordering method to be used.

◆ SPQR_free()

template<typename _MatrixType >
void Eigen::SPQR< _MatrixType >::SPQR_free ( )
inline

Friends And Related Function Documentation

◆ SPQR_QProduct

template<typename _MatrixType >
template<typename , typename >
friend struct SPQR_QProduct
friend

Member Data Documentation

◆ m_allow_tol

template<typename _MatrixType >
int Eigen::SPQR< _MatrixType >::m_allow_tol
protected

◆ m_analysisIsOk

template<typename _MatrixType >
bool Eigen::SPQR< _MatrixType >::m_analysisIsOk
protected

◆ m_cc

template<typename _MatrixType >
cholmod_common Eigen::SPQR< _MatrixType >::m_cc
mutableprotected

◆ m_cR

template<typename _MatrixType >
cholmod_sparse* Eigen::SPQR< _MatrixType >::m_cR
mutableprotected

◆ m_E

template<typename _MatrixType >
StorageIndex* Eigen::SPQR< _MatrixType >::m_E
mutableprotected

◆ m_factorizationIsOk

template<typename _MatrixType >
bool Eigen::SPQR< _MatrixType >::m_factorizationIsOk
protected

◆ m_H

template<typename _MatrixType >
cholmod_sparse* Eigen::SPQR< _MatrixType >::m_H
mutableprotected

◆ m_HPinv

template<typename _MatrixType >
StorageIndex* Eigen::SPQR< _MatrixType >::m_HPinv
mutableprotected

◆ m_HTau

template<typename _MatrixType >
cholmod_dense* Eigen::SPQR< _MatrixType >::m_HTau
mutableprotected

◆ m_info

template<typename _MatrixType >
ComputationInfo Eigen::SPQR< _MatrixType >::m_info
mutableprotected

◆ m_isRUpToDate

template<typename _MatrixType >
bool Eigen::SPQR< _MatrixType >::m_isRUpToDate
mutableprotected

◆ m_ordering

template<typename _MatrixType >
int Eigen::SPQR< _MatrixType >::m_ordering
protected

◆ m_R

template<typename _MatrixType >
MatrixType Eigen::SPQR< _MatrixType >::m_R
mutableprotected

◆ m_rank

template<typename _MatrixType >
Index Eigen::SPQR< _MatrixType >::m_rank
mutableprotected

◆ m_rows

template<typename _MatrixType >
Index Eigen::SPQR< _MatrixType >::m_rows
protected

◆ m_tolerance

template<typename _MatrixType >
RealScalar Eigen::SPQR< _MatrixType >::m_tolerance
protected

◆ m_useDefaultThreshold

template<typename _MatrixType >
bool Eigen::SPQR< _MatrixType >::m_useDefaultThreshold
protected

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