Create_CompRow_Matrix(3P) Sun 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);
PURPOSECreate_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.
COPYRIGHT
Copyright (c) 2003, The Regents of the University of California,
through Lawrence Berkeley National Laboratory (subject to receipt of
any required approvals from U.S. Dept. of Energy)
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.
6 Mar 2009 Create_CompRow_Matrix(3P)