NAME

ellmm, sellmm, dellmm, cellmm, zellmm - Ellpack format matrix-matrix multiply


SYNOPSIS

  SUBROUTINE SELLMM( TRANSA, M, N, K, ALPHA, DESCRA,
 *           VAL, INDX, LDA, MAXNZ,
 *           B, LDB, BETA, C, LDC, WORK, LWORK )
  INTEGER*4  TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
 *           LDB, LDC, LWORK
  INTEGER*4  INDX(LDA,MAXNZ)
  REAL*4     ALPHA, BETA
  REAL*4     VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)
  SUBROUTINE DELLMM( TRANSA, M, N, K, ALPHA, DESCRA,
 *           VAL, INDX, LDA, MAXNZ,
 *           B, LDB, BETA, C, LDC, WORK, LWORK)
  INTEGER*4  TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
 *           LDB, LDC, LWORK
  INTEGER*4  INDX(LDA,MAXNZ)
  REAL*8     ALPHA, BETA
  REAL*8     VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)
  SUBROUTINE CELLMM( TRANSA, M, N, K, ALPHA, DESCRA,
 *           VAL, INDX, LDA, MAXNZ,
 *           B, LDB, BETA, C, LDC, WORK, LWORK )
  INTEGER*4  TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
 *           LDB, LDC, LWORK
  INTEGER*4  INDX(LDA,MAXNZ)
  COMPLEX*8  ALPHA, BETA
  COMPLEX*8  VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)
  SUBROUTINE ZELLMM( TRANSA, M, N, K, ALPHA, DESCRA,
 *           VAL, INDX, LDA, MAXNZ,
 *           B, LDB, BETA, C, LDC, WORK, LWORK)
  INTEGER*4  TRANSA, M, N, K, DESCRA(5), LDA, MAXNZ,
 *           LDB, LDC, LWORK
  INTEGER*4  INDX(LDA,MAXNZ)
  COMPLEX*16 ALPHA, BETA
  COMPLEX*16 VAL(LDA,MAXNZ), B(LDB,*), C(LDC,*), WORK(LWORK)


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 BLDA-by-MAXBNZ 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/