Diff for /rpl/lapack/blas/zher.f between versions 1.3 and 1.16

version 1.3, 2010/08/06 15:32:21 version 1.16, 2023/08/07 08:38:45
Line 1 Line 1
   *> \brief \b ZHER
   *
   *  =========== DOCUMENTATION ===========
   *
   * Online html documentation available at
   *            http://www.netlib.org/lapack/explore-html/
   *
   *  Definition:
   *  ===========
   *
   *       SUBROUTINE ZHER(UPLO,N,ALPHA,X,INCX,A,LDA)
   *
   *       .. Scalar Arguments ..
   *       DOUBLE PRECISION ALPHA
   *       INTEGER INCX,LDA,N
   *       CHARACTER UPLO
   *       ..
   *       .. Array Arguments ..
   *       COMPLEX*16 A(LDA,*),X(*)
   *       ..
   *
   *
   *> \par Purpose:
   *  =============
   *>
   *> \verbatim
   *>
   *> ZHER   performs the hermitian rank 1 operation
   *>
   *>    A := alpha*x*x**H + A,
   *>
   *> where alpha is a real scalar, x is an n element vector and A is an
   *> n by n hermitian matrix.
   *> \endverbatim
   *
   *  Arguments:
   *  ==========
   *
   *> \param[in] UPLO
   *> \verbatim
   *>          UPLO is CHARACTER*1
   *>           On entry, UPLO specifies whether the upper or lower
   *>           triangular part of the array A is to be referenced as
   *>           follows:
   *>
   *>              UPLO = 'U' or 'u'   Only the upper triangular part of A
   *>                                  is to be referenced.
   *>
   *>              UPLO = 'L' or 'l'   Only the lower triangular part of A
   *>                                  is to be referenced.
   *> \endverbatim
   *>
   *> \param[in] N
   *> \verbatim
   *>          N is INTEGER
   *>           On entry, N specifies the order of the matrix A.
   *>           N must be at least zero.
   *> \endverbatim
   *>
   *> \param[in] ALPHA
   *> \verbatim
   *>          ALPHA is DOUBLE PRECISION.
   *>           On entry, ALPHA specifies the scalar alpha.
   *> \endverbatim
   *>
   *> \param[in] X
   *> \verbatim
   *>          X is COMPLEX*16 array, dimension at least
   *>           ( 1 + ( n - 1 )*abs( INCX ) ).
   *>           Before entry, the incremented array X must contain the n
   *>           element 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,out] A
   *> \verbatim
   *>          A is COMPLEX*16 array, dimension ( LDA, N )
   *>           Before entry with  UPLO = 'U' or 'u', the leading n by n
   *>           upper triangular part of the array A must contain the upper
   *>           triangular part of the hermitian matrix and the strictly
   *>           lower triangular part of A is not referenced. On exit, the
   *>           upper triangular part of the array A is overwritten by the
   *>           upper triangular part of the updated matrix.
   *>           Before entry with UPLO = 'L' or 'l', the leading n by n
   *>           lower triangular part of the array A must contain the lower
   *>           triangular part of the hermitian matrix and the strictly
   *>           upper triangular part of A is not referenced. On exit, the
   *>           lower triangular part of the array A is overwritten by the
   *>           lower triangular part of the updated matrix.
   *>           Note that the imaginary parts of the diagonal elements need
   *>           not be set, they are assumed to be zero, and on exit they
   *>           are set to zero.
   *> \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
   *>           max( 1, n ).
   *> \endverbatim
   *
   *  Authors:
   *  ========
   *
   *> \author Univ. of Tennessee
   *> \author Univ. of California Berkeley
   *> \author Univ. of Colorado Denver
   *> \author NAG Ltd.
   *
   *> \ingroup complex16_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 ZHER(UPLO,N,ALPHA,X,INCX,A,LDA)        SUBROUTINE ZHER(UPLO,N,ALPHA,X,INCX,A,LDA)
   *
   *  -- Reference BLAS level2 routine --
   *  -- Reference BLAS is a software package provided by Univ. of Tennessee,    --
   *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
   *
 *     .. Scalar Arguments ..  *     .. Scalar Arguments ..
       DOUBLE PRECISION ALPHA        DOUBLE PRECISION ALPHA
       INTEGER INCX,LDA,N        INTEGER INCX,LDA,N
       CHARACTER UPLO        CHARACTER UPLO
 *     ..  *     ..
 *     .. Array Arguments ..  *     .. Array Arguments ..
       DOUBLE COMPLEX A(LDA,*),X(*)        COMPLEX*16 A(LDA,*),X(*)
 *     ..  *     ..
 *  *
 *  Purpose  
 *  =======  
 *  
 *  ZHER   performs the hermitian rank 1 operation  
 *  
 *     A := alpha*x*conjg( x' ) + A,  
 *  
 *  where alpha is a real scalar, x is an n element vector and A is an  
 *  n by n hermitian matrix.  
 *  
 *  Arguments  
 *  ==========  
 *  
 *  UPLO   - CHARACTER*1.  
 *           On entry, UPLO specifies whether the upper or lower  
 *           triangular part of the array A is to be referenced as  
 *           follows:  
 *  
 *              UPLO = 'U' or 'u'   Only the upper triangular part of A  
 *                                  is to be referenced.  
 *  
 *              UPLO = 'L' or 'l'   Only the lower triangular part of A  
 *                                  is to be referenced.  
 *  
 *           Unchanged on exit.  
 *  
 *  N      - INTEGER.  
 *           On entry, N specifies the order of the matrix A.  
 *           N must be at least zero.  
 *           Unchanged on exit.  
 *  
 *  ALPHA  - DOUBLE PRECISION.  
 *           On entry, ALPHA specifies the scalar alpha.  
 *           Unchanged on exit.  
 *  
 *  X      - COMPLEX*16       array of dimension at least  
 *           ( 1 + ( n - 1 )*abs( INCX ) ).  
 *           Before entry, the incremented array X must contain the n  
 *           element 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.  
 *  
 *  A      - COMPLEX*16       array of DIMENSION ( LDA, n ).  
 *           Before entry with  UPLO = 'U' or 'u', the leading n by n  
 *           upper triangular part of the array A must contain the upper  
 *           triangular part of the hermitian matrix and the strictly  
 *           lower triangular part of A is not referenced. On exit, the  
 *           upper triangular part of the array A is overwritten by the  
 *           upper triangular part of the updated matrix.  
 *           Before entry with UPLO = 'L' or 'l', the leading n by n  
 *           lower triangular part of the array A must contain the lower  
 *           triangular part of the hermitian matrix and the strictly  
 *           upper triangular part of A is not referenced. On exit, the  
 *           lower triangular part of the array A is overwritten by the  
 *           lower triangular part of the updated matrix.  
 *           Note that the imaginary parts of the diagonal elements need  
 *           not be set, they are assumed to be zero, and on exit they  
 *           are set to zero.  
 *  
 *  LDA    - INTEGER.  
 *           On entry, LDA specifies the first dimension of A as declared  
 *           in the calling (sub) program. LDA must be at least  
 *           max( 1, n ).  
 *           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 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,J,JX,KX        INTEGER I,INFO,IX,J,JX,KX
 *     ..  *     ..
 *     .. External Functions ..  *     .. External Functions ..
Line 212 Line 270
 *  *
       RETURN        RETURN
 *  *
 *     End of ZHER  .  *     End of ZHER
 *  *
       END        END

Removed from v.1.3  
changed lines
  Added in v.1.16


CVSweb interface <joel.bertrand@systella.fr>