[BACK]Return to dtpsv.f CVS log [TXT] [DIR] Up to [local] / rpl / lapack / blas

Diff for /rpl/lapack/blas/dtpsv.f between versions 1.7 and 1.8

version 1.7, 2011/07/22 07:38:02 version 1.8, 2011/11/21 20:37:08
Line 1 Line 1
       SUBROUTINE DTPSV(UPLO,TRANS,DIAG,N,AP,X,INCX)  *> \brief \b DTPSV
 *     .. Scalar Arguments ..  
       INTEGER INCX,N  
       CHARACTER DIAG,TRANS,UPLO  
 *     ..  
 *     .. Array Arguments ..  
       DOUBLE PRECISION AP(*),X(*)  
 *     ..  
 *  
 *  Purpose  
 *  =======  
 *  *
 *  DTPSV  solves one of the systems of equations  *  =========== DOCUMENTATION ===========
 *  *
 *     A*x = b,   or   A**T*x = b,  * Online html documentation available at 
   *            http://www.netlib.org/lapack/explore-html/ 
 *  *
 *  where b and x are n element vectors and A is an n by n unit, or  *  Definition:
 *  non-unit, upper or lower triangular matrix, supplied in packed form.  *  ===========
   *
   *       SUBROUTINE DTPSV(UPLO,TRANS,DIAG,N,AP,X,INCX)
   * 
   *       .. Scalar Arguments ..
   *       INTEGER INCX,N
   *       CHARACTER DIAG,TRANS,UPLO
   *       ..
   *       .. Array Arguments ..
   *       DOUBLE PRECISION AP(*),X(*)
   *       ..
   *  
   *
   *> \par Purpose:
   *  =============
   *>
   *> \verbatim
   *>
   *> DTPSV  solves one of the systems of equations
   *>
   *>    A*x = b,   or   A**T*x = b,
   *>
   *> where b and x are n element vectors and A is an n by n unit, or
   *> non-unit, upper or lower triangular matrix, supplied in packed form.
   *>
   *> No test for singularity or near-singularity is included in this
   *> routine. Such tests must be performed before calling this routine.
   *> \endverbatim
 *  *
 *  No test for singularity or near-singularity is included in this  *  Arguments:
 *  routine. Such tests must be performed before calling this routine.  
 *  
 *  Arguments  
 *  ==========  *  ==========
 *  *
 *  UPLO   - CHARACTER*1.  *> \param[in] UPLO
 *           On entry, UPLO specifies whether the matrix is an upper or  *> \verbatim
 *           lower triangular matrix as follows:  *>          UPLO is CHARACTER*1
 *  *>           On entry, UPLO specifies whether the matrix is an upper or
 *              UPLO = 'U' or 'u'   A is an upper triangular matrix.  *>           lower triangular matrix as follows:
 *  *>
 *              UPLO = 'L' or 'l'   A is a lower triangular matrix.  *>              UPLO = 'U' or 'u'   A is an upper triangular matrix.
 *  *>
 *           Unchanged on exit.  *>              UPLO = 'L' or 'l'   A is a lower triangular matrix.
 *  *> \endverbatim
 *  TRANS  - CHARACTER*1.  *>
 *           On entry, TRANS specifies the equations to be solved as  *> \param[in] TRANS
 *           follows:  *> \verbatim
 *  *>          TRANS is CHARACTER*1
 *              TRANS = 'N' or 'n'   A*x = b.  *>           On entry, TRANS specifies the equations to be solved as
 *  *>           follows:
 *              TRANS = 'T' or 't'   A**T*x = b.  *>
 *  *>              TRANS = 'N' or 'n'   A*x = b.
 *              TRANS = 'C' or 'c'   A**T*x = b.  *>
 *  *>              TRANS = 'T' or 't'   A**T*x = b.
 *           Unchanged on exit.  *>
 *  *>              TRANS = 'C' or 'c'   A**T*x = b.
 *  DIAG   - CHARACTER*1.  *> \endverbatim
 *           On entry, DIAG specifies whether or not A is unit  *>
 *           triangular as follows:  *> \param[in] DIAG
 *  *> \verbatim
 *              DIAG = 'U' or 'u'   A is assumed to be unit triangular.  *>          DIAG is CHARACTER*1
 *  *>           On entry, DIAG specifies whether or not A is unit
 *              DIAG = 'N' or 'n'   A is not assumed to be unit  *>           triangular as follows:
 *                                  triangular.  *>
 *  *>              DIAG = 'U' or 'u'   A is assumed to be unit triangular.
 *           Unchanged on exit.  *>
 *  *>              DIAG = 'N' or 'n'   A is not assumed to be unit
 *  N      - INTEGER.  *>                                  triangular.
 *           On entry, N specifies the order of the matrix A.  *> \endverbatim
 *           N must be at least zero.  *>
 *           Unchanged on exit.  *> \param[in] N
 *  *> \verbatim
 *  AP     - DOUBLE PRECISION array of DIMENSION at least  *>          N is INTEGER
 *           ( ( n*( n + 1 ) )/2 ).  *>           On entry, N specifies the order of the matrix A.
 *           Before entry with  UPLO = 'U' or 'u', the array AP must  *>           N must be at least zero.
 *           contain the upper triangular matrix packed sequentially,  *> \endverbatim
 *           column by column, so that AP( 1 ) contains a( 1, 1 ),  *>
 *           AP( 2 ) and AP( 3 ) contain a( 1, 2 ) and a( 2, 2 )  *> \param[in] AP
 *           respectively, and so on.  *> \verbatim
 *           Before entry with UPLO = 'L' or 'l', the array AP must  *>          AP is DOUBLE PRECISION array of DIMENSION at least
 *           contain the lower triangular matrix packed sequentially,  *>           ( ( n*( n + 1 ) )/2 ).
 *           column by column, so that AP( 1 ) contains a( 1, 1 ),  *>           Before entry with  UPLO = 'U' or 'u', the array AP must
 *           AP( 2 ) and AP( 3 ) contain a( 2, 1 ) and a( 3, 1 )  *>           contain the upper triangular matrix packed sequentially,
 *           respectively, and so on.  *>           column by column, so that AP( 1 ) contains a( 1, 1 ),
 *           Note that when  DIAG = 'U' or 'u', the diagonal elements of  *>           AP( 2 ) and AP( 3 ) contain a( 1, 2 ) and a( 2, 2 )
 *           A are not referenced, but are assumed to be unity.  *>           respectively, and so on.
 *           Unchanged on exit.  *>           Before entry with UPLO = 'L' or 'l', the array AP must
 *  *>           contain the lower triangular matrix packed sequentially,
 *  X      - DOUBLE PRECISION array of dimension at least  *>           column by column, so that AP( 1 ) contains a( 1, 1 ),
 *           ( 1 + ( n - 1 )*abs( INCX ) ).  *>           AP( 2 ) and AP( 3 ) contain a( 2, 1 ) and a( 3, 1 )
 *           Before entry, the incremented array X must contain the n  *>           respectively, and so on.
 *           element right-hand side vector b. On exit, X is overwritten  *>           Note that when  DIAG = 'U' or 'u', the diagonal elements of
 *           with the solution vector x.  *>           A are not referenced, but are assumed to be unity.
 *  *> \endverbatim
 *  INCX   - INTEGER.  *>
 *           On entry, INCX specifies the increment for the elements of  *> \param[in,out] X
 *           X. INCX must not be zero.  *> \verbatim
 *           Unchanged on exit.  *>          X is DOUBLE PRECISION array of dimension at least
 *  *>           ( 1 + ( n - 1 )*abs( INCX ) ).
 *  Further Details  *>           Before entry, the incremented array X must contain the n
 *  ===============  *>           element right-hand side vector b. On exit, X is overwritten
   *>           with the solution vector x.
   *> \endverbatim
   *>
   *> \param[in] INCX
   *> \verbatim
   *>          INCX is INTEGER
   *>           On entry, INCX specifies the increment for the elements of
   *>           X. INCX must not be zero.
   *> \endverbatim
   *
   *  Authors:
   *  ========
   *
   *> \author Univ. of Tennessee 
   *> \author Univ. of California Berkeley 
   *> \author Univ. of Colorado Denver 
   *> \author NAG Ltd. 
   *
   *> \date November 2011
   *
   *> \ingroup double_blas_level2
   *
   *> \par Further Details:
   *  =====================
   *>
   *> \verbatim
   *>
   *>  Level 2 Blas routine.
   *>
   *>  -- Written on 22-October-1986.
   *>     Jack Dongarra, Argonne National Lab.
   *>     Jeremy Du Croz, Nag Central Office.
   *>     Sven Hammarling, Nag Central Office.
   *>     Richard Hanson, Sandia National Labs.
   *> \endverbatim
   *>
   *  =====================================================================
         SUBROUTINE DTPSV(UPLO,TRANS,DIAG,N,AP,X,INCX)
 *  *
 *  Level 2 Blas routine.  *  -- Reference BLAS level2 routine (version 3.4.0) --
   *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
   *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
   *     November 2011
 *  *
 *  -- Written on 22-October-1986.  *     .. Scalar Arguments ..
 *     Jack Dongarra, Argonne National Lab.        INTEGER INCX,N
 *     Jeremy Du Croz, Nag Central Office.        CHARACTER DIAG,TRANS,UPLO
 *     Sven Hammarling, Nag Central Office.  *     ..
 *     Richard Hanson, Sandia National Labs.  *     .. Array Arguments ..
         DOUBLE PRECISION AP(*),X(*)
   *     ..
 *  *
 *  =====================================================================  *  =====================================================================
 *  *
Removed from v.1.7  
changed lines
  Added in v.1.8

CVSweb interface <joel.bertrand@systella.fr>