rocsolver_scsrrf_sumlu Interface Reference

rocsolver_scsrrf_sumlu Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_scsrrf_sumlu Interface Reference

The CSRRF_SUMLU functions bundle the factors \(L\) and \(U\), associated with the LU factorization of a sparse matrix \(A\), into a single sparse matrix \(T=(L-I)+U\). More...

Public Member Functions
integer(kind(rocblas_status_success)) function	rocsolver_scsrrf_sumlu_ (handle, n, nnzl, ptrl, indl, vall, nnzu, ptru, indu, valu, ptrt, indt, valt)

Detailed Description

The CSRRF_SUMLU functions bundle the factors \(L\) and \(U\), associated with the LU factorization of a sparse matrix \(A\), into a single sparse matrix \(T=(L-I)+U\).

Factor \(L\) is a sparse lower triangular matrix with unit diagonal elements, and \(U\) is a sparse upper triangular matrix. The resulting sparse matrix \(T\) combines both sparse factors without storing the unit diagonal. In other words, the number of non-zero elements of T, nnzT, is given by nnzT = nnzL - n + nnzU.

Parameters

[in]	handle	- rocblas_handle.
[in]	n	- rocblas_int. n >= 0. The number of rows (and columns) of matrix A.
[in]	nnzL	- rocblas_int. nnzL >= n. The number of non-zero elements in L.
[in]	ptrL	- pointer to rocblas_int. Array on the GPU of dimension n+1. It contains the positions of the beginning of each row in indL and valL. The last element of ptrL is equal to nnzL.
[in]	indL	- pointer to rocblas_int. Array on the GPU of dimension nnzL. It contains the column indices of the non-zero elements of L. Indices are sorted by row and by column within each row.
[in]	valL	- pointer to type. Array on the GPU of dimension nnzL. The values of the non-zero elements of L.
[in]	nnzU	- rocblas_int. nnzU >= 0. The number of non-zero elements in U.
[in]	ptrU	- pointer to rocblas_int. Array on the GPU of dimension n+1. It contains the positions of the beginning of each row in indU and valU. The last element of ptrU is equal to nnzU.
[in]	indU	- pointer to rocblas_int. Array on the GPU of dimension nnzU. It contains the column indices of the non-zero elements of U. Indices are sorted by row and by column within each row.
[in]	valU	- pointer to type. Array on the GPU of dimension nnzU. The values of the non-zero elements of U.
[out]	ptrT	- pointer to rocblas_int. Array on the GPU of dimension n+1. It contains the positions of the beginning of each row in indT and valT. The last element of ptrT is equal to nnzT.
[out]	indT	- pointer to rocblas_int. Array on the GPU of dimension nnzT. It contains the column indices of the non-zero elements of T. Indices are sorted by row and by column within each row.
[out]	valT	- pointer to type. Array on the GPU of dimension nnzT. The values of the non-zero elements of T.

Member Function/Subroutine Documentation