rocsolver_sgetrf_npvt_batched Interface Reference

rocsolver_sgetrf_npvt_batched Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_sgetrf_npvt_batched Interface Reference
hipfort_rocsolver::rocsolver_sgetrf_npvt_batched Interface Reference

The GETRF_NPVT_BATCHED functions compute the LU factorization of a batch of general m-by-n matrices without partial pivoting. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocsolver_sgetrf_npvt_batched_ (handle, m, n, a, lda, myinfo, batch_count)
 

Detailed Description

The GETRF_NPVT_BATCHED functions compute the LU factorization of a batch of general m-by-n matrices without partial pivoting.

(This is the blocked Level-3-BLAS version of the algorithm. An optimized internal implementation without rocBLAS calls could be executed with mid-size matrices if optimizations are enabled (default option). For more details, see the "rocSOLVER performance tuning" guide.)

The factorization of matrix \(A_l\) in the batch has the form

\[ A_l = L_l U_l \]

where \(L_l\) is lower triangular with unit diagonal elements (lower trapezoidal if m > n), and \(U_l\) is upper triangular (upper trapezoidal if m < n).

Note
Although this routine can offer better performance, Gaussian elimination without pivoting is not backward stable. If numerical accuracy is compromised, use GETRF_BATCHED routines instead.
Parameters
[in]handle- rocblas_handle.
[in]m- rocblas_int. m >= 0. The number of rows of all matrices A_l in the batch.
[in]n- rocblas_int. n >= 0. The number of columns of all matrices A_l in the batch.
[in,out]A- array of pointers to type. Each pointer points to an array on the GPU of dimension lda*n. On entry, the m-by-n matrices A_l to be factored. On exit, the factors L_l and U_l from the factorizations. The unit diagonal elements of L_l are not stored.
[in]lda- rocblas_int. lda >= m. Specifies the leading dimension of matrices A_l.
[out]myInfo- pointer to rocblas_int. Array of batch_count integers on the GPU. If info[l] = 0, successful exit for factorization of A_l. If info[l] = i > 0, U_l is singular. U_l[i,i] is the first zero element in the diagonal. The factorization from this point might be incomplete.
[in]batch_count- rocblas_int. batch_count >= 0. Number of matrices in the batch.

Member Function/Subroutine Documentation

◆ rocsolver_sgetrf_npvt_batched_()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_sgetrf_npvt_batched::rocsolver_sgetrf_npvt_batched_ ( type(c_ptr), value  handle,
integer(c_int), value  m,
integer(c_int), value  n,
type(c_ptr), value  a,
integer(c_int), value  lda,
type(c_ptr), value  myinfo,
integer(c_int), value  batch_count 
)

The documentation for this interface was generated from the following file: