Create_Dense_Matrix(3P) Sun Performance Library Create_Dense_Matrix(3P)NAME
Create_Dense_Matrix: cCreate_Dense_Matrix, dCreate_Dense_Matrix, sCre‐
ate_Dense_Matrix, zCreate_Dense_Matrix - A utility C function in the
serial SuperLU solver that creates a SuperMatrix in dense format.
SYNOPSIS
#include <sunperf.h>
void sCreate_Dense_Matrix(SuperMatrix *X, int m, int n, float *x, int
ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void dCreate_Dense_Matrix(SuperMatrix *X, int m, int n, double *x, int
ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void cCreate_Dense_Matrix(SuperMatrix *X, int m, int n, complex *x, int
ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void zCreate_Dense_Matrix(SuperMatrix *X, int m, int n, doublecomplex
*x, int ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void sCreate_Dense_Matrix_64(SuperMatrix_64 *X, int m, int n, float *x,
int ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void dCreate_Dense_Matrix_64(SuperMatrix_64 *X, int m, int n, double
*x, int ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void cCreate_Dense_Matrix_64(SuperMatrix_64 *X, int m, int n, complex
*x, int ldx, Stype_t stype, Dtype_t dtype, Mtype_t mtype);
void zCreate_Dense_Matrix_64(SuperMatrix_64 *X, int m, int n, double‐
complex *x, int ldx, Stype_t stype, Dtype_t dtype, Mtype_t
mtype);
PURPOSECreate_Dense_Matrix() creates a SuperMatrix in dense column format.
ARGUMENTS
SuperMatrix *X (output)
On exit, X 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.
float *x (input)
x is an array of dimension (ldx*n) that contains the elements
of the dense matrix, stored by column.
int ldx (input)
ldx specifies the leading dimension of the dense matrix
stored in x.
Stype_t stype (input)
stype specifies the storage structure of the matrix to be
created. In this case, stype must be SLU_DN.
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_Dense_Matrix, the user may call Destroy_Dense_Matrix() or
Destroy_SuperMatrix_Store(). The former will attempt to deallocate the
array that Create_Dense_Matrix requires on input. If this is not
desirable, the user may call Destroy_SuperMatrix_Store() which deallo‐
cates only the data structure that Create_Dense_Matrix itself has allo‐
cated.
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_SuperMatrix_Store
Destroy_Dense_Matrix
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_Dense_Matrix(3P)