Diff for /rpl/lapack/blas/zgbmv.f between versions 1.5 and 1.8

version 1.5, 2010/08/13 21:03:41 version 1.8, 2011/11/21 20:37:08
Line 1 Line 1
       SUBROUTINE ZGBMV(TRANS,M,N,KL,KU,ALPHA,A,LDA,X,INCX,BETA,Y,INCY)  *> \brief \b ZGBMV
 *     .. Scalar Arguments ..  
       DOUBLE COMPLEX ALPHA,BETA  
       INTEGER INCX,INCY,KL,KU,LDA,M,N  
       CHARACTER TRANS  
 *     ..  
 *     .. Array Arguments ..  
       DOUBLE COMPLEX A(LDA,*),X(*),Y(*)  
 *     ..  
 *  *
 *  Purpose  *  =========== DOCUMENTATION ===========
 *  =======  
 *  *
 *  ZGBMV  performs one of the matrix-vector operations  * Online html documentation available at 
   *            http://www.netlib.org/lapack/explore-html/ 
 *  *
 *     y := alpha*A*x + beta*y,   or   y := alpha*A'*x + beta*y,   or  *  Definition:
   *  ===========
   *
   *       SUBROUTINE ZGBMV(TRANS,M,N,KL,KU,ALPHA,A,LDA,X,INCX,BETA,Y,INCY)
   * 
   *       .. Scalar Arguments ..
   *       COMPLEX*16 ALPHA,BETA
   *       INTEGER INCX,INCY,KL,KU,LDA,M,N
   *       CHARACTER TRANS
   *       ..
   *       .. Array Arguments ..
   *       COMPLEX*16 A(LDA,*),X(*),Y(*)
   *       ..
   *  
   *
   *> \par Purpose:
   *  =============
   *>
   *> \verbatim
   *>
   *> ZGBMV  performs one of the matrix-vector operations
   *>
   *>    y := alpha*A*x + beta*y,   or   y := alpha*A**T*x + beta*y,   or
   *>
   *>    y := alpha*A**H*x + beta*y,
   *>
   *> where alpha and beta are scalars, x and y are vectors and A is an
   *> m by n band matrix, with kl sub-diagonals and ku super-diagonals.
   *> \endverbatim
 *  *
 *     y := alpha*conjg( A' )*x + beta*y,  *  Arguments:
   *  ==========
 *  *
 *  where alpha and beta are scalars, x and y are vectors and A is an  *> \param[in] TRANS
 *  m by n band matrix, with kl sub-diagonals and ku super-diagonals.  *> \verbatim
   *>          TRANS is CHARACTER*1
   *>           On entry, TRANS specifies the operation to be performed as
   *>           follows:
   *>
   *>              TRANS = 'N' or 'n'   y := alpha*A*x + beta*y.
   *>
   *>              TRANS = 'T' or 't'   y := alpha*A**T*x + beta*y.
   *>
   *>              TRANS = 'C' or 'c'   y := alpha*A**H*x + beta*y.
   *> \endverbatim
   *>
   *> \param[in] M
   *> \verbatim
   *>          M is INTEGER
   *>           On entry, M specifies the number of rows of the matrix A.
   *>           M must be at least zero.
   *> \endverbatim
   *>
   *> \param[in] N
   *> \verbatim
   *>          N is INTEGER
   *>           On entry, N specifies the number of columns of the matrix A.
   *>           N must be at least zero.
   *> \endverbatim
   *>
   *> \param[in] KL
   *> \verbatim
   *>          KL is INTEGER
   *>           On entry, KL specifies the number of sub-diagonals of the
   *>           matrix A. KL must satisfy  0 .le. KL.
   *> \endverbatim
   *>
   *> \param[in] KU
   *> \verbatim
   *>          KU is INTEGER
   *>           On entry, KU specifies the number of super-diagonals of the
   *>           matrix A. KU must satisfy  0 .le. KU.
   *> \endverbatim
   *>
   *> \param[in] ALPHA
   *> \verbatim
   *>          ALPHA is COMPLEX*16
   *>           On entry, ALPHA specifies the scalar alpha.
   *> \endverbatim
   *>
   *> \param[in] A
   *> \verbatim
   *>          A is COMPLEX*16 array of DIMENSION ( LDA, n ).
   *>           Before entry, the leading ( kl + ku + 1 ) by n part of the
   *>           array A must contain the matrix of coefficients, supplied
   *>           column by column, with the leading diagonal of the matrix in
   *>           row ( ku + 1 ) of the array, the first super-diagonal
   *>           starting at position 2 in row ku, the first sub-diagonal
   *>           starting at position 1 in row ( ku + 2 ), and so on.
   *>           Elements in the array A that do not correspond to elements
   *>           in the band matrix (such as the top left ku by ku triangle)
   *>           are not referenced.
   *>           The following program segment will transfer a band matrix
   *>           from conventional full matrix storage to band storage:
   *>
   *>                 DO 20, J = 1, N
   *>                    K = KU + 1 - J
   *>                    DO 10, I = MAX( 1, J - KU ), MIN( M, J + KL )
   *>                       A( K + I, J ) = matrix( I, J )
   *>              10    CONTINUE
   *>              20 CONTINUE
   *> \endverbatim
   *>
   *> \param[in] LDA
   *> \verbatim
   *>          LDA is INTEGER
   *>           On entry, LDA specifies the first dimension of A as declared
   *>           in the calling (sub) program. LDA must be at least
   *>           ( kl + ku + 1 ).
   *> \endverbatim
   *>
   *> \param[in] X
   *> \verbatim
   *>          X is COMPLEX*16 array of DIMENSION at least
   *>           ( 1 + ( n - 1 )*abs( INCX ) ) when TRANS = 'N' or 'n'
   *>           and at least
   *>           ( 1 + ( m - 1 )*abs( INCX ) ) otherwise.
   *>           Before entry, the incremented array X must contain the
   *>           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
   *>
   *> \param[in] BETA
   *> \verbatim
   *>          BETA is COMPLEX*16
   *>           On entry, BETA specifies the scalar beta. When BETA is
   *>           supplied as zero then Y need not be set on input.
   *> \endverbatim
   *>
   *> \param[in,out] Y
   *> \verbatim
   *>          Y is COMPLEX*16 array of DIMENSION at least
   *>           ( 1 + ( m - 1 )*abs( INCY ) ) when TRANS = 'N' or 'n'
   *>           and at least
   *>           ( 1 + ( n - 1 )*abs( INCY ) ) otherwise.
   *>           Before entry, the incremented array Y must contain the
   *>           vector y. On exit, Y is overwritten by the updated vector y.
   *> \endverbatim
   *>
   *> \param[in] INCY
   *> \verbatim
   *>          INCY is INTEGER
   *>           On entry, INCY specifies the increment for the elements of
   *>           Y. INCY 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 complex16_blas_level2
   *
   *> \par Further Details:
   *  =====================
   *>
   *> \verbatim
   *>
   *>  Level 2 Blas routine.
   *>  The vector and matrix arguments are not referenced when N = 0, or M = 0
   *>
   *>  -- 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 ZGBMV(TRANS,M,N,KL,KU,ALPHA,A,LDA,X,INCX,BETA,Y,INCY)
 *  *
 *  Arguments  *  -- 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
 *  *
 *  TRANS  - CHARACTER*1.  *     .. Scalar Arguments ..
 *           On entry, TRANS specifies the operation to be performed as        COMPLEX*16 ALPHA,BETA
 *           follows:        INTEGER INCX,INCY,KL,KU,LDA,M,N
 *        CHARACTER TRANS
 *              TRANS = 'N' or 'n'   y := alpha*A*x + beta*y.  *     ..
 *  *     .. Array Arguments ..
 *              TRANS = 'T' or 't'   y := alpha*A'*x + beta*y.        COMPLEX*16 A(LDA,*),X(*),Y(*)
 *  *     ..
 *              TRANS = 'C' or 'c'   y := alpha*conjg( A' )*x + beta*y.  
 *  
 *           Unchanged on exit.  
 *  
 *  M      - INTEGER.  
 *           On entry, M specifies the number of rows of the matrix A.  
 *           M must be at least zero.  
 *           Unchanged on exit.  
 *  
 *  N      - INTEGER.  
 *           On entry, N specifies the number of columns of the matrix A.  
 *           N must be at least zero.  
 *           Unchanged on exit.  
 *  
 *  KL     - INTEGER.  
 *           On entry, KL specifies the number of sub-diagonals of the  
 *           matrix A. KL must satisfy  0 .le. KL.  
 *           Unchanged on exit.  
 *  
 *  KU     - INTEGER.  
 *           On entry, KU specifies the number of super-diagonals of the  
 *           matrix A. KU must satisfy  0 .le. KU.  
 *           Unchanged on exit.  
 *  
 *  ALPHA  - COMPLEX*16      .  
 *           On entry, ALPHA specifies the scalar alpha.  
 *           Unchanged on exit.  
 *  
 *  A      - COMPLEX*16       array of DIMENSION ( LDA, n ).  
 *           Before entry, the leading ( kl + ku + 1 ) by n part of the  
 *           array A must contain the matrix of coefficients, supplied  
 *           column by column, with the leading diagonal of the matrix in  
 *           row ( ku + 1 ) of the array, the first super-diagonal  
 *           starting at position 2 in row ku, the first sub-diagonal  
 *           starting at position 1 in row ( ku + 2 ), and so on.  
 *           Elements in the array A that do not correspond to elements  
 *           in the band matrix (such as the top left ku by ku triangle)  
 *           are not referenced.  
 *           The following program segment will transfer a band matrix  
 *           from conventional full matrix storage to band storage:  
 *  
 *                 DO 20, J = 1, N  
 *                    K = KU + 1 - J  
 *                    DO 10, I = MAX( 1, J - KU ), MIN( M, J + KL )  
 *                       A( K + I, J ) = matrix( I, J )  
 *              10    CONTINUE  
 *              20 CONTINUE  
 *  
 *           Unchanged on exit.  
 *  
 *  LDA    - INTEGER.  
 *           On entry, LDA specifies the first dimension of A as declared  
 *           in the calling (sub) program. LDA must be at least  
 *           ( kl + ku + 1 ).  
 *           Unchanged on exit.  
 *  
 *  X      - COMPLEX*16       array of DIMENSION at least  
 *           ( 1 + ( n - 1 )*abs( INCX ) ) when TRANS = 'N' or 'n'  
 *           and at least  
 *           ( 1 + ( m - 1 )*abs( INCX ) ) otherwise.  
 *           Before entry, the incremented array X must contain the  
 *           vector x.  
 *           Unchanged on exit.  
 *  
 *  INCX   - INTEGER.  
 *           On entry, INCX specifies the increment for the elements of  
 *           X. INCX must not be zero.  
 *           Unchanged on exit.  
 *  
 *  BETA   - COMPLEX*16      .  
 *           On entry, BETA specifies the scalar beta. When BETA is  
 *           supplied as zero then Y need not be set on input.  
 *           Unchanged on exit.  
 *  
 *  Y      - COMPLEX*16       array of DIMENSION at least  
 *           ( 1 + ( m - 1 )*abs( INCY ) ) when TRANS = 'N' or 'n'  
 *           and at least  
 *           ( 1 + ( n - 1 )*abs( INCY ) ) otherwise.  
 *           Before entry, the incremented array Y must contain the  
 *           vector y. On exit, Y is overwritten by the updated vector y.  
 *  
 *  
 *  INCY   - INTEGER.  
 *           On entry, INCY specifies the increment for the elements of  
 *           Y. INCY must not be zero.  
 *           Unchanged on exit.  
 *  
 *  Further Details  
 *  ===============  
 *  
 *  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.  
 *  *
 *  =====================================================================  *  =====================================================================
 *  *
 *     .. Parameters ..  *     .. Parameters ..
       DOUBLE COMPLEX ONE        COMPLEX*16 ONE
       PARAMETER (ONE= (1.0D+0,0.0D+0))        PARAMETER (ONE= (1.0D+0,0.0D+0))
       DOUBLE COMPLEX ZERO        COMPLEX*16 ZERO
       PARAMETER (ZERO= (0.0D+0,0.0D+0))        PARAMETER (ZERO= (0.0D+0,0.0D+0))
 *     ..  *     ..
 *     .. Local Scalars ..  *     .. Local Scalars ..
       DOUBLE COMPLEX TEMP        COMPLEX*16 TEMP
       INTEGER I,INFO,IX,IY,J,JX,JY,K,KUP1,KX,KY,LENX,LENY        INTEGER I,INFO,IX,IY,J,JX,JY,K,KUP1,KX,KY,LENX,LENY
       LOGICAL NOCONJ        LOGICAL NOCONJ
 *     ..  *     ..
Line 273 Line 345
           END IF            END IF
       ELSE        ELSE
 *  *
 *        Form  y := alpha*A'*x + y  or  y := alpha*conjg( A' )*x + y.  *        Form  y := alpha*A**T*x + y  or  y := alpha*A**H*x + y.
 *  *
           JY = KY            JY = KY
           IF (INCX.EQ.1) THEN            IF (INCX.EQ.1) THEN

Removed from v.1.5  
changed lines
  Added in v.1.8


CVSweb interface <joel.bertrand@systella.fr>