This page contains proposed changes for a future release of ROCm. Read the latest Linux release of ROCm documentation for your production environments.

rocblas_rot_ex Interface Reference

rocblas_rot_ex Interface Reference#

HIPFORT API Reference: hipfort_rocblas::rocblas_rot_ex Interface Reference
hipfort_rocblas::rocblas_rot_ex Interface Reference

BLAS EX API. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocblas_rot_ex_ (handle, n, x, x_type, incx, y, y_type, incy, c, s, cs_type, execution_type)
 

Detailed Description

BLAS EX API.

rot_ex applies the Givens rotation matrix defined by c=cos(alpha) and s=sin(alpha) to vectors x and y. 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 the x and y vectors.
[in,out]xdevice pointer storing vector x.
[in]x_type[rocblas_datatype] specifies the datatype of vector x.
[in]incx[rocblas_int] specifies the increment between elements of x.
[in,out]ydevice pointer storing vector y.
[in]y_type[rocblas_datatype] specifies the datatype of vector y.
[in]incy[rocblas_int] specifies the increment between elements of y.
[in]cdevice pointer or host pointer storing scalar cosine component of the rotation matrix.
[in]sdevice pointer or host pointer storing scalar sine component of the rotation matrix.
[in]cs_type[rocblas_datatype] specifies the datatype of c and s.
[in]execution_type[rocblas_datatype] specifies the datatype of computation.

Member Function/Subroutine Documentation

◆ rocblas_rot_ex_()

integer(kind(rocblas_status_success)) function hipfort_rocblas::rocblas_rot_ex::rocblas_rot_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,
type(c_ptr), value  y,
integer(kind(rocblas_datatype_f16_r)), value  y_type,
integer(c_int), value  incy,
type(c_ptr), value  c,
type(c_ptr), value  s,
integer(kind(rocblas_datatype_f16_r)), value  cs_type,
integer(kind(rocblas_datatype_f16_r)), value  execution_type 
)

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