|  | /* | 
|  | Copyright (c) 2011, Intel Corporation. All rights reserved. | 
|  |  | 
|  | Redistribution and use in source and binary forms, with or without modification, | 
|  | are permitted provided that the following conditions are met: | 
|  |  | 
|  | * Redistributions of source code must retain the above copyright notice, this | 
|  | list of conditions and the following disclaimer. | 
|  | * Redistributions in binary form must reproduce the above copyright notice, | 
|  | this list of conditions and the following disclaimer in the documentation | 
|  | and/or other materials provided with the distribution. | 
|  | * Neither the name of Intel Corporation nor the names of its contributors may | 
|  | be used to endorse or promote products derived from this software without | 
|  | specific prior written permission. | 
|  |  | 
|  | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND | 
|  | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | 
|  | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | 
|  | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR | 
|  | ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | 
|  | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | 
|  | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON | 
|  | ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 
|  | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | 
|  | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 
|  |  | 
|  | ******************************************************************************** | 
|  | *   Content : Eigen bindings to LAPACKe | 
|  | *    Householder QR decomposition of a matrix with column pivoting based on | 
|  | *    LAPACKE_?geqp3 function. | 
|  | ******************************************************************************** | 
|  | */ | 
|  |  | 
|  | #ifndef EIGEN_COLPIVOTINGHOUSEHOLDERQR_LAPACKE_H | 
|  | #define EIGEN_COLPIVOTINGHOUSEHOLDERQR_LAPACKE_H | 
|  |  | 
|  | // IWYU pragma: private | 
|  | #include "./InternalHeaderCheck.h" | 
|  |  | 
|  | namespace Eigen { | 
|  |  | 
|  | #if defined(EIGEN_USE_LAPACKE) | 
|  |  | 
|  | template <typename Scalar> | 
|  | inline lapack_int call_geqp3(int matrix_layout, lapack_int m, lapack_int n, Scalar* a, lapack_int lda, lapack_int* jpvt, | 
|  | Scalar* tau); | 
|  | template <> | 
|  | inline lapack_int call_geqp3(int matrix_layout, lapack_int m, lapack_int n, float* a, lapack_int lda, lapack_int* jpvt, | 
|  | float* tau) { | 
|  | return LAPACKE_sgeqp3(matrix_layout, m, n, a, lda, jpvt, tau); | 
|  | } | 
|  | template <> | 
|  | inline lapack_int call_geqp3(int matrix_layout, lapack_int m, lapack_int n, double* a, lapack_int lda, lapack_int* jpvt, | 
|  | double* tau) { | 
|  | return LAPACKE_dgeqp3(matrix_layout, m, n, a, lda, jpvt, tau); | 
|  | } | 
|  | template <> | 
|  | inline lapack_int call_geqp3(int matrix_layout, lapack_int m, lapack_int n, lapack_complex_float* a, lapack_int lda, | 
|  | lapack_int* jpvt, lapack_complex_float* tau) { | 
|  | return LAPACKE_cgeqp3(matrix_layout, m, n, a, lda, jpvt, tau); | 
|  | } | 
|  | template <> | 
|  | inline lapack_int call_geqp3(int matrix_layout, lapack_int m, lapack_int n, lapack_complex_double* a, lapack_int lda, | 
|  | lapack_int* jpvt, lapack_complex_double* tau) { | 
|  | return LAPACKE_zgeqp3(matrix_layout, m, n, a, lda, jpvt, tau); | 
|  | } | 
|  |  | 
|  | template <typename MatrixType> | 
|  | struct ColPivHouseholderQR_LAPACKE_impl { | 
|  | typedef typename MatrixType::Scalar Scalar; | 
|  | typedef typename MatrixType::RealScalar RealScalar; | 
|  | typedef typename internal::lapacke_helpers::translate_type_imp<Scalar>::type LapackeType; | 
|  | static constexpr int LapackeStorage = MatrixType::IsRowMajor ? (LAPACK_ROW_MAJOR) : (LAPACK_COL_MAJOR); | 
|  |  | 
|  | typedef typename internal::plain_diag_type<MatrixType>::type HCoeffsType; | 
|  | typedef PermutationMatrix<Dynamic, Dynamic, lapack_int> PermutationType; | 
|  |  | 
|  | static void run(MatrixType& qr, HCoeffsType& hCoeffs, PermutationType& colsPermutation, Index& nonzero_pivots, | 
|  | RealScalar& maxpivot, bool usePrescribedThreshold, RealScalar prescribedThreshold, Index& det_p, | 
|  | bool& isInitialized) { | 
|  | isInitialized = false; | 
|  | hCoeffs.resize(qr.diagonalSize()); | 
|  | nonzero_pivots = 0; | 
|  | maxpivot = RealScalar(0); | 
|  | colsPermutation.resize(qr.cols()); | 
|  | colsPermutation.indices().setZero(); | 
|  |  | 
|  | lapack_int rows = internal::lapacke_helpers::to_lapack(qr.rows()); | 
|  | lapack_int cols = internal::lapacke_helpers::to_lapack(qr.cols()); | 
|  | LapackeType* qr_data = (LapackeType*)(qr.data()); | 
|  | lapack_int lda = internal::lapacke_helpers::to_lapack(qr.outerStride()); | 
|  | lapack_int* perm_data = colsPermutation.indices().data(); | 
|  | LapackeType* hCoeffs_data = (LapackeType*)(hCoeffs.data()); | 
|  |  | 
|  | lapack_int info = call_geqp3(LapackeStorage, rows, cols, qr_data, lda, perm_data, hCoeffs_data); | 
|  | if (info != 0) return; | 
|  |  | 
|  | maxpivot = qr.diagonal().cwiseAbs().maxCoeff(); | 
|  | hCoeffs.adjointInPlace(); | 
|  | RealScalar defaultThreshold = NumTraits<RealScalar>::epsilon() * RealScalar(qr.diagonalSize()); | 
|  | RealScalar threshold = usePrescribedThreshold ? prescribedThreshold : defaultThreshold; | 
|  | RealScalar premultiplied_threshold = maxpivot * threshold; | 
|  | nonzero_pivots = (qr.diagonal().cwiseAbs().array() > premultiplied_threshold).count(); | 
|  | colsPermutation.indices().array() -= 1; | 
|  | det_p = colsPermutation.determinant(); | 
|  | isInitialized = true; | 
|  | }; | 
|  |  | 
|  | static void init(Index rows, Index cols, HCoeffsType& hCoeffs, PermutationType& colsPermutation, | 
|  | bool& usePrescribedThreshold, bool& isInitialized) { | 
|  | Index diag = numext::mini(rows, cols); | 
|  | hCoeffs.resize(diag); | 
|  | colsPermutation.resize(cols); | 
|  | usePrescribedThreshold = false; | 
|  | isInitialized = false; | 
|  | } | 
|  | }; | 
|  |  | 
|  | #define COLPIVQR_LAPACKE_COMPUTEINPLACE(EIGTYPE)                                                                   \ | 
|  | template <>                                                                                                      \ | 
|  | inline void ColPivHouseholderQR<EIGTYPE, lapack_int>::computeInPlace() {                                         \ | 
|  | ColPivHouseholderQR_LAPACKE_impl<MatrixType>::run(m_qr, m_hCoeffs, m_colsPermutation, m_nonzero_pivots,        \ | 
|  | m_maxpivot, m_usePrescribedThreshold, m_prescribedThreshold, \ | 
|  | m_det_p, m_isInitialized);                                   \ | 
|  | } | 
|  |  | 
|  | #define COLPIVQR_LAPACKE_INIT(EIGTYPE)                                                                            \ | 
|  | template <>                                                                                                     \ | 
|  | inline void ColPivHouseholderQR<EIGTYPE, lapack_int>::init(Index rows, Index cols) {                            \ | 
|  | ColPivHouseholderQR_LAPACKE_impl<MatrixType>::init(rows, cols, m_hCoeffs, m_colsPermutation, m_isInitialized, \ | 
|  | m_usePrescribedThreshold);                                 \ | 
|  | } | 
|  |  | 
|  | #define COLPIVQR_LAPACKE(EIGTYPE)               \ | 
|  | COLPIVQR_LAPACKE_COMPUTEINPLACE(EIGTYPE)      \ | 
|  | COLPIVQR_LAPACKE_INIT(EIGTYPE)                \ | 
|  | COLPIVQR_LAPACKE_COMPUTEINPLACE(Ref<EIGTYPE>) \ | 
|  | COLPIVQR_LAPACKE_INIT(Ref<EIGTYPE>) | 
|  |  | 
|  | typedef Matrix<float, Dynamic, Dynamic, ColMajor> MatrixXfC; | 
|  | typedef Matrix<double, Dynamic, Dynamic, ColMajor> MatrixXdC; | 
|  | typedef Matrix<std::complex<float>, Dynamic, Dynamic, ColMajor> MatrixXcfC; | 
|  | typedef Matrix<std::complex<double>, Dynamic, Dynamic, ColMajor> MatrixXcdC; | 
|  | typedef Matrix<float, Dynamic, Dynamic, RowMajor> MatrixXfR; | 
|  | typedef Matrix<double, Dynamic, Dynamic, RowMajor> MatrixXdR; | 
|  | typedef Matrix<std::complex<float>, Dynamic, Dynamic, RowMajor> MatrixXcfR; | 
|  | typedef Matrix<std::complex<double>, Dynamic, Dynamic, RowMajor> MatrixXcdR; | 
|  |  | 
|  | COLPIVQR_LAPACKE(MatrixXfC) | 
|  | COLPIVQR_LAPACKE(MatrixXdC) | 
|  | COLPIVQR_LAPACKE(MatrixXcfC) | 
|  | COLPIVQR_LAPACKE(MatrixXcdC) | 
|  | COLPIVQR_LAPACKE(MatrixXfR) | 
|  | COLPIVQR_LAPACKE(MatrixXdR) | 
|  | COLPIVQR_LAPACKE(MatrixXcfR) | 
|  | COLPIVQR_LAPACKE(MatrixXcdR) | 
|  |  | 
|  | #endif | 
|  | }  // end namespace Eigen | 
|  |  | 
|  | #endif  // EIGEN_COLPIVOTINGHOUSEHOLDERQR_LAPACKE_H |