rocsolver_sgesv_batched Interface Reference

rocsolver_sgesv_batched Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_sgesv_batched Interface Reference

GESV_BATCHED solves a batch of general systems of n linear equations on n variables. More...

Public Member Functions
integer(kind(rocblas_status_success)) function	rocsolver_sgesv_batched_ (handle, n, nrhs, A, lda, ipiv, strideP, B, ldb, myInfo, batch_count)

integer(kind(rocblas_status_success)) function	rocsolver_sgesv_batched_full_rank (handle, n, nrhs, A, lda, ipiv, strideP, B, ldb, myInfo, batch_count)

integer(kind(rocblas_status_success)) function	rocsolver_sgesv_batched_rank_0 (handle, n, nrhs, A, lda, ipiv, strideP, B, ldb, myInfo, batch_count)

integer(kind(rocblas_status_success)) function	rocsolver_sgesv_batched_rank_1 (handle, n, nrhs, A, lda, ipiv, strideP, B, ldb, myInfo, batch_count)

Detailed Description

GESV_BATCHED solves a batch of general systems of n linear equations on n variables.

The linear systems are of the form

\[ A_j X_j = B_j \]

where \(A_j\) is a general n-by-n matrix. Matrix \(A_j\) is first factorized in triangular factors \(L_j\) and \(U_j\) using GETRF_BATCHED; then, the solutions are computed with GETRS_BATCHED.

Parameters

[in]	handle	rocblas_handle.
[in]	n	rocblas_int. n >= 0. The order of the system, i.e. the number of columns and rows of all A_j matrices.
[in]	nrhs	rocblas_int. nrhs >= 0. The number of right hand sides, i.e., the number of columns of all the matrices B_j.
[in]	A	Array of pointers to type. Each pointer points to an array on the GPU of dimension lda*n. On entry, the matrices A_j. On exit, if info_j = 0, the factors L_j and U_j of the LU decomposition of A_j returned by GETRF_BATCHED.
[in]	lda	rocblas_int. lda >= n. The leading dimension of matrices A_j.
[out]	ipiv	pointer to rocblas_int. Array on the GPU (the size depends on the value of strideP). The vectors ipiv_j of pivot indices returned by GETRF_BATCHED.
[in]	strideP	rocblas_stride. Stride from the start of one vector ipiv_j to the next one ipiv_(j+1). There is no restriction for the value of strideP. Normal use case is strideP >= n.
[in,out]	B	Array of pointers to type. Each pointer points to an array on the GPU of dimension ldb*nrhs. On entry, the right hand side matrices B_j. On exit, the solution matrix X_j of each system in the batch.
[in]	ldb	rocblas_int. ldb >= n. The leading dimension of matrices B_j.
[out]	info	pointer to rocblas_int. Array of batch_count integers on the GPU. If info[j] = 0, successful exit for A_j. If info[i] = j > 0, U_i is singular, and the solution could not be computed. U_j[i,i] is the first zero element in the diagonal.
[in]	batch_count	rocblas_int. batch_count >= 0. Number of instances (systems) in the batch.

Member Function/Subroutine Documentation