Lapack.hpp

Go to the documentation of this file.

///////////////////////////////////////////////////////////////////////////////
//
// File Lapack.hpp
//
// For more information, please see: http://www.nektar.info
//
// The MIT License
//
// Copyright (c) 2006 Division of Applied Mathematics, Brown University (USA),
// Department of Aeronautics, Imperial College London (UK), and Scientific
// Computing and Imaging Institute, University of Utah (USA).
//
// License for the specific language governing rights and limitations under
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//
// Description: wrapper of functions around standard LAPACK routines
//
///////////////////////////////////////////////////////////////////////////////
#ifndef  NEKTAR_LIB_UTILITIES_LAPACK_HPP
#define  NEKTAR_LIB_UTILITIES_LAPACK_HPP

#include <LibUtilities/LinearAlgebra/TransF77.hpp>

namespace Lapack
{
    extern "C"
    {
        // Matrix factorisation and solves
        void F77NAME(dsptrf) (const char& uplo, const int& n,
                  double* ap, int *ipiv, int& info);
        void F77NAME(dsptrs) (const char& uplo, const int& n,
                  const int& nrhs, const double* ap,
                  const int  *ipiv, double* b,
                  const int& ldb, int& info);
        void F77NAME(dsptri) (const char& uplo, const int& n,
                  const double* ap,
                  const int  *ipiv, double* work,
                  int& info);
        void F77NAME(dtrtrs) (const char& uplo, const char& trans, const char& diag,
                              const int& n, const int& nrhs, const double* a,
                              const int& lda, double* b, const int& ldb, int& info);
        void F77NAME(dtptrs) (const char& uplo, const char& trans, const char& diag,
                              const int& n, const int& nrhs, const double* a,
                              double* b, const int& ldb, int& info);
        void F77NAME(dpptrf) (const char& uplo, const int& n,
                  double* ap, int& info);
        void F77NAME(dpptrs) (const char& uplo, const int& n,
                  const int& nrhs, const double* ap,
                  double* b, const int& ldb, int& info);
        void F77NAME(dpbtrf) (const char& uplo, const int& n, const int& kd,
                  double* ab, const int& ldab, int& info);
        void F77NAME(dpbtrs) (const char& uplo, const int& n,
                  const int& kd, const int& nrhs,
                  const double* ab, const int& ldab,
                  double* b, const int& ldb, int& info);
        void F77NAME(dgbtrf) (const int& m, const int& n, const int& kl,
                  const int& ku, double* a, const int& lda,
                  int* ipiv, int& info);
        void F77NAME(dgbtrs) (const char& trans, const int& n, const int& kl,
                  const int &ku, const int& nrhs,   const double* a,
                  const int& lda, const int* ipiv, double* b,
                  const int& ldb, int& info);
        void F77NAME(dgetrf) (const int& m, const int& n, double* a,
                  const int& lda, int* ipiv, int& info);
        void F77NAME(dgetrs) (const char& trans, const int& n, const int& nrhs,
                  const double* a,   const int& lda, int* ipiv,
                  double* b, const int& ldb, int& info);
        void F77NAME(dgetri) (const int& n, double *a, const int& lda,
                const int *ipiv, double *wk,  const int& lwk,
                  int& info);
        void F77NAME(dsterf) (const int& n, double *d, double *e, int& info);
        void F77NAME(dgeev)  (const char& uplo, const char& lrev, const int& n,
                              const double* a, const int& lda, double* wr, double* wi,
                              double* rev,  const int& ldr,
                              double* lev,  const int& ldv,
                              double* work, const int& lwork, int& info);

        void F77NAME(dspev)  (const char& jobz, const char& uplo, const int& n,
                  double* ap, double* w, double* z, const int& ldz,
                  double* work, int& info);
        void F77NAME(dsbev)  (const char& jobz, const char& uplo, const int& kl,
                  const int& ku,  double* ap, const int& lda,
                  double* w, double* z, const int& ldz,
                  double* work, int& info);
    }

    // Non-standard versions.
    void dgetrs(char trans, int matrixRows, int matrixColumns, const double* A, double* x);

#ifdef NEKTAR_USING_LAPACK

    /// \brief factor a real packed-symmetric matrix using Bunch-Kaufman
    /// pivoting.
    static inline void Dsptrf (const char& uplo, const int& n,
              double* ap, int *ipiv, int& info)
    {
        F77NAME(dsptrf) (uplo,n,ap,ipiv,info);
    }

    /// \brief Solve a real symmetric matrix problem using Bunch-Kaufman
    /// pivoting.
    static inline void Dsptrs (const char& uplo, const int& n, const int& nrhs,
              const double* ap, const int  *ipiv, double* b,
              const int& ldb, int& info)
    {
        F77NAME(dsptrs) (uplo,n,nrhs,ap,ipiv,b,ldb,info);
    }

    /// \brief Invert a real symmetric matrix problem
    static inline void Dsptri (const char& uplo, const int& n,
              const double* ap, const int  *ipiv, double* work,
              int& info)
    {
        F77NAME(dsptri) (uplo,n,ap,ipiv,work,info);
    }

    /// \brief Cholesky factor a real Positive Definite packed-symmetric matrix.
    static inline void Dpptrf (const char& uplo, const int& n,
              double *ap, int& info)
    {
        F77NAME(dpptrf) (uplo,n,ap,info);
    }

    /// \brief Solve a real Positive defiinte symmetric matrix problem
    /// using Cholesky factorization.
    static inline void Dpptrs (const char& uplo, const int& n, const int& nrhs,
              const double *ap, double *b, const int& ldb,
              int& info)
    {
        F77NAME(dpptrs) (uplo,n,nrhs,ap,b,ldb,info);
    }

    /// \brief Cholesky factorize a real positive-definite
    /// banded-symmetric matrix
    static inline void Dpbtrf (const char& uplo, const int& n, const int& kd,
             double *ab, const int& ldab, int& info)
    {
        F77NAME(dpbtrf) (uplo,n,kd,ab,ldab,info);
    }


    /// \brief Solve a real, Positive definite banded symmetric matrix
    /// problem using Cholesky factorization.
    static inline void Dpbtrs (const char& uplo, const int& n,
              const int& kd, const int& nrhs,
              const double *ab, const int& ldab,
              double *b, const int& ldb, int& info)
    {
        F77NAME(dpbtrs) (uplo,n,kd,nrhs,ab,ldab,b,ldb,info);
    }

    /// \brief General banded matrix LU factorisation
    static inline void Dgbtrf (const int& m, const int& n, const int& kl,
              const int& ku, double* a, const int& lda,
              int* ipiv, int& info)
    {
        F77NAME(dgbtrf)(m,n,kl,ku,a,lda,ipiv,info);
    }

    /// \brief Solve general banded matrix using LU factorisation
    static inline void Dgbtrs (const char& trans, const int& n, const int& kl,
              const int &ku, const int& nrhs,   const double* a,
              const int& lda, const int* ipiv, double* b,
              const int& ldb, int& info)
    {
        F77NAME(dgbtrs)(trans,n,kl,ku,nrhs,a,lda,ipiv,b,ldb,info);
    }

    /// \brief General matrix LU factorisation
    static inline void Dgetrf (const int& m, const int& n, double *a,
              const int& lda, int *ipiv, int& info)
    {
        F77NAME(dgetrf) (m,n,a,lda,ipiv,info);
    }

    /// \brief General matrix LU backsolve
    static inline void Dgetrs (const char& trans, const int& n, const int& nrhs,
              const double* a, const int& lda, int* ipiv,
              double* b, const int& ldb, int& info)
    {
        F77NAME(dgetrs) (trans,n,nrhs,a,lda,ipiv,b,ldb,info);
    }

    /// \brief Generate matrix inverse
    static inline void Dgetri (const int& n, double *a, const int& lda,
           const int *ipiv, double *wk,  const int& lwk, int& info)
    {
        F77NAME(dgetri) (n, a, lda, ipiv, wk, lwk,info);
    }

    /// \brief Find eigenvalues of symmetric tridiagonal matrix
    static inline void Dsterf(const int& n, double *d, double *e, int& info)
    {
        F77NAME(dsterf)(n,d,e,info);
    }

    /// \brief Solve general real matrix eigenproblem.
    static inline void Dgeev (const char& uplo, const char& lrev, const int& n,
                              const double* a, const int& lda, double* wr, double* wi,
             double* rev,  const int& ldr,
             double* lev,  const int& ldv,
             double* work, const int& lwork, int& info)
    {
        F77NAME(dgeev) (uplo, lrev, n, a, lda, wr, wi, rev,
            ldr, lev, ldv, work, lwork, info);
    }

    /// \brief Solve packed-symmetric real matrix eigenproblem.
    static inline void Dspev (const char& jobz, const char& uplo, const int& n,
             double* ap, double* w, double* z, const int& ldz,
             double* work, int& info)
    {
        F77NAME(dspev) (jobz, uplo, n, ap, w, z, ldz, work, info);
    }

    /// \brief Solve packed-banded real matrix eigenproblem.
    static inline void Dsbev (const char& jobz, const char& uplo, const int& kl,
             const int& ku,  double* ap, const int& lda,
             double* w, double* z, const int& ldz,
             double* work, int& info)
    {
        F77NAME(dsbev) (jobz, uplo, kl, ku, ap, lda, w, z, ldz, work, info);
    }

    static inline void Dtrtrs(const char& uplo, const char& trans, const char& diag,
                              const int& n, const int& nrhs, const double* a,
                              const int& lda, double* b, const int& ldb, int& info)
    {
        F77NAME(dtrtrs) (uplo, trans, diag, n, nrhs, a, lda, b, ldb, info);
    }

    static inline void Dtptrs(const char& uplo, const char& trans, const char& diag,
                              const int& n, const int& nrhs, const double* a,
                              double* b, const int& ldb, int& info)
    {
        F77NAME(dtptrs) (uplo, trans, diag, n, nrhs, a, b, ldb, info);
    }

    
#endif //NEKTAR_USING_LAPACK
}
#endif //NEKTAR_LIB_UTILITIES_LAPACK_HPP

/***
$Log: Lapack.hpp,v $
Revision 1.5  2008/06/01 19:04:57  bnelson
Added triangular solvers.

Revision 1.4  2008/04/30 02:57:15  bnelson
Fixed gcc compiler warning.

Revision 1.3  2008/04/06 05:55:11  bnelson
Changed ConstArray to Array<const>

Revision 1.2  2007/04/10 14:00:45  sherwin
Update to include SharedArray in all 2D element (including Nodal tris). Have also remvoed all new and double from 2D shapes in StdRegions

Revision 1.1  2007/04/03 03:59:24  bnelson
Moved Lapack.hpp, Blas.hpp, Transf77.hpp to LinearAlgebra

Revision 1.3  2007/02/04 00:15:40  bnelson
*** empty log message ***

Revision 1.2  2006/06/01 13:44:28  kirby
*** empty log message ***

Revision 1.1  2006/06/01 11:07:52  kirby
*** empty log message ***

Revision 1.1  2006/05/04 18:57:43  kirby
*** empty log message ***

Revision 1.4  2006/02/26 21:13:45  bnelson
Fixed a variety of compiler errors caused by updates to the coding standard.

Revision 1.3  2006/02/15 08:07:15  sherwin

Put codes into standard although have not yet been compiled

Revision 1.2  2006/02/12 21:51:42  sherwin

Added licence

Revision 1.1  2006/02/12 15:06:12  sherwin

Changed .h files to .hpp

**/