rocblas_sspr2_strided_batched Interface Reference

rocblas_sspr2_strided_batched Interface Reference#

HIPFORT API Reference: hipfort_rocblas::rocblas_sspr2_strided_batched Interface Reference
Public Member Functions | List of all members
hipfort_rocblas::rocblas_sspr2_strided_batched Interface Reference

BLAS Level 2 API. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocblas_sspr2_strided_batched_ (handle, uplo, n, alpha, x, incx, stride_x, y, incy, stride_y, ap, stride_a, batch_count)
 
integer(kind(rocblas_status_success)) function rocblas_sspr2_strided_batched_rank_0 (handle, uplo, n, alpha, x, incx, stride_x, y, incy, stride_y, ap, stride_a, batch_count)
 
integer(kind(rocblas_status_success)) function rocblas_sspr2_strided_batched_rank_1 (handle, uplo, n, alpha, x, incx, stride_x, y, incy, stride_y, ap, stride_a, batch_count)
 

Detailed Description

BLAS Level 2 API.

The spr2_strided_batched functions perform the matrix-vector operation: 

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

where alpha is a scalar, x_i and y_i are vectors, and A_i is an n by n symmetric matrix, supplied in packed form, for i = 1, ..., batch_count.

Parameters
[in]handle- [rocblas_handle] handle to the rocBLAS library context queue.
[in]uplo- [rocblas_fill] specifies either upper (rocblas_fill_upper) or lower (rocblas_fill_lower).
  • rocblas_fill_upper: The upper triangular part of each A_i is supplied in AP.
  • rocblas_fill_lower: The lower triangular part of each A_i is supplied in AP.
[in]n- [rocblas_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 pointer pointing to the first vector (x_1).
[in]incx- [rocblas_int] specifies the increment for the elements of each x_i.
[in]stride_x- [rocblas_stride] stride from the start of one vector (x_i) to the next one (x_i+1).
[in]y- device pointer pointing to the first vector (y_1).
[in]incy- [rocblas_int] specifies the increment for the elements of each y_i.
[in]stride_y- [rocblas_stride] stride from the start of one vector (y_i) to the next one (y_i+1).
[in,out]AP- device pointer storing the packed version of the specified triangular portion of each symmetric matrix A_i. Points to the first A_1. 
  if uplo == rocblas_fill_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), etc.
          Ex: (rocblas_fill_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 == rocblas_fill_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(n) = A(2,1), etc.
          Ex: (rocblas_fill_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]stride_A- [rocblas_stride] stride from the start of one (A_i) to the next (A_i+1).
[in]batch_count- [rocblas_int] number of instances in the batch.

Member Function/Subroutine Documentation

◆ rocblas_sspr2_strided_batched_()

integer(kind(rocblas_status_success)) function hipfort_rocblas::rocblas_sspr2_strided_batched::rocblas_sspr2_strided_batched_ ( type(c_ptr), value  handle,
integer(kind(rocblas_fill_upper)), value  uplo,
integer(c_int), value  n,
real(c_float)  alpha,
type(c_ptr), value  x,
integer(c_int), value  incx,
integer(c_int64_t), value  stride_x,
type(c_ptr), value  y,
integer(c_int), value  incy,
integer(c_int64_t), value  stride_y,
type(c_ptr), value  ap,
integer(c_int64_t), value  stride_a,
integer(c_int), value  batch_count 
)

◆ rocblas_sspr2_strided_batched_rank_0()

integer(kind(rocblas_status_success)) function hipfort_rocblas::rocblas_sspr2_strided_batched::rocblas_sspr2_strided_batched_rank_0 ( type(c_ptr)  handle,
integer(kind(rocblas_fill_upper))  uplo,
integer(c_int)  n,
real(c_float)  alpha,
real(c_float), target  x,
integer(c_int)  incx,
integer(c_int64_t)  stride_x,
real(c_float), target  y,
integer(c_int)  incy,
integer(c_int64_t)  stride_y,
real(c_float), target  ap,
integer(c_int64_t)  stride_a,
integer(c_int)  batch_count 
)

◆ rocblas_sspr2_strided_batched_rank_1()

integer(kind(rocblas_status_success)) function hipfort_rocblas::rocblas_sspr2_strided_batched::rocblas_sspr2_strided_batched_rank_1 ( type(c_ptr)  handle,
integer(kind(rocblas_fill_upper))  uplo,
integer(c_int)  n,
real(c_float)  alpha,
real(c_float), dimension(:), target  x,
integer(c_int)  incx,
integer(c_int64_t)  stride_x,
real(c_float), dimension(:), target  y,
integer(c_int)  incy,
integer(c_int64_t)  stride_y,
real(c_float), dimension(:), target  ap,
integer(c_int64_t)  stride_a,
integer(c_int)  batch_count 
)
The documentation for this interface was generated from the following file: