single-complex precision

Functions
magma_int_t	magma_cresidual (magma_c_matrix A, magma_c_matrix b, magma_c_matrix x, float *res, magma_queue_t queue)
	Computes the residual ||b-Ax|| for a solution approximation x. More...
magma_int_t	magma_cresidual_slice (magma_int_t start, magma_int_t end, magma_c_matrix A, magma_c_matrix b, magma_c_matrix x, float *res, magma_queue_t queue)
	Computes the residual r=||b-Ax|| for the slice r(start:end) for a solution approximation x. More...
magma_int_t	magma_cresidualvec (magma_c_matrix A, magma_c_matrix b, magma_c_matrix x, magma_c_matrix *r, float *res, magma_queue_t queue)
	Computes the residual r = b-Ax for a solution approximation x. More...
magma_int_t	magma_c_precond (magma_c_matrix A, magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	For a given input matrix A and vectors x, y and the preconditioner parameters, the respective preconditioner is chosen. More...
magma_int_t	magma_c_precondsetup (magma_c_matrix A, magma_c_matrix b, magma_c_solver_par *solver, magma_c_preconditioner *precond, magma_queue_t queue)
	For a given input matrix M and vectors x, y and the preconditioner parameters, the respective preconditioner is preprocessed. More...
magma_int_t	magma_c_applyprecond (magma_c_matrix A, magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	For a given input matrix A and vectors x, y and the preconditioner parameters, the respective preconditioner is applied. More...
magma_int_t	magma_c_applyprecond_left (magma_trans_t trans, magma_c_matrix A, magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	For a given input matrix A and vectors x, y and the preconditioner parameters, the respective left preconditioner is applied. More...
magma_int_t	magma_c_applyprecond_right (magma_trans_t trans, magma_c_matrix A, magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	For a given input matrix A and vectors x, y and the preconditioner parameters, the respective right-preconditioner is applied. More...
magma_int_t	magma_c_solver (magma_c_matrix A, magma_c_matrix b, magma_c_matrix *x, magma_copts *zopts, magma_queue_t queue)
	Allows the user to choose a solver. More...
magma_int_t	magma_capplycustomprecond_l (magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	This is an interface to the left solve for any custom preconditioner. More...
magma_int_t	magma_capplycustomprecond_r (magma_c_matrix b, magma_c_matrix *x, magma_c_preconditioner *precond, magma_queue_t queue)
	This is an interface to the right solve for any custom preconditioner. More...
magma_int_t	magma_ccsrsplit (magma_int_t offset, magma_int_t bsize, magma_c_matrix A, magma_c_matrix *D, magma_c_matrix *R, magma_queue_t queue)
	Splits a CSR matrix into two matrices, one containing the diagonal blocks with the diagonal element stored first, one containing the rest of the original matrix. More...
magma_int_t	magma_cdomainoverlap (magma_index_t num_rows, magma_int_t *num_indices, magma_index_t *rowptr, magma_index_t *colidx, magma_index_t *x, magma_queue_t queue)
	Generates the update list. More...
magma_int_t	magma_cmfree (magma_c_matrix *A, magma_queue_t queue)
	Free the memory of a magma_c_matrix. More...
magma_int_t	magma_cfrobenius (magma_c_matrix A, magma_c_matrix B, real_Double_t *res, magma_queue_t queue)
	Computes the Frobenius norm of the difference between the CSR matrices A and B. More...
magma_int_t	magma_cnonlinres (magma_c_matrix A, magma_c_matrix L, magma_c_matrix U, magma_c_matrix *LU, real_Double_t *res, magma_queue_t queue)
	Computes the nonlinear residual A - LU and returns the difference as well es the Frobenius norm of the difference. More...
magma_int_t	magma_cilures (magma_c_matrix A, magma_c_matrix L, magma_c_matrix U, magma_c_matrix *LU, real_Double_t *res, real_Double_t *nonlinres, magma_queue_t queue)
	Computes the ILU residual A - LU and returns the difference as well es the Frobenius norm of the difference. More...
magma_int_t	magma_cicres (magma_c_matrix A, magma_c_matrix C, magma_c_matrix CT, magma_c_matrix *LU, real_Double_t *res, real_Double_t *nonlinres, magma_queue_t queue)
	Computes the IC residual A - CC^T and returns the difference as well es the Frobenius norm of the difference. More...
magma_int_t	magma_cinitguess (magma_c_matrix A, magma_c_matrix *L, magma_c_matrix *U, magma_queue_t queue)
	Computes an initial guess for the iterative ILU/IC. More...
magma_int_t	magma_cinitrecursiveLU (magma_c_matrix A, magma_c_matrix *B, magma_queue_t queue)
	Using the iterative approach of computing ILU factorizations with increasing fill-in, it takes the input matrix A, containing the approximate factors, ( L and U as well ) computes a matrix with one higher level of fill-in, inserts the original approximation as initial guess, and provides the factors L and U also filled with the scaled initial guess. More...
magma_int_t	magma_cmLdiagadd (magma_c_matrix *L, magma_queue_t queue)
	Checks for a lower triangular matrix whether it is strictly lower triangular and in the negative case adds a unit diagonal. More...
magma_int_t	magma_crowentries (magma_c_matrix *A, magma_queue_t queue)
	Checks the maximal number of nonzeros in a row of matrix A. More...
magma_int_t	magma_cdiameter (magma_c_matrix *A, magma_queue_t queue)
	Computes the diameter of a sparse matrix and stores the value in diameter. More...
magma_int_t	magma_c_csr_compressor (magmaFloatComplex **val, magma_index_t **row, magma_index_t **col, magmaFloatComplex **valn, magma_index_t **rown, magma_index_t **coln, magma_int_t *n, magma_queue_t queue)
	Helper function to compress CSR containing zero-entries. More...
magma_int_t	magma_cmconvert (magma_c_matrix A, magma_c_matrix *B, magma_storage_t old_format, magma_storage_t new_format, magma_queue_t queue)
	Converter between different sparse storage formats. More...
magma_int_t	magma_cmcsrcompressor (magma_c_matrix *A, magma_queue_t queue)
	Removes zeros in a CSR matrix. More...
magma_int_t	magma_ccsrset (magma_int_t m, magma_int_t n, magma_index_t *row, magma_index_t *col, magmaFloatComplex *val, magma_c_matrix *A, magma_queue_t queue)
	Passes a CSR matrix to MAGMA. More...
magma_int_t	magma_ccsrget (magma_c_matrix A, magma_int_t *m, magma_int_t *n, magma_index_t **row, magma_index_t **col, magmaFloatComplex **val, magma_queue_t queue)
	Passes a MAGMA matrix to CSR structure. More...
magma_int_t	magma_ccsrset_gpu (magma_int_t m, magma_int_t n, magmaIndex_ptr row, magmaIndex_ptr col, magmaFloatComplex_ptr val, magma_c_matrix *A, magma_queue_t queue)
	Passes a CSR matrix to MAGMA (located on DEV). More...
magma_int_t	magma_ccsrget_gpu (magma_c_matrix A, magma_int_t *m, magma_int_t *n, magmaIndex_ptr *row, magmaIndex_ptr *col, magmaFloatComplex_ptr *val, magma_queue_t queue)
	Passes a MAGMA matrix to CSR structure (located on DEV). More...
magma_int_t	magma_cmdiff (magma_c_matrix A, magma_c_matrix B, real_Double_t *res, magma_queue_t queue)
	Computes the Frobenius norm of the difference between the CSR matrices A and B. More...
magma_int_t	magma_cmgenerator (magma_int_t n, magma_int_t offdiags, magma_index_t *diag_offset, magmaFloatComplex *diag_vals, magma_c_matrix *A, magma_queue_t queue)
	Generate a symmetric n x n CSR matrix for a stencil. More...
magma_int_t	magma_cm_27stencil (magma_int_t n, magma_c_matrix *A, magma_queue_t queue)
	Generate a 27-point stencil for a 3D FD discretization. More...
magma_int_t	magma_cm_5stencil (magma_int_t n, magma_c_matrix *A, magma_queue_t queue)
	Generate a 5-point stencil for a 2D FD discretization. More...
magma_int_t	magma_csymbilu (magma_c_matrix *A, magma_int_t levels, magma_c_matrix *L, magma_c_matrix *U, magma_queue_t queue)
	This routine performs a symbolic ILU factorization. More...
magma_int_t	read_c_csr_from_mtx (magma_storage_t *type, magma_location_t *location, magma_int_t *n_row, magma_int_t *n_col, magma_int_t *nnz, magmaFloatComplex **val, magma_index_t **row, magma_index_t **col, const char *filename, magma_queue_t queue)
	Reads in a matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format. More...
magma_int_t	magma_cwrite_csr_mtx (magma_c_matrix A, magma_order_t MajorType, const char *filename, magma_queue_t queue)
	Writes a CSR matrix to a file using Matrix Market format. More...
magma_int_t	magma_cprint_csr_mtx (magma_int_t n_row, magma_int_t n_col, magma_int_t nnz, magmaFloatComplex **val, magma_index_t **row, magma_index_t **col, magma_order_t MajorType, magma_queue_t queue)
	Prints a CSR matrix in Matrix Market format. More...
magma_int_t	magma_cprint_csr (magma_int_t n_row, magma_int_t n_col, magma_int_t nnz, magmaFloatComplex **val, magma_index_t **row, magma_index_t **col, magma_queue_t queue)
	Prints a CSR matrix in CSR format. More...
magma_int_t	magma_cprint_matrix (magma_c_matrix A, magma_queue_t queue)
	Prints a sparse matrix in CSR format. More...
magma_int_t	magma_c_csr_mtx (magma_c_matrix *A, const char *filename, magma_queue_t queue)
	Reads in a matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format. More...
magma_int_t	magma_c_csr_mtxsymm (magma_c_matrix *A, const char *filename, magma_queue_t queue)
	Reads in a SYMMETRIC matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format. More...
magma_int_t	magma_cmlumerge (magma_c_matrix L, magma_c_matrix U, magma_c_matrix *A, magma_queue_t queue)
	Takes an strictly lower triangular matrix L and an upper triangular matrix U and merges them into a matrix A containing the upper and lower triangular parts. More...
magma_int_t	magma_cmscale (magma_c_matrix *A, magma_scale_t scaling, magma_queue_t queue)
	Scales a matrix. More...
magma_int_t	magma_cmdiagadd (magma_c_matrix *A, magmaFloatComplex add, magma_queue_t queue)
	Adds a multiple of the Identity matrix to a matrix: A = A+add * I. More...
magma_int_t	magma_cmshrink (magma_c_matrix A, magma_c_matrix *B, magma_queue_t queue)
	Shrinks a non-square matrix (m < n) to the smaller dimension. More...
magma_int_t	magma_cmslice (magma_int_t num_slices, magma_int_t slice, magma_c_matrix A, magma_c_matrix *B, magma_c_matrix *ALOC, magma_c_matrix *ANLOC, magma_index_t *comm_i, magmaFloatComplex *comm_v, magma_int_t *start, magma_int_t *end, magma_queue_t queue)
	Takes a matrix and extracts a slice for solving the system in parallel: More...
magma_int_t	magma_cmtransfer (magma_c_matrix A, magma_c_matrix *B, magma_location_t src, magma_location_t dst, magma_queue_t queue)
	Copies a matrix from memory location src to memory location dst. More...
magma_int_t	c_transpose_csr (magma_int_t n_rows, magma_int_t n_cols, magma_int_t nnz, magmaFloatComplex *values, magma_index_t *rowptr, magma_index_t *colind, magma_int_t *new_n_rows, magma_int_t *new_n_cols, magma_int_t *new_nnz, magmaFloatComplex **new_values, magma_index_t **new_rowptr, magma_index_t **new_colind, magma_queue_t queue)
	Transposes a matrix stored in CSR format on the CPU host. More...
magma_int_t	magma_cmtranspose (magma_c_matrix A, magma_c_matrix *B, magma_queue_t queue)
	Interface to cuSPARSE transpose. More...
magma_int_t	magma_c_cucsrtranspose (magma_c_matrix A, magma_c_matrix *B, magma_queue_t queue)
	Helper function to transpose CSR matrix. More...
magma_int_t	magma_cmtransposeconjugate (magma_c_matrix A, magma_c_matrix *B, magma_queue_t queue)
	This function forms the transpose conjugate of a matrix. More...
magma_int_t	magma_csolverinfo (magma_c_solver_par *solver_par, magma_c_preconditioner *precond_par, magma_queue_t queue)
	Prints information about a previously called solver. More...
magma_int_t	magma_csolverinfo_free (magma_c_solver_par *solver_par, magma_c_preconditioner *precond_par, magma_queue_t queue)
	Frees any memory assocoiated with the verbose mode of solver_par. More...
magma_int_t	magma_csolverinfo_init (magma_c_solver_par *solver_par, magma_c_preconditioner *precond_par, magma_queue_t queue)
	Initializes all solver and preconditioner parameters. More...
magma_int_t	magma_ceigensolverinfo_init (magma_c_solver_par *solver_par, magma_queue_t queue)
	Initializes space for eigensolvers. More...
magma_int_t	magma_csort (magmaFloatComplex *x, magma_int_t first, magma_int_t last, magma_queue_t queue)
	Sorts an array of values in increasing order. More...
magma_int_t	magma_cmsort (magmaFloatComplex *x, magma_index_t *col, magma_index_t *row, magma_int_t first, magma_int_t last, magma_queue_t queue)
	Sorts an array of values in increasing order. More...
magma_int_t	magma_cindexsort (magma_index_t *x, magma_int_t first, magma_int_t last, magma_queue_t queue)
	Sorts an array of integers in increasing order. More...
magma_int_t	magma_cindexsortval (magma_index_t *x, magmaFloatComplex *y, magma_int_t first, magma_int_t last, magma_queue_t queue)
	Sorts an array of integers, updates a respective array of values. More...
magma_int_t	magma_cmorderstatistics (magmaFloatComplex *val, magma_index_t *col, magma_index_t *row, magma_int_t length, magma_int_t k, magma_int_t r, magmaFloatComplex *element, magma_queue_t queue)
	Identifies the kth smallest/largest element in an array and reorders such that these elements come to the front. More...
magma_int_t	magma_corderstatistics (magmaFloatComplex *val, magma_int_t length, magma_int_t k, magma_int_t r, magmaFloatComplex *element, magma_queue_t queue)
	Identifies the kth smallest/largest element in an array. More...
magma_int_t	magma_cparse_opts (int argc, char **argv, magma_copts *opts, int *matrices, magma_queue_t queue)
	Parses input options for a solver. More...
magma_int_t	magma_cvinit (magma_c_matrix *x, magma_location_t mem_loc, magma_int_t num_rows, magma_int_t num_cols, magmaFloatComplex values, magma_queue_t queue)
	Allocates memory for magma_c_matrix and initializes it with the passed value. More...
magma_int_t	magma_cprint_vector (magma_c_matrix x, magma_int_t offset, magma_int_t visulen, magma_queue_t queue)
	Visualizes part of a vector of type magma_c_matrix. More...
magma_int_t	magma_cvread (magma_c_matrix *x, magma_int_t length, char *filename, magma_queue_t queue)
	Reads in a float vector of length "length". More...
magma_int_t	magma_cvspread (magma_c_matrix *x, const char *filename, magma_queue_t queue)
	Reads in a sparse vector-block stored in COO format. More...
magma_int_t	magma_cvset (magma_int_t m, magma_int_t n, magmaFloatComplex *val, magma_c_matrix *v, magma_queue_t queue)
	Passes a vector to MAGMA. More...
magma_int_t	magma_cvget (magma_c_matrix v, magma_int_t *m, magma_int_t *n, magmaFloatComplex **val, magma_queue_t queue)
	Passes a MAGMA vector back. More...
magma_int_t	magma_cvset_dev (magma_int_t m, magma_int_t n, magmaFloatComplex_ptr val, magma_c_matrix *v, magma_queue_t queue)
	Passes a vector to MAGMA (located on DEV). More...
magma_int_t	magma_cvget_dev (magma_c_matrix v, magma_int_t *m, magma_int_t *n, magmaFloatComplex_ptr *val, magma_queue_t queue)
	Passes a MAGMA vector back (located on DEV). More...
magma_int_t	magma_cvtranspose (magma_c_matrix x, magma_c_matrix *y, magma_queue_t queue)
	Transposes a vector from col to row major and vice versa. More...
magma_int_t	magma_vector_clag2z (magma_c_vector x, magma_z_matrix *y, magma_queue_t queue)
	convertes magma_c_vector from C to Z More...
magma_int_t	magma_sparse_matrix_clag2z (magma_c_sparse_matrix A, magma_z_matrix *B, magma_queue_t queue)
	convertes magma_c_sparse_matrix from C to Z More...

Detailed Description

Function Documentation

magma_int_t c_transpose_csr	(	magma_int_t	n_rows,
		magma_int_t	n_cols,
		magma_int_t	nnz,
		magmaFloatComplex *	values,
		magma_index_t *	rowptr,
		magma_index_t *	colind,
		magma_int_t *	new_n_rows,
		magma_int_t *	new_n_cols,
		magma_int_t *	new_nnz,
		magmaFloatComplex **	new_values,
		magma_index_t **	new_rowptr,
		magma_index_t **	new_colind,
		magma_queue_t	queue
	)

Transposes a matrix stored in CSR format on the CPU host.

Parameters

[in]	n_rows	magma_int_t number of rows in input matrix
[in]	n_cols	magma_int_t number of columns in input matrix
[in]	nnz	magma_int_t number of nonzeros in input matrix
[in]	values	magmaFloatComplex* value array of input matrix
[in]	rowptr	magma_index_t* row pointer of input matrix
[in]	colind	magma_index_t* column indices of input matrix
[in]	new_n_rows	magma_index_t* number of rows in transposed matrix
[in]	new_n_cols	magma_index_t* number of columns in transposed matrix
[in]	new_nnz	magma_index_t* number of nonzeros in transposed matrix
[in]	new_values	magmaFloatComplex** value array of transposed matrix
[in]	new_rowptr	magma_index_t** row pointer of transposed matrix
[in]	new_colind	magma_index_t** column indices of transposed matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_applyprecond	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

For a given input matrix A and vectors x, y and the preconditioner parameters, the respective preconditioner is applied.

E.g. for Jacobi: the scaling-vetor, for ILU the triangular solves.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[in]	b	magma_c_matrix input vector b
[in,out]	x	magma_c_matrix* output vector x
[in]	precond	magma_c_preconditioner preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_applyprecond_left	(	magma_trans_t	trans,
		magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

For a given input matrix A and vectors x, y and the preconditioner parameters, the respective left preconditioner is applied.

E.g. for Jacobi: the scaling-vetor, for ILU the left triangular solve.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[in]	b	magma_c_matrix input vector b
[in,out]	x	magma_c_matrix* output vector x
[in]	precond	magma_c_preconditioner preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_applyprecond_right	(	magma_trans_t	trans,
		magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

For a given input matrix A and vectors x, y and the preconditioner parameters, the respective right-preconditioner is applied.

E.g. for Jacobi: the scaling-vetor, for ILU the right triangular solve.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[in]	b	magma_c_matrix input vector b
[in,out]	x	magma_c_matrix* output vector x
[in]	precond	magma_c_preconditioner preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_csr_compressor	(	magmaFloatComplex **	val,
		magma_index_t **	row,
		magma_index_t **	col,
		magmaFloatComplex **	valn,
		magma_index_t **	rown,
		magma_index_t **	coln,
		magma_int_t *	n,
		magma_queue_t	queue
	)

Helper function to compress CSR containing zero-entries.

Parameters

[in]	val	magmaFloatComplex** input val pointer to compress
[in]	row	magma_int_t** input row pointer to modify
[in]	col	magma_int_t** input col pointer to compress
[in]	valn	magmaFloatComplex** output val pointer
[out]	rown	magma_int_t** output row pointer
[out]	coln	magma_int_t** output col pointer
[out]	n	magma_int_t* number of rows in matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_csr_mtx	(	magma_c_matrix *	A,
		const char *	filename,
		magma_queue_t	queue
	)

Reads in a matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format.

It duplicates the off-diagonal entries in the symmetric case.

Parameters

[out]	A	magma_c_matrix* matrix in magma sparse matrix format
[in]	filename	const char* filname of the mtx matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_csr_mtxsymm	(	magma_c_matrix *	A,
		const char *	filename,
		magma_queue_t	queue
	)

Reads in a SYMMETRIC matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format.

It does not duplicate the off-diagonal entries!

Parameters

[out]	A	magma_c_matrix* matrix in magma sparse matrix format
[in]	filename	const char* filname of the mtx matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_cucsrtranspose	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_queue_t	queue
	)

Helper function to transpose CSR matrix.

Using the CUSPARSE CSR2CSC function.

Parameters

[in]	A	magma_c_matrix input matrix (CSR)
[out]	B	magma_c_matrix* output matrix (CSR)
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_precond	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

For a given input matrix A and vectors x, y and the preconditioner parameters, the respective preconditioner is chosen.

It approximates x for A x = y.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[in]	b	magma_c_matrix input vector b
[in]	x	magma_c_matrix* output vector x
[in,out]	precond	magma_c_preconditioner preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_precondsetup	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_solver_par *	solver,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

For a given input matrix M and vectors x, y and the preconditioner parameters, the respective preconditioner is preprocessed.

E.g. for Jacobi: the scaling-vetor, for ILU the factorization.

Parameters

[in]	A	magma_c_matrix sparse matrix M
[in]	b	magma_c_matrix input vector y
[in,out]	precond	magma_c_preconditioner preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_c_solver	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_copts *	zopts,
		magma_queue_t	queue
	)

Allows the user to choose a solver.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[in]	b	magma_c_matrix input vector b
[in]	x	magma_c_matrix* output vector x
[in]	zopts	magma_copts options for solver and preconditioner
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_capplycustomprecond_l	(	magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

This is an interface to the left solve for any custom preconditioner.

It should compute x = FUNCTION(b) The vectors are located on the device.

Parameters

[in]	b	magma_c_matrix RHS
[in,out]	x	magma_c_matrix* vector to precondition
[in,out]	precond	magma_c_preconditioner* preconditioner parameters
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_capplycustomprecond_r	(	magma_c_matrix	b,
		magma_c_matrix *	x,
		magma_c_preconditioner *	precond,
		magma_queue_t	queue
	)

This is an interface to the right solve for any custom preconditioner.

It should compute x = FUNCTION(b) The vectors are located on the device.

Parameters

[in]	b	magma_c_matrix RHS
[in,out]	x	magma_c_matrix* vector to precondition
[in,out]	precond	magma_c_preconditioner* preconditioner parameters
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ccsrget	(	magma_c_matrix	A,
		magma_int_t *	m,
		magma_int_t *	n,
		magma_index_t **	row,
		magma_index_t **	col,
		magmaFloatComplex **	val,
		magma_queue_t	queue
	)

Passes a MAGMA matrix to CSR structure.

Parameters

[in]	A	magma_c_matrix magma sparse matrix in CSR format
[out]	m	magma_int_t number of rows
[out]	n	magma_int_t number of columns
[out]	row	magma_index_t* row pointer
[out]	col	magma_index_t* column indices
[out]	val	magmaFloatComplex* array containing matrix entries
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ccsrget_gpu	(	magma_c_matrix	A,
		magma_int_t *	m,
		magma_int_t *	n,
		magmaIndex_ptr *	row,
		magmaIndex_ptr *	col,
		magmaFloatComplex_ptr *	val,
		magma_queue_t	queue
	)

Passes a MAGMA matrix to CSR structure (located on DEV).

Parameters

[in]	A	magma_c_matrix magma sparse matrix in CSR format
[out]	m	magma_int_t number of rows
[out]	n	magma_int_t number of columns
[out]	row	magmaIndex_ptr row pointer
[out]	col	magmaIndex_ptr column indices
[out]	val	magmaFloatComplex_ptr array containing matrix entries
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ccsrset	(	magma_int_t	m,
		magma_int_t	n,
		magma_index_t *	row,
		magma_index_t *	col,
		magmaFloatComplex *	val,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Passes a CSR matrix to MAGMA.

Parameters

[in]	m	magma_int_t number of rows
[in]	n	magma_int_t number of columns
[in]	row	magma_index_t* row pointer
[in]	col	magma_index_t* column indices
[in]	val	magmaFloatComplex* array containing matrix entries
[out]	A	magma_c_matrix* matrix in magma sparse matrix format
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ccsrset_gpu	(	magma_int_t	m,
		magma_int_t	n,
		magmaIndex_ptr	row,
		magmaIndex_ptr	col,
		magmaFloatComplex_ptr	val,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Passes a CSR matrix to MAGMA (located on DEV).

Parameters

[in]	m	magma_int_t number of rows
[in]	n	magma_int_t number of columns
[in]	row	magmaIndex_ptr row pointer
[in]	col	magmaIndex_ptr column indices
[in]	val	magmaFloatComplex_ptr array containing matrix entries
[out]	A	magma_c_matrix* matrix in magma sparse matrix format
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ccsrsplit	(	magma_int_t	offset,
		magma_int_t	bsize,
		magma_c_matrix	A,
		magma_c_matrix *	D,
		magma_c_matrix *	R,
		magma_queue_t	queue
	)

Splits a CSR matrix into two matrices, one containing the diagonal blocks with the diagonal element stored first, one containing the rest of the original matrix.

Parameters

[in]	offset	magma_int_t size of the first block
[in]	bsize	magma_int_t size of the diagonal blocks
[in]	A	magma_c_matrix CSR input matrix
[out]	D	magma_c_matrix* CSR matrix containing diagonal blocks
[out]	R	magma_c_matrix* CSR matrix containing rest
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cdiameter	(	magma_c_matrix *	A,
		magma_queue_t	queue
	)

Computes the diameter of a sparse matrix and stores the value in diameter.

Parameters

[in,out]	A	magma_c_matrix* sparse matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cdomainoverlap	(	magma_index_t	num_rows,
		magma_int_t *	num_indices,
		magma_index_t *	rowptr,
		magma_index_t *	colidx,
		magma_index_t *	x,
		magma_queue_t	queue
	)

Generates the update list.

Parameters

[in]	x	magma_index_t* array to sort
[in]	num_rows	magma_int_t number of rows in matrix
[out]	num_indices	magma_int_t* number of indices in array
[in]	rowptr	magma_index_t* rowpointer of matrix
[in]	colidx	magma_index_t* colindices of matrix
[in]	x	magma_index_t* array containing indices for domain overlap
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_ceigensolverinfo_init	(	magma_c_solver_par *	solver_par,
		magma_queue_t	queue
	)

Initializes space for eigensolvers.

Parameters

[in,out]	solver_par	magma_c_solver_par* structure containing all solver information
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cfrobenius	(	magma_c_matrix	A,
		magma_c_matrix	B,
		real_Double_t *	res,
		magma_queue_t	queue
	)

Computes the Frobenius norm of the difference between the CSR matrices A and B.

They need to share the same sparsity pattern!

Parameters

[in]	A	magma_c_matrix sparse matrix in CSR
[in]	B	magma_c_matrix sparse matrix in CSR
[out]	res	real_Double_t* Frobenius norm of difference
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cicres	(	magma_c_matrix	A,
		magma_c_matrix	C,
		magma_c_matrix	CT,
		magma_c_matrix *	LU,
		real_Double_t *	res,
		real_Double_t *	nonlinres,
		magma_queue_t	queue
	)

Computes the IC residual A - CC^T and returns the difference as well es the Frobenius norm of the difference.

Parameters

[in]	A	magma_c_matrix input sparse matrix in CSR
[in]	C	magma_c_matrix input sparse matrix in CSR
[in]	CT	magma_c_matrix input sparse matrix in CSR
[in]	LU	magma_c_matrix* output sparse matrix in A-LU in CSR
[out]	res	real_Double_t* IC residual
[out]	nonlinres	real_Double_t* nonlinear residual
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cilures	(	magma_c_matrix	A,
		magma_c_matrix	L,
		magma_c_matrix	U,
		magma_c_matrix *	LU,
		real_Double_t *	res,
		real_Double_t *	nonlinres,
		magma_queue_t	queue
	)

Computes the ILU residual A - LU and returns the difference as well es the Frobenius norm of the difference.

Parameters

[in]	A	magma_c_matrix input sparse matrix in CSR
[in]	L	magma_c_matrix input sparse matrix in CSR
[in]	U	magma_c_matrix input sparse matrix in CSR
[out]	LU	magma_c_matrix* output sparse matrix in A-LU in CSR
[out]	res	real_Double_t* Frobenius norm of difference
[out]	nonlinres	real_Double_t* Frobenius norm of difference
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cindexsort	(	magma_index_t *	x,
		magma_int_t	first,
		magma_int_t	last,
		magma_queue_t	queue
	)

Sorts an array of integers in increasing order.

Parameters

[in,out]	x	magma_index_t* array to sort
[in]	first	magma_int_t pointer to first element
[in]	last	magma_int_t pointer to last element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cindexsortval	(	magma_index_t *	x,
		magmaFloatComplex *	y,
		magma_int_t	first,
		magma_int_t	last,
		magma_queue_t	queue
	)

Sorts an array of integers, updates a respective array of values.

Parameters

[in,out]	x	magma_index_t* array to sort
[in,out]	y	magmaFloatComplex* array to sort
[in]	first	magma_int_t pointer to first element
[in]	last	magma_int_t pointer to last element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cinitguess	(	magma_c_matrix	A,
		magma_c_matrix *	L,
		magma_c_matrix *	U,
		magma_queue_t	queue
	)

Computes an initial guess for the iterative ILU/IC.

Parameters

[in]	A	magma_c_matrix sparse matrix in CSR
[out]	L	magma_c_matrix* sparse matrix in CSR
[out]	U	magma_c_matrix* sparse matrix in CSR
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cinitrecursiveLU	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_queue_t	queue
	)

Using the iterative approach of computing ILU factorizations with increasing fill-in, it takes the input matrix A, containing the approximate factors, ( L and U as well ) computes a matrix with one higher level of fill-in, inserts the original approximation as initial guess, and provides the factors L and U also filled with the scaled initial guess.

Parameters

[in]	A	magma_c_matrix* sparse matrix in CSR
[out]	B	magma_c_matrix* sparse matrix in CSR
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cm_27stencil	(	magma_int_t	n,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Generate a 27-point stencil for a 3D FD discretization.

Parameters

[in]	n	magma_int_t number of rows
[out]	A	magma_c_matrix* matrix to generate
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cm_5stencil	(	magma_int_t	n,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Generate a 5-point stencil for a 2D FD discretization.

Parameters

[in]	n	magma_int_t number of rows
[out]	A	magma_c_matrix* matrix to generate
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmconvert	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_storage_t	old_format,
		magma_storage_t	new_format,
		magma_queue_t	queue
	)

Converter between different sparse storage formats.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[out]	B	magma_c_matrix* copy of A in new format
[in]	old_format	magma_storage_t original storage format
[in]	new_format	magma_storage_t new storage format
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmcsrcompressor	(	magma_c_matrix *	A,
		magma_queue_t	queue
	)

Removes zeros in a CSR matrix.

Parameters

[in,out]	A	magma_c_matrix* input/output matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmdiagadd	(	magma_c_matrix *	A,
		magmaFloatComplex	add,
		magma_queue_t	queue
	)

Adds a multiple of the Identity matrix to a matrix: A = A+add * I.

Parameters

[in,out]	A	magma_c_matrix* input/output matrix
[in]	add	magmaFloatComplex scaling for the identity matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmdiff	(	magma_c_matrix	A,
		magma_c_matrix	B,
		real_Double_t *	res,
		magma_queue_t	queue
	)

Computes the Frobenius norm of the difference between the CSR matrices A and B.

They do not need to share the same sparsity pattern!

   res = ||A-B||_F = sqrt( sum_ij (A_ij-B_ij)^2 )

Parameters

[in]	A	magma_c_matrix sparse matrix in CSR
[in]	B	magma_c_matrix sparse matrix in CSR
[out]	res	real_Double_t* residual
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmfree	(	magma_c_matrix *	A,
		magma_queue_t	queue
	)

Free the memory of a magma_c_matrix.

Parameters

[in,out]	A	magma_c_matrix* matrix to free
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmgenerator	(	magma_int_t	n,
		magma_int_t	offdiags,
		magma_index_t *	diag_offset,
		magmaFloatComplex *	diag_vals,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Generate a symmetric n x n CSR matrix for a stencil.

Parameters

[in]	n	magma_int_t number of rows
[in]	offdiags	magma_int_t number of offdiagonals
[in]	diag_offset	magma_int_t* array containing the offsets (length offsets+1)
[in]	diag_vals	magmaFloatComplex* array containing the values (length offsets+1)
[out]	A	magma_c_matrix* matrix to generate
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmLdiagadd	(	magma_c_matrix *	L,
		magma_queue_t	queue
	)

Checks for a lower triangular matrix whether it is strictly lower triangular and in the negative case adds a unit diagonal.

It does this in-place.

Parameters

[in,out]	L	magma_c_matrix* sparse matrix in CSR
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmlumerge	(	magma_c_matrix	L,
		magma_c_matrix	U,
		magma_c_matrix *	A,
		magma_queue_t	queue
	)

Takes an strictly lower triangular matrix L and an upper triangular matrix U and merges them into a matrix A containing the upper and lower triangular parts.

Parameters

[in]	L	magma_c_matrix input strictly lower triangular matrix L
[in]	U	magma_c_matrix input upper triangular matrix U
[out]	A	magma_c_matrix* output matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmorderstatistics	(	magmaFloatComplex *	val,
		magma_index_t *	col,
		magma_index_t *	row,
		magma_int_t	length,
		magma_int_t	k,
		magma_int_t	r,
		magmaFloatComplex *	element,
		magma_queue_t	queue
	)

Identifies the kth smallest/largest element in an array and reorders such that these elements come to the front.

The related arrays col and row are also reordered.

Parameters

[in,out]	val	magmaFloatComplex* Target array, will be modified during operation.
[in,out]	col	magma_index_t* Target array, will be modified during operation.
[in,out]	row	magma_index_t* Target array, will be modified during operation.
[in]	length	magma_int_t Length of the target array.
[in]	k	magma_int_t Element to be identified (largest/smallest).
[in]	r	magma_int_t rule how to sort: '1' -> largest, '0' -> smallest
[out]	element	magmaFloatComplex* location of the respective element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmscale	(	magma_c_matrix *	A,
		magma_scale_t	scaling,
		magma_queue_t	queue
	)

Scales a matrix.

Parameters

[in,out]	A	magma_c_matrix* input/output matrix
[in]	scaling	magma_scale_t scaling type (unit rownorm / unit diagonal)
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmshrink	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_queue_t	queue
	)

Shrinks a non-square matrix (m < n) to the smaller dimension.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[out]	B	magma_c_matrix* sparse matrix A
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmslice	(	magma_int_t	num_slices,
		magma_int_t	slice,
		magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_c_matrix *	ALOC,
		magma_c_matrix *	ANLOC,
		magma_index_t *	comm_i,
		magmaFloatComplex *	comm_v,
		magma_int_t *	start,
		magma_int_t *	end,
		magma_queue_t	queue
	)

Takes a matrix and extracts a slice for solving the system in parallel:

B = A( i:i+n, : ) and ALOC = A(i:i+n,i:i+n) and ANLOCA(0:start - end:n,:)

B is of size n x n, ALOC of size end-start x end-start, ANLOC of size end-start x n

The last slice might be smaller. For the non-local parts, B is the identity. comm contains 1ess in the locations that are non-local but needed to solve local system.

Parameters

[in]	num_slices	magma_int_t number of slices
[in]	slice	magma_int_t slice id (0.. num_slices-1)
[in]	A	magma_c_matrix sparse matrix in CSR
[out]	B	magma_c_matrix* sparse matrix in CSR
[out]	ALOC	magma_c_matrix* sparse matrix in CSR
[out]	ANLOC	magma_c_matrix* sparse matrix in CSR
[in,out]	comm_i	magma_int_t* communication plan
[in,out]	comm_v	magmaFloatComplex* communication plan
[in]	queue	magma_queue_t Queue to execute in.
[out]	start	magma_int_t* start of slice (row-index)
[out]	end	magma_int_t* end of slice (row-index)

magma_int_t magma_cmsort	(	magmaFloatComplex *	x,
		magma_index_t *	col,
		magma_index_t *	row,
		magma_int_t	first,
		magma_int_t	last,
		magma_queue_t	queue
	)

Sorts an array of values in increasing order.

Parameters

[in,out]	x	magmaFloatComplex* array to sort
[in,out]	col	magma_index_t* Target array, will be modified during operation.
[in,out]	row	magma_index_t* Target array, will be modified during operation.
[in]	first	magma_int_t pointer to first element
[in]	last	magma_int_t pointer to last element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmtransfer	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_location_t	src,
		magma_location_t	dst,
		magma_queue_t	queue
	)

Copies a matrix from memory location src to memory location dst.

Parameters

[in]	A	magma_c_matrix sparse matrix A
[out]	B	magma_c_matrix* copy of A
[in]	src	magma_location_t original location A
[in]	dst	magma_location_t location of the copy of A
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmtranspose	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_queue_t	queue
	)

Interface to cuSPARSE transpose.

Parameters

[in]	A	magma_c_matrix input matrix (CSR)
[out]	B	magma_c_matrix* output matrix (CSR)
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cmtransposeconjugate	(	magma_c_matrix	A,
		magma_c_matrix *	B,
		magma_queue_t	queue
	)

This function forms the transpose conjugate of a matrix.

For a real-value matrix, the output is the transpose.

Parameters

[in]	A	magma_c_matrix input matrix (CSR)
[out]	B	magma_c_matrix* output matrix (CSR)
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cnonlinres	(	magma_c_matrix	A,
		magma_c_matrix	L,
		magma_c_matrix	U,
		magma_c_matrix *	LU,
		real_Double_t *	res,
		magma_queue_t	queue
	)

Computes the nonlinear residual A - LU and returns the difference as well es the Frobenius norm of the difference.

Parameters

[in]	A	magma_c_matrix input sparse matrix in CSR
[in]	L	magma_c_matrix input sparse matrix in CSR
[in]	U	magma_c_matrix input sparse matrix in CSR
[out]	LU	magma_c_matrix* output sparse matrix in A-LU in CSR
[out]	res	real_Double_t* Frobenius norm of difference
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_corderstatistics	(	magmaFloatComplex *	val,
		magma_int_t	length,
		magma_int_t	k,
		magma_int_t	r,
		magmaFloatComplex *	element,
		magma_queue_t	queue
	)

Identifies the kth smallest/largest element in an array.

Parameters

[in,out]	val	magmaFloatComplex* Target array, will be modified during operation.
[in]	length	magma_int_t Length of the target array.
[in]	k	magma_int_t Element to be identified (largest/smallest).
[in]	r	magma_int_t rule how to sort: '1' -> largest, '0' -> smallest
[out]	element	magmaFloatComplex* location of the respective element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cparse_opts	(	int	argc,
		char **	argv,
		magma_copts *	opts,
		int *	matrices,
		magma_queue_t	queue
	)

Parses input options for a solver.

Parameters

[in]	argc	int command line input
[in]	argv	char** command line input
[in,out]	opts	magma_copts * magma solver options
[out]	matrices	int counter how many linear systems to process
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cprint_csr	(	magma_int_t	n_row,
		magma_int_t	n_col,
		magma_int_t	nnz,
		magmaFloatComplex **	val,
		magma_index_t **	row,
		magma_index_t **	col,
		magma_queue_t	queue
	)

Prints a CSR matrix in CSR format.

Parameters

[in]	n_row	magma_int_t* number of rows in matrix
[in]	n_col	magma_int_t* number of columns in matrix
[in]	nnz	magma_int_t* number of nonzeros in matrix
[in]	val	magmaFloatComplex** value array of CSR
[in]	row	magma_index_t** row pointer of CSR
[in]	col	magma_index_t** column indices of CSR
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cprint_csr_mtx	(	magma_int_t	n_row,
		magma_int_t	n_col,
		magma_int_t	nnz,
		magmaFloatComplex **	val,
		magma_index_t **	row,
		magma_index_t **	col,
		magma_order_t	MajorType,
		magma_queue_t	queue
	)

Prints a CSR matrix in Matrix Market format.

Parameters

[in]	n_row	magma_int_t* number of rows in matrix
[in]	n_col	magma_int_t* number of columns in matrix
[in]	nnz	magma_int_t* number of nonzeros in matrix
[in]	val	magmaFloatComplex** value array of CSR
[in]	row	magma_index_t** row pointer of CSR
[in]	col	magma_index_t** column indices of CSR
[in]	MajorType	magma_index_t Row or Column sort default: 0 = RowMajor, 1 = ColMajor
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cprint_matrix	(	magma_c_matrix	A,
		magma_queue_t	queue
	)

Prints a sparse matrix in CSR format.

Parameters

[in]	A	magma_c_matrix sparse matrix in Magma_CSR format
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cprint_vector	(	magma_c_matrix	x,
		magma_int_t	offset,
		magma_int_t	visulen,
		magma_queue_t	queue
	)

Visualizes part of a vector of type magma_c_matrix.

With input vector x , offset, visulen, the entries offset - (offset + visulen) of x are visualized.

Parameters

[in]	x	magma_c_matrix vector to visualize
[in]	offset	magma_int_t start inex of visualization
[in]	visulen	magma_int_t number of entries to visualize
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cresidual	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix	x,
		float *	res,
		magma_queue_t	queue
	)

Computes the residual ||b-Ax|| for a solution approximation x.

Parameters

[in]	A	magma_c_matrix input matrix A
[in]	b	magma_c_matrix RHS b
[in]	x	magma_c_matrix solution approximation
[out]	res	magmaFloatComplex* return residual
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cresidual_slice	(	magma_int_t	start,
		magma_int_t	end,
		magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix	x,
		float *	res,
		magma_queue_t	queue
	)

Computes the residual r=||b-Ax|| for the slice r(start:end) for a solution approximation x.

Parameters

[in]	start	magma_int_t start of slice (row-index)
[in]	end	magma_int_t end of slice (row-index)
[in]	A	magma_c_matrix input matrix A
[in]	b	magma_c_matrix RHS b
[in]	x	magma_c_matrix solution approximation
[out]	res	magmaFloatComplex* return residual
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cresidualvec	(	magma_c_matrix	A,
		magma_c_matrix	b,
		magma_c_matrix	x,
		magma_c_matrix *	r,
		float *	res,
		magma_queue_t	queue
	)

Computes the residual r = b-Ax for a solution approximation x.

It returns both, the actual residual and the residual vector

Parameters

[in]	A	magma_c_matrix input matrix A
[in]	b	magma_c_matrix RHS b
[in]	x	magma_c_matrix solution approximation
[in,out]	r	magma_c_matrix* residual vector
[out]	res	magmaFloatComplex* return residual
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_crowentries	(	magma_c_matrix *	A,
		magma_queue_t	queue
	)

Checks the maximal number of nonzeros in a row of matrix A.

Inserts the data into max_nnz_row.

Parameters

[in,out]	A	magma_c_matrix* sparse matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_csolverinfo	(	magma_c_solver_par *	solver_par,
		magma_c_preconditioner *	precond_par,
		magma_queue_t	queue
	)

Prints information about a previously called solver.

Parameters

[in]	solver_par	magma_c_solver_par* structure containing all solver information
[in,out]	precond_par	magma_c_preconditioner* structure containing all preconditioner information
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_csolverinfo_free	(	magma_c_solver_par *	solver_par,
		magma_c_preconditioner *	precond_par,
		magma_queue_t	queue
	)

Frees any memory assocoiated with the verbose mode of solver_par.

The other values are set to default.

Parameters

[in,out]	solver_par	magma_c_solver_par* structure containing all solver information
[in,out]	precond_par	magma_c_preconditioner* structure containing all preconditioner information
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_csolverinfo_init	(	magma_c_solver_par *	solver_par,
		magma_c_preconditioner *	precond_par,
		magma_queue_t	queue
	)

Initializes all solver and preconditioner parameters.

Parameters

[in,out]	solver_par	magma_c_solver_par* structure containing all solver information
[in,out]	precond_par	magma_c_preconditioner* structure containing all preconditioner information
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_csort	(	magmaFloatComplex *	x,
		magma_int_t	first,
		magma_int_t	last,
		magma_queue_t	queue
	)

Sorts an array of values in increasing order.

Parameters

[in,out]	x	magmaFloatComplex* array to sort
[in]	first	magma_int_t pointer to first element
[in]	last	magma_int_t pointer to last element
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_csymbilu	(	magma_c_matrix *	A,
		magma_int_t	levels,
		magma_c_matrix *	L,
		magma_c_matrix *	U,
		magma_queue_t	queue
	)

This routine performs a symbolic ILU factorization.

The algorithm is taken from an implementation written by Edmond Chow.

Parameters

[in,out]	A	magma_c_matrix* matrix in magma sparse matrix format containing the original matrix on input, and L,U on output
[in]	levels	magma_magma_int_t_t fill in level
[out]	L	magma_c_matrix* output lower triangular matrix in magma sparse matrix format empty on function call
[out]	U	magma_c_matrix* output upper triangular matrix in magma sparse matrix format empty on function call
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvget	(	magma_c_matrix	v,
		magma_int_t *	m,
		magma_int_t *	n,
		magmaFloatComplex **	val,
		magma_queue_t	queue
	)

Passes a MAGMA vector back.

Parameters

[in]	v	magma_c_matrix magma vector
[out]	m	magma_int_t number of rows
[out]	n	magma_int_t number of columns
[out]	val	magmaFloatComplex* array containing vector entries
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvget_dev	(	magma_c_matrix	v,
		magma_int_t *	m,
		magma_int_t *	n,
		magmaFloatComplex_ptr *	val,
		magma_queue_t	queue
	)

Passes a MAGMA vector back (located on DEV).

Parameters

[in]	v	magma_c_matrix magma vector
[out]	m	magma_int_t number of rows
[out]	n	magma_int_t number of columns
[out]	val	magmaFloatComplex_ptr array containing vector entries
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvinit	(	magma_c_matrix *	x,
		magma_location_t	mem_loc,
		magma_int_t	num_rows,
		magma_int_t	num_cols,
		magmaFloatComplex	values,
		magma_queue_t	queue
	)

Allocates memory for magma_c_matrix and initializes it with the passed value.

Parameters

[out]	x	magma_c_matrix* vector to initialize
[in]	mem_loc	magma_location_t memory for vector
[in]	num_rows	magma_int_t desired length of vector
[in]	num_cols	magma_int_t desired width of vector-block (columns of dense matrix)
[in]	values	magmaFloatComplex entries in vector
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvread	(	magma_c_matrix *	x,
		magma_int_t	length,
		char *	filename,
		magma_queue_t	queue
	)

Reads in a float vector of length "length".

Parameters

[out]	x	magma_c_matrix * vector to read in
[in]	length	magma_int_t length of vector
[in]	filename	char* file where vector is stored
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvset	(	magma_int_t	m,
		magma_int_t	n,
		magmaFloatComplex *	val,
		magma_c_matrix *	v,
		magma_queue_t	queue
	)

Passes a vector to MAGMA.

Parameters

[in]	m	magma_int_t number of rows
[in]	n	magma_int_t number of columns
[in]	val	magmaFloatComplex* array containing vector entries
[out]	v	magma_c_matrix* magma vector
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvset_dev	(	magma_int_t	m,
		magma_int_t	n,
		magmaFloatComplex_ptr	val,
		magma_c_matrix *	v,
		magma_queue_t	queue
	)

Passes a vector to MAGMA (located on DEV).

Parameters

[in]	m	magma_int_t number of rows
[in]	n	magma_int_t number of columns
[in]	val	magmaFloatComplex_ptr array containing vector entries
[out]	v	magma_c_matrix* magma vector
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvspread	(	magma_c_matrix *	x,
		const char *	filename,
		magma_queue_t	queue
	)

Reads in a sparse vector-block stored in COO format.

Parameters

[out]	x	magma_c_matrix * vector to read in
[in]	filename	char* file where vector is stored
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cvtranspose	(	magma_c_matrix	x,
		magma_c_matrix *	y,
		magma_queue_t	queue
	)

Transposes a vector from col to row major and vice versa.

Parameters

[in]	x	magma_c_matrix input vector
[out]	y	magma_c_matrix* output vector
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_cwrite_csr_mtx	(	magma_c_matrix	A,
		magma_order_t	MajorType,
		const char *	filename,
		magma_queue_t	queue
	)

Writes a CSR matrix to a file using Matrix Market format.

Parameters

[in]	A	magma_c_matrix matrix to write out
[in]	MajorType	magma_index_t Row or Column sort default: 0 = RowMajor, 1 = ColMajor TODO: use named constants (e.g., MagmaRowMajor), not numbers.
[in]	filename	const char* output-filname of the mtx matrix
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_sparse_matrix_clag2z	(	magma_c_sparse_matrix	A,
		magma_z_matrix *	B,
		magma_queue_t	queue
	)

convertes magma_c_sparse_matrix from C to Z

Parameters

	A	magma_c_sparse_matrix input matrix descriptor
	B	magma_z_matrix* output matrix descriptor
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t magma_vector_clag2z	(	magma_c_vector	x,
		magma_z_matrix *	y,
		magma_queue_t	queue
	)

convertes magma_c_vector from C to Z

Parameters

[in]	x	magma_c_vector input vector descriptor
[out]	y	magma_z_matrix* output vector descriptor
[in]	queue	magma_queue_t Queue to execute in.

magma_int_t read_c_csr_from_mtx	(	magma_storage_t *	type,
		magma_location_t *	location,
		magma_int_t *	n_row,
		magma_int_t *	n_col,
		magma_int_t *	nnz,
		magmaFloatComplex **	val,
		magma_index_t **	row,
		magma_index_t **	col,
		const char *	filename,
		magma_queue_t	queue
	)

Reads in a matrix stored in coo format from a Matrix Market (.mtx) file and converts it into CSR format.

It duplicates the off-diagonal entries in the symmetric case.

Parameters

[out]	type	magma_storage_t* storage type of matrix
[out]	location	magma_location_t* location of matrix
[out]	n_row	magma_int_t* number of rows in matrix
[out]	n_col	magma_int_t* number of columns in matrix
[out]	nnz	magma_int_t* number of nonzeros in matrix
[out]	val	magmaFloatComplex** value array of CSR output
[out]	row	magma_index_t** row pointer of CSR output
[out]	col	magma_index_t** column indices of CSR output
[in]	filename	const char* filname of the mtx matrix
[in]	queue	magma_queue_t Queue to execute in.