hipblasssprbatched Interface Reference

hipblasssprbatched Interface Reference#

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

BLAS Level 2 API. More...

Public Member Functions

integer(kind(hipblas_status_success)) function hipblasssprbatched_ (handle, uplo, n, alpha, x, incx, ap, batchcount)
 

Detailed Description

BLAS Level 2 API.

The sprBatched functions perform the matrix-vector operations: 

A_i := A_i + alpha*x_i*x_i**T

where alpha is a scalar, x_i is a vector, and A_i is an n by n symmetric matrix, supplied in packed form, for i = 1, ..., batchCount.

  • Supported precisions in rocBLAS : s, d, c, and z.
  • Supported precisions in cuBLAS : No support.
Parameters
[in]handle- [hipblasHandle_t] handle to the hipBLAS library context queue.
[in]uplo- [hipblasFillMode_t] specifies either upper (HIPBLAS_FILL_MODE_UPPER) or lower (HIPBLAS_FILL_MODE_LOWER):
  • HIPBLAS_FILL_MODE_UPPER: The upper triangular part of each A_i is supplied in AP.
  • HIPBLAS_FILL_MODE_LOWER: The lower triangular part of each A_i is supplied in AP.
[in]n- [int] the number of rows and columns of each matrix A_i. Must be at least 0.
[in]alphadevice pointer or host pointer to scalar alpha.
[in]x- device array of device pointers storing each vector x_i.
[in]incx- [int] specifies the increment for the elements of each x_i.
[in,out]AP- device array of device pointers storing the packed version of the specified triangular portion of each symmetric matrix A_i of at least size ((n * (n + 1)) / 2). Array is of at least size batchCount.
  • if uplo == HIPBLAS_FILL_MODE_UPPER: The upper triangular portion of each symmetric matrix A_i is supplied. The matrix is compacted so that AP contains the triangular portion column-by-column so that: AP(0) = A(0,0) AP(1) = A(0,1) AP(2) = A(1,1), and so forth. Ex: (HIPBLAS_FILL_MODE_UPPER; n = 4) 1 2 4 7 2 3 5 8 -> [1, 2, 3, 4, 5, 6, 7, 8, 9, 0] 4 5 6 9 7 8 9 0
  • if uplo == HIPBLAS_FILL_MODE_LOWER: The lower triangular portion of each symmetric matrix A_i is supplied. The matrix is compacted so that AP contains the triangular portion column-by-column so that: AP(0) = A(0,0) AP(1) = A(1,0) AP(2) = A(2,1), and so forth. Ex: (HIPBLAS_FILL_MODE_LOWER; n = 4) 1 2 3 4 2 5 6 7 -> [1, 2, 3, 4, 5, 6, 7, 8, 9, 0] 3 6 8 9 4 7 9 0
[in]batchCount- [int] number of instances in the batch.

Member Function/Subroutine Documentation

◆ hipblasssprbatched_()

integer(kind(hipblas_status_success)) function hipfort_hipblas::hipblasssprbatched::hipblasssprbatched_ ( type(c_ptr), value  handle,
integer(kind(hipblas_fill_mode_upper)), value  uplo,
integer(c_int), value  n,
real(c_float)  alpha,
type(c_ptr), value  x,
integer(c_int), value  incx,
type(c_ptr), value  ap,
integer(c_int), value  batchcount 
)
The documentation for this interface was generated from the following file: