zCreate_CompRow_Matrix (3p)

Name

zCreate_CompRow_Matrix - Create_CompRow_Matrix: cCreate_CompRow_Matrix, dCreate_CompRow_Matrix, A utility C function in the serial SuperLU solver that creates a SuperMatrix in compressed sparse row format.

Synopsis

#include <sunperf.h>


void sCreate_CompRow_Matrix(SuperMatrix *A, int  m,  int  n,  int  nnz,
float  *nzval,  int  *colind,  int  *rowptr,  Stype_t  stype,
Dtype_t dtype, Mtype_t mtype);


void dCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, dou-
ble  *nzval, int *colind, int *rowptr, Stype_t stype, Dtype_t
dtype, Mtype_t mtype);


void cCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, com-
plex *nzval, int *colind, int *rowptr, Stype_t stype, Dtype_t
dtype, Mtype_t mtype);


void zCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, dou-
blecomplex  *nzval,  int *colind, int *rowptr, Stype_t stype,
Dtype_t dtype, Mtype_t mtype);


void sCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
nnz, float *nzval, long *colind, long *rowptr, Stype_t stype,
Dtype_t dtype, Mtype_t mtype);


void dCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
nnz,  double  *nzval,  long  *colind,  long  *rowptr, Stype_t
stype, Dtype_t dtype, Mtype_t mtype);


void cCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
nnz,  complex  *nzval,  long  *colind,  long *rowptr, Stype_t
stype, Dtype_t dtype, Mtype_t mtype);


void zCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
nnz,   doublecomplex  *nzval,  long  *colind,  long  *rowptr,
Stype_t stype, Dtype_t dtype, Mtype_t mtype);

Description

Oracle Solaris Studio Performance Library            Create_CompRow_Matrix(3P)



NAME
       Create_CompRow_Matrix:  cCreate_CompRow_Matrix, dCreate_CompRow_Matrix,
       sCreate_CompRow_Matrix, zCreate_CompRow_Matrix - A utility  C  function
       in  the  serial SuperLU solver that creates a SuperMatrix in compressed
       sparse row format.


SYNOPSIS
       #include <sunperf.h>


       void sCreate_CompRow_Matrix(SuperMatrix *A, int  m,  int  n,  int  nnz,
                 float  *nzval,  int  *colind,  int  *rowptr,  Stype_t  stype,
                 Dtype_t dtype, Mtype_t mtype);


       void dCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, dou-
                 ble  *nzval, int *colind, int *rowptr, Stype_t stype, Dtype_t
                 dtype, Mtype_t mtype);


       void cCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, com-
                 plex *nzval, int *colind, int *rowptr, Stype_t stype, Dtype_t
                 dtype, Mtype_t mtype);


       void zCreate_CompRow_Matrix(SuperMatrix *A, int m, int n, int nnz, dou-
                 blecomplex  *nzval,  int *colind, int *rowptr, Stype_t stype,
                 Dtype_t dtype, Mtype_t mtype);


       void sCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
                 nnz, float *nzval, long *colind, long *rowptr, Stype_t stype,
                 Dtype_t dtype, Mtype_t mtype);


       void dCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
                 nnz,  double  *nzval,  long  *colind,  long  *rowptr, Stype_t
                 stype, Dtype_t dtype, Mtype_t mtype);


       void cCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
                 nnz,  complex  *nzval,  long  *colind,  long *rowptr, Stype_t
                 stype, Dtype_t dtype, Mtype_t mtype);


       void zCreate_CompRow_Matrix_64(SuperMatrix_64 *A, long m, long n,  long
                 nnz,   doublecomplex  *nzval,  long  *colind,  long  *rowptr,
                 Stype_t stype, Dtype_t dtype, Mtype_t mtype);


PURPOSE
       Create_CompRow_Matrix() creates a SuperMatrix in compressed column for-
       mat.


ARGUMENTS
       SuperMatrix *A (output)
                 On  exit,  A  holds  an  allocated  matrix as well as all the
                 describing elements of the structure object.


       int m (input)
                 m specifies the number of rows of the matrix to be created.


       int n (input)
                 n specifies the number of columns of the matrix  to  be  cre-
                 ated.


       int nnz (input)
                 nnz specifies the number of nonzeros of the matrix to be cre-
                 ated.


       float *nzval (input)
                 nzval points to the array of nonzero values  of  the  matrix,
                 packed by column.


       int *colind (input)
                 colind  points  to the array of column indices of the nonzero
                 values.


       int *rowptr (input)
                 rowptr is a pointer to the array  of  row  start  indices  in
                 nzval[] and colind[].


       Stype_t stype (input)
                 stype  specifies  the  storage  structure of the matrix to be
                 created.


       Dtype_t dtype (input)
                 dtype specifies the data type of the matrix to be created.


       Mtype_t mtype (input)
                 mtype specifies the mathematical property of the matrix to be
                 created.


NOTES
       To destroy the data structure in SuperMatrix A that was created by Cre-
       ate_CompRow_Matrix,  the  user  may  call  Destroy_CompRow_Matrix()  or
       Destroy_SuperMatrix_Store().  The former will attempt to deallocate the
       three arrays that Create_CompRow_Matrix requires on input.  If this  is
       not  desirable,  the  user  may  call Destroy_SuperMatrix_Store() which
       deallocates only the data structure that  Create_CompRow_Matrix  itself
       has allocated.


SEE ALSO
       Destroy_CompRow_Matrix

       Destroy_SuperMatrix_Store

       SuperMatrix

       http://crd.lbl.gov/~xiaoye/SuperLU/

       James  W.  Demmel,  Stanley C. Eisenstat, John R. Gilbert, Xiaoye S. Li
       and Joseph W. H. Liu, "A supernodal approach to sparse  partial  pivot-
       ing",  SIAM J. Matrix Analysis and Applications, Vol. 20, Num. 3, 1999,
       pp. 720-755.



                                  7 Nov 2015         Create_CompRow_Matrix(3P)