hipblaschemm Interface Reference

hipblaschemm Interface Reference#

HIPFORT API Reference: hipfort_hipblas::hipblaschemm Interface Reference
hipfort_hipblas::hipblaschemm Interface Reference

BLAS Level 3 API. More...

Public Member Functions

integer(kind(hipblas_status_success)) function hipblaschemm_ (handle, side, uplo, n, k, alpha, ap, lda, bp, ldb, beta, cp, ldc)
 
integer(kind(hipblas_status_success)) function hipblaschemm_rank_0 (handle, side, uplo, n, k, alpha, ap, lda, bp, ldb, beta, cp, ldc)
 
integer(kind(hipblas_status_success)) function hipblaschemm_rank_1 (handle, side, uplo, n, k, alpha, ap, lda, bp, ldb, beta, cp, ldc)
 
integer(kind(hipblas_status_success)) function hipblaschemm_full_rank (handle, side, uplo, n, k, alpha, ap, lda, bp, ldb, beta, cp, ldc)
 

Detailed Description

BLAS Level 3 API.

The hemm functions perform one of the matrix-matrix operations:

C := alpha*A*B + beta*C if side == HIPBLAS_SIDE_LEFT,
C := alpha*B*A + beta*C if side == HIPBLAS_SIDE_RIGHT,

where alpha and beta are scalars, B and C are m by n matrices, and A is a Hermitian matrix stored as either upper or lower.

  • Supported precisions in rocBLAS : c and z.
  • Supported precisions in cuBLAS : c and z.
Parameters
[in]handle- [hipblasHandle_t] handle to the hipBLAS library context queue.
[in]side- [hipblasSideMode_t]
  • HIPBLAS_SIDE_LEFT: C := alpha*A*B + beta*C
  • HIPBLAS_SIDE_RIGHT: C := alpha*B*A + beta*C
[in]uplo- [hipblasFillMode_t]
  • HIPBLAS_FILL_MODE_UPPER: A is an upper triangular matrix.
  • HIPBLAS_FILL_MODE_LOWER: A is a lower triangular matrix.
[in]n- [int] n specifies the number of rows of B and C. n >= 0.
[in]k- [int] n specifies the number of columns of B and C. k >= 0.
[in]alphaalpha specifies the scalar alpha. When alpha is zero, then A and B are not referenced.
[in]AP- pointer storing matrix A on the GPU.
  • A is m by m if side == HIPBLAS_SIDE_LEFT.
  • A 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. If side = HIPBLAS_SIDE_LEFT, lda >= max( 1, m ). Otherwise, lda >= max( 1, n ).
[in]BP- pointer storing matrix B on the GPU. Matrix dimension is m by n.
[in]ldb- [int] ldb specifies the first dimension of B. ldb >= max( 1, m ).
[in]betabeta specifies the scalar beta. When beta is zero, then C does not need to be set before entry.
[in]CP- pointer storing matrix C on the GPU. Matrix dimension is m by n.
[in]ldc- [int] ldc specifies the first dimension of C. ldc >= max( 1, m ).

Member Function/Subroutine Documentation

◆ hipblaschemm_()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblaschemm::hipblaschemm_ ( 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 
)

◆ hipblaschemm_full_rank()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblaschemm::hipblaschemm_full_rank ( type(c_ptr)  handle,
integer(kind(hipblas_side_left))  side,
integer(kind(hipblas_fill_mode_upper))  uplo,
integer(c_int)  n,
integer(c_int)  k,
complex(c_float_complex)  alpha,
complex(c_float_complex), dimension(:,:), target  ap,
integer(c_int)  lda,
complex(c_float_complex), dimension(:,:), target  bp,
integer(c_int)  ldb,
complex(c_float_complex)  beta,
complex(c_float_complex), dimension(:,:), target  cp,
integer(c_int)  ldc 
)

◆ hipblaschemm_rank_0()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblaschemm::hipblaschemm_rank_0 ( type(c_ptr)  handle,
integer(kind(hipblas_side_left))  side,
integer(kind(hipblas_fill_mode_upper))  uplo,
integer(c_int)  n,
integer(c_int)  k,
complex(c_float_complex)  alpha,
complex(c_float_complex), target  ap,
integer(c_int)  lda,
complex(c_float_complex), target  bp,
integer(c_int)  ldb,
complex(c_float_complex)  beta,
complex(c_float_complex), target  cp,
integer(c_int)  ldc 
)

◆ hipblaschemm_rank_1()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblaschemm::hipblaschemm_rank_1 ( type(c_ptr)  handle,
integer(kind(hipblas_side_left))  side,
integer(kind(hipblas_fill_mode_upper))  uplo,
integer(c_int)  n,
integer(c_int)  k,
complex(c_float_complex)  alpha,
complex(c_float_complex), dimension(:), target  ap,
integer(c_int)  lda,
complex(c_float_complex), dimension(:), target  bp,
integer(c_int)  ldb,
complex(c_float_complex)  beta,
complex(c_float_complex), dimension(:), target  cp,
integer(c_int)  ldc 
)

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