Contents


NAME

     zellmm - Ellpack format matrix-matrix multiply

SYNOPSIS

       SUBROUTINE ZELLMM( TRANSA, M, N, K, ALPHA, DESCRA,
      *           VAL, INDX, LDA, MAXNZ,
      *           B, LDB, BETA, C, LDC, WORK, LWORK)
       INTEGER    TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
      *           LDB, LDC, LWORK
       INTEGER    INDX(LDA,MAXNZ)
       DOUBLE COMPLEX ALPHA, BETA
       DOUBLE COMPLEX VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)

       SUBROUTINE ZELLMM_64( TRANSA, M, N, K, ALPHA, DESCRA,
      *           VAL, INDX, LDA, MAXNZ,
      *           B, LDB, BETA, C, LDC, WORK, LWORK)
       INTEGER*8  TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
      *           LDB, LDC, LWORK
       INTEGER*8  INDX(LDA,MAXNZ)
       DOUBLE COMPLEX ALPHA, BETA
       DOUBLE COMPLEX VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)

     F95 INTERFACE

       SUBROUTINE ELLMM( TRANSA, M, [N], K, ALPHA, DESCRA, VAL, INDX,
      *        [LDA], MAXNZ, B, [LDB], BETA, C, [LDC], [WORK], [LWORK])
       INTEGER    TRANSA, M, K, MAXNZ
       INTEGER, DIMENSION(:) ::  DESCRA
       INTEGER, DIMENSION(:, :) ::    INDX
       DOUBLE COMPLEX    ALPHA, BETA
       DOUBLE COMPLEX, DIMENSION(:, :) ::  VAL, B, C

       SUBROUTINE ELLMM_64( TRANSA, M, [N], K, ALPHA, DESCRA, VAL, INDX,
      *        [LDA], MAXNZ, B, [LDB], BETA, C, [LDC], [WORK], [LWORK])
       INTEGER*8    TRANSA, M, K, MAXNZ
       INTEGER*8, DIMENSION(:) ::  DESCRA
       INTEGER*8, DIMENSION(:, :) ::    INDX
       DOUBLE COMPLEX    ALPHA, BETA
       DOUBLE COMPLEX, DIMENSION(:, :) ::  VAL, B, C

DESCRIPTION

      where ALPHA and BETA are scalar, C and B are dense matrices,
      A is a matrix represented in  Ellpack format format and
      op( A )  is one  of

      op( A ) = A   or   op( A ) = A'   or   op( A ) = conjg( A' ).
                                         ( ' indicates matrix transpose)

ARGUMENTS

      TRANSA        Indicates how to operate with the sparse matrix
                      0 : operate with matrix
                      1 : operate with transpose matrix
                      2 : operate with the conjugate transpose of matrix.
                          2 is equivalent to 1 if matrix is real.

      M             Number of rows in matrix A

      N             Number of columns in matrix C

      K             Number of columns in matrix A

      ALPHA         Scalar parameter

      DESCRA()      Descriptor argument.  Five element integer array
                    DESCRA(1) matrix structure
                      0 : general
                      1 : symmetric (A=A')
                      2 : Hermitian (A= CONJG(A'))
                      3 : Triangular
                      4 : Skew(Anti)-Symmetric (A=-A')
                      5 : Diagonal
                      6 : Skew-Hermitian (A= -CONJG(A'))
                    DESCRA(2) upper/lower triangular indicator
                      1 : lower
                      2 : upper
                    DESCRA(3) main diagonal type
                      0 : non-unit
                      1 : unit
                    DESCRA(4) Array base  (NOT IMPLEMENTED)
                      0 : C/C++ compatible
                      1 : Fortran compatible
                    DESCRA(5) repeated indices? (NOT IMPLEMENTED)
                      0 : unknown
                      1 : no repeated indices

      VAL()         two-dimensional LDA-by-MAXNZ array such that VAL(I,:)
                    consists of non-zero elements in row I of A, padded by
                    zero values if the row contains less than MAXNZ.

      INDX()        two-dimensional integer LDA-by-MAXNZ array such
                    INDX(I,:) consists of the column indices of the
                    nonzero elements in row I, padded by the integer
                    value I if the number of nonzeros is less than MAXNZ.

      LDA           leading dimension of VAL and INDX.

      MAXNZ         max number of nonzeros elements per row.

      B()           rectangular array with first dimension LDB.
      LDB           leading dimension of B

      BETA          Scalar parameter

      C()           rectangular array with first dimension LDC.

      LDC           leading dimension of C

      WORK()        scratch array of length LWORK. WORK is not
                    referenced in the current version.

      LWORK         length of WORK array. LWORK is not referenced
                    in the current version.

SEE ALSO

     NIST FORTRAN Sparse Blas User's Guide available at:

     http://math.nist.gov/mcsd/Staff/KRemington/fspblas/

     "Document for the Basic Linear Algebra Subprograms (BLAS)
     Standard", University of Tennessee, Knoxville, Tennessee,
     1996:

     http://www.netlib.org/utk/papers/sparse.ps