rocsolver_scsrrf_splitlu Interface Reference

rocsolver_scsrrf_splitlu Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_scsrrf_splitlu Interface Reference

The CSRRF_SPLITLU functions split the factors \(L\) and \(U\), associated with the LU factorization of a sparse matrix \(A\), from a bundled matrix \(T=(L-I)+U\). More...

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

Detailed Description

The CSRRF_SPLITLU functions split the factors \(L\) and \(U\), associated with the LU factorization of a sparse matrix \(A\), from a bundled 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. Conceptually, on input, U is stored on the diagonal and upper part of \(T\), while the non-diagonal elements of \(L\) are stored on the strictly lower part of \(T\).

Parameters

[in]	handle	- rocblas_handle.
[in]	n	- rocblas_int. n >= 0. The number of rows (and columns) of matrix A.
[in]	nnzT	- rocblas_int. nnzT >= 0. The number of non-zero elements in T.
[in]	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.
[in]	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.
[in]	valT	- pointer to type. Array on the GPU of dimension nnzT. The values of the non-zero elements of T.
[out]	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.
[out]	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. (If nnzL is not known in advance, the size of this array could be set to nnzT + n as an upper bound.)
[out]	valL	- pointer to type. Array on the GPU of dimension nnzL. The values of the non-zero elements of L. (If nnzL is not known in advance, the size of this array could be set to nnzT + n as an upper bound.)
[out]	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.
[out]	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. (If nnzU is not known in advance, the size of this array could be set to nnzT as an upper bound.)
[out]	valU	- pointer to type. Array on the GPU of dimension nnzU. The values of the non-zero elements of U. (If nnzU is not known in advance, the size of this array could be set to nnzT as an upper bound.)

Member Function/Subroutine Documentation