hipblassgetrsbatched Interface Reference

hipblassgetrsbatched Interface Reference#

HIPFORT API Reference: hipfort_hipblas::hipblassgetrsbatched Interface Reference
Public Member Functions | List of all members
hipfort_hipblas::hipblassgetrsbatched Interface Reference

SOLVER API. More...

Public Member Functions

integer(kind(hipblas_status_success)) function hipblassgetrsbatched_ (handle, trans, n, nrhs, a, lda, ipiv, b, ldb, myinfo, batchcount)
 

Detailed Description

SOLVER API.

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

For each instance i in the batch, they solve one of the following systems, depending on the value of trans:

\[ \begin{array}{cl} A_i X_i = B_i & \: \text{not transposed,}\\% A_i^T X_i = B_i & \: \text{transposed, or}\\% A_i^H X_i = B_i & \: \text{conjugate transposed.} \end{array} \]

Matrix \(A_i\) is defined by its triangular factors as returned by hipblasSgetrfBatched "getrfBatched".

  • Supported precisions in rocSOLVER : s, d, c, and z.
  • Supported precisions in cuBLAS : s, d, c, and z.
Parameters
[in]handle- hipblasHandle_t.
[in]trans- hipblasOperation_t. Specifies the form of the system of equations of each instance in the batch.
[in]n- int. n >= 0. The order of the system, that is, the number of columns and rows of all A_i matrices.
[in]nrhs- int. nrhs >= 0. The number of right hand sides, that is, the number of columns of all the matrices B_i.
[in]A- Array of pointers to type. Each pointer points to an array on the GPU of dimension lda*n. The factors L_i and U_i of the factorization A_i = P_i*L_i*U_i returned by hipblasSgetrfBatched "getrfBatched".
[in]lda- int. lda >= n. The leading dimension of matrices A_i.
[in]ipiv- pointer to int. Array on the GPU. Contains the vectors ipiv_i of pivot indices returned by hipblasSgetrfBatched "getrfBatched".
[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_i.
  • On exit, the solution matrix X_i of each system in the batch.
[in]ldb- int. ldb >= n. The leading dimension of matrices B_i.
[out]myInfo- pointer to a int on the host.
  • If info = 0, successful exit.
  • If info = j < 0, the argument at position -j is invalid.
[in]batchCount- int. batchCount >= 0. Number of instances (systems) in the batch.

Member Function/Subroutine Documentation

◆ hipblassgetrsbatched_()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblassgetrsbatched::hipblassgetrsbatched_ ( type(c_ptr), value  handle,
integer(kind(hipblas_op_n)), 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,
type(c_ptr), value  b,
integer(c_int), value  ldb,
type(c_ptr), value  myinfo,
integer(c_int), value  batchcount 
)
The documentation for this interface was generated from the following file: