rocblas_rot_strided_batched_ex Interface Reference

rocblas_rot_strided_batched_ex Interface Reference#

HIPFORT API Reference: hipfort_rocblas::rocblas_rot_strided_batched_ex Interface Reference
hipfort_rocblas::rocblas_rot_strided_batched_ex Interface Reference

BLAS Level 1 API. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocblas_rot_strided_batched_ex_ (handle, n, x, x_type, incx, stride_x, y, y_type, incy, stride_y, c, s, cs_type, batch_count, execution_type)
 

Detailed Description

BLAS Level 1 API.

rot_strided_batched_ex applies the Givens rotation matrix defined by c=cos(alpha) and s=sin(alpha) to strided batched vectors x_i and y_i, for i = 1, ..., batch_count. Scalars c and s may be stored in either host or device memory, location is specified by calling rocblas_set_pointer_mode.

In the case where cs_type is real: x := c * x + s * y y := c * y - s * x

In the case where cs_type is complex, the imaginary part of c is ignored: x := real(c) * x + s * y y := real(c) * y - conj(s) * x

Currently supported datatypes are as follows:


x_type y_type cs_type execution_type
bf16_r bf16_r bf16_r f32_r
f16_r f16_r f16_r f32_r
f32_r f32_r f32_r f32_r
f64_r f64_r f64_r f64_r
f32_c f32_c f32_c f32_c
f32_c f32_c f32_r f32_c
f64_c f64_c f64_c f64_c
f64_c f64_c f64_r f64_c

Parameters
[in]handle[rocblas_handle] handle to the rocblas library context queue.
[in]n[rocblas_int] number of elements in each x_i and y_i vectors.
[in,out]xdevice pointer to the first vector x_1.
[in]x_type[rocblas_datatype] specifies the datatype of each vector x_i.
[in]incx[rocblas_int] specifies the increment between elements of each x_i.
[in]stride_x[rocblas_stride] specifies the increment from the beginning of x_i to the beginning of x_(i+1)
[in,out]ydevice pointer to the first vector y_1.
[in]y_type[rocblas_datatype] specifies the datatype of each vector y_i.
[in]incy[rocblas_int] specifies the increment between elements of each y_i.
[in]stride_y[rocblas_stride] specifies the increment from the beginning of y_i to the beginning of y_(i+1)
[in]cdevice pointer or host pointer to scalar cosine component of the rotation matrix.
[in]sdevice pointer or host pointer to scalar sine component of the rotation matrix.
[in]cs_type[rocblas_datatype] specifies the datatype of c and s.
[in]batch_count[rocblas_int] the number of x and y arrays, i.e. the number of batches.
[in]execution_type[rocblas_datatype] specifies the datatype of computation.

Member Function/Subroutine Documentation

◆ rocblas_rot_strided_batched_ex_()

integer(kind(rocblas_status_success)) function hipfort_rocblas::rocblas_rot_strided_batched_ex::rocblas_rot_strided_batched_ex_ ( type(c_ptr), value  handle,
integer(c_int), value  n,
type(c_ptr), value  x,
integer(kind(rocblas_datatype_f16_r)), value  x_type,
integer(c_int), value  incx,
integer(c_int64_t), value  stride_x,
type(c_ptr), value  y,
integer(kind(rocblas_datatype_f16_r)), value  y_type,
integer(c_int), value  incy,
integer(c_int64_t), value  stride_y,
type(c_ptr), value  c,
type(c_ptr), value  s,
integer(kind(rocblas_datatype_f16_r)), value  cs_type,
integer(c_int), value  batch_count,
integer(kind(rocblas_datatype_f16_r)), value  execution_type 
)

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