hipblaschemmbatched Interface Reference

hipblaschemmbatched Interface Reference#

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

BLAS Level 3 API. More...

Public Member Functions

integer(kind(hipblas_status_success)) function hipblaschemmbatched_ (handle, side, uplo, n, k, alpha, ap, lda, bp, ldb, beta, cp, ldc, batchcount)
 

Detailed Description

BLAS Level 3 API.

The hemmBatched functions perform a batch of the matrix-matrix operations: 

C_i := alpha*A_i*B_i + beta*C_i if side == HIPBLAS_SIDE_LEFT,
C_i := alpha*B_i*A_i + beta*C_i if side == HIPBLAS_SIDE_RIGHT,

where alpha and beta are scalars, B_i and C_i are m by n matrices, and A_i is a Hermitian matrix stored as either upper or lower.

  • Supported precisions in rocBLAS : c and z.
  • Supported precisions in cuBLAS : No support.
Parameters
[in]handle- [hipblasHandle_t] handle to the hipBLAS library context queue.
[in]side- [hipblasSideMode_t]
  • HIPBLAS_SIDE_LEFT: C_i := alpha*A_i*B_i + beta*C_i
  • HIPBLAS_SIDE_RIGHT: C_i := alpha*B_i*A_i + beta*C_i
[in]uplo- [hipblasFillMode_t]
  • HIPBLAS_FILL_MODE_UPPER: A_i is an upper triangular matrix.
  • HIPBLAS_FILL_MODE_LOWER: A_i is a lower triangular matrix.
[in]n- [int] n specifies the number of rows of B_i and C_i. n >= 0.
[in]k- [int] k specifies the number of columns of B_i and C_i. k >= 0.
[in]alphaalpha specifies the scalar alpha. When alpha is zero, then A_i and B_i are not referenced.
[in]AP- device array of device pointers storing each matrix A_i on the GPU.
  • A_i is m by m if side == HIPBLAS_SIDE_LEFT.
  • A_i is n by n if side == HIPBLAS_SIDE_RIGHT.
  • Only the upper/lower triangular part is accessed.
  • The imaginary component of the diagonal elements is not used.
[in]lda- [int] lda specifies the first dimension of A_i. If side = HIPBLAS_SIDE_LEFT, lda >= max( 1, m ). Otherwise, lda >= max( 1, n ).
[in]BP- device array of device pointers storing each matrix B_i on the GPU. Matrix dimension is m by n.
[in]ldb- [int] ldb specifies the first dimension of B_i. ldb >= max( 1, m ).
[in]betabeta specifies the scalar beta. When beta is zero, then C_i need not be set before entry.
[in]CP- device array of device pointers storing each matrix C_i on the GPU. Matrix dimension is m by n.
[in]ldc- [int] ldc specifies the first dimension of C_i. ldc >= max( 1, m ).
[in]batchCount- [int] number of instances in the batch.

Member Function/Subroutine Documentation

◆ hipblaschemmbatched_()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblaschemmbatched::hipblaschemmbatched_ ( type(c_ptr), value  handle,
integer(kind(hipblas_side_left)), value  side,
integer(kind(hipblas_fill_mode_upper)), value  uplo,
integer(c_int), value  n,
integer(c_int), value  k,
complex(c_float_complex)  alpha,
type(c_ptr), value  ap,
integer(c_int), value  lda,
type(c_ptr), value  bp,
integer(c_int), value  ldb,
complex(c_float_complex)  beta,
type(c_ptr), value  cp,
integer(c_int), value  ldc,
integer(c_int), value  batchcount 
)
The documentation for this interface was generated from the following file: