zCreate_Dense_Matrix (3p)

Name

zCreate_Dense_Matrix - 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);

Description

Oracle Solaris Studio 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);


PURPOSE
       Create_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.


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.



                                  7 Nov 2015           Create_Dense_Matrix(3P)