rocsolver_sgetrs_batched Interface Reference

rocsolver_sgetrs_batched Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_sgetrs_batched Interface Reference
hipfort_rocsolver::rocsolver_sgetrs_batched Interface Reference

The GETRS_BATCHED functions solve a batch of systems of n linear equations on n variables in its factorized forms. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocsolver_sgetrs_batched_ (handle, trans, n, nrhs, a, lda, ipiv, stridep, b, ldb, batch_count)
 
integer(kind(rocblas_status_success)) function rocsolver_sgetrs_batched_rank_0 (handle, trans, n, nrhs, a, lda, ipiv, stridep, b, ldb, batch_count)
 
integer(kind(rocblas_status_success)) function rocsolver_sgetrs_batched_rank_1 (handle, trans, n, nrhs, a, lda, ipiv, stridep, b, ldb, batch_count)
 

Detailed Description

The GETRS_BATCHED functions solve a batch of systems of n linear equations on n variables in its factorized forms.

For each instance l in the batch, it solves one of the following systems, depending on the value of trans:

\[ \begin{array}{cl} A_l X_l = B_l & \: \text{not transposed,}\\% A_l^T X_l^{} = B_l^{} & \: \text{transposed, or}\\% A_l^H X_l^{} = B_l^{} & \: \text{conjugate transposed.} \end{array} \]

Matrix \(A_l\) is defined by its triangular factors as returned by GETRF_BATCHED.

Parameters
[in]handle- rocblas_handle.
[in]trans- rocblas_operation. Specifies the form of the system of equations of each instance in the batch.
[in]n- rocblas_int. n >= 0. The order of the system, that is, the number of columns and rows of all A_l matrices.
[in]nrhs- rocblas_int. nrhs >= 0. The number of right hand sides, that is, the number of columns of all the matrices B_l.
[in]A- Array of pointers to type. Each pointer points to an array on the GPU of dimension lda*n. The factors L_l and U_l of the factorization A_l = P_l*L_l*U_l returned by GETRF_BATCHED.
[in]lda- rocblas_int. lda >= n. The leading dimension of matrices A_l.
[in]ipiv- pointer to rocblas_int. Array on the GPU (the size depends on the value of strideP). Contains the vectors ipiv_l of pivot indices returned by GETRF_BATCHED.
[in]strideP- rocblas_stride. Stride from the start of one vector ipiv_l to the next one ipiv_(l+1). There is no restriction for the value of strideP. The 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_l. On exit, the solution matrix X_l of each system in the batch.
[in]ldb- rocblas_int. ldb >= n. The leading dimension of matrices B_l.
[in]batch_count- rocblas_int. batch_count >= 0. Number of instances (systems) in the batch.

Member Function/Subroutine Documentation

◆ rocsolver_sgetrs_batched_()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_sgetrs_batched::rocsolver_sgetrs_batched_ ( type(c_ptr), value  handle,
integer(kind(rocblas_operation_none)), value  trans,
integer(c_int), value  n,
integer(c_int), value  nrhs,
type(c_ptr), value  a,
integer(c_int), value  lda,
type(c_ptr), value  ipiv,
integer(c_int64_t), value  stridep,
type(c_ptr), value  b,
integer(c_int), value  ldb,
integer(c_int), value  batch_count 
)

◆ rocsolver_sgetrs_batched_rank_0()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_sgetrs_batched::rocsolver_sgetrs_batched_rank_0 ( type(c_ptr)  handle,
integer(kind(rocblas_operation_none))  trans,
integer(c_int)  n,
integer(c_int)  nrhs,
type(c_ptr)  a,
integer(c_int)  lda,
integer(c_int), target  ipiv,
integer(c_int64_t)  stridep,
type(c_ptr)  b,
integer(c_int)  ldb,
integer(c_int)  batch_count 
)

◆ rocsolver_sgetrs_batched_rank_1()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_sgetrs_batched::rocsolver_sgetrs_batched_rank_1 ( type(c_ptr)  handle,
integer(kind(rocblas_operation_none))  trans,
integer(c_int)  n,
integer(c_int)  nrhs,
type(c_ptr)  a,
integer(c_int)  lda,
integer(c_int), dimension(:), target  ipiv,
integer(c_int64_t)  stridep,
type(c_ptr)  b,
integer(c_int)  ldb,
integer(c_int)  batch_count 
)

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