2016-05-08 09:49:00 +02:00
CLBlast: API reference
================
xSWAP: Swap two vectors
-------------
2016-06-13 20:17:26 +02:00
Interchanges _n_ elements of vectors _x_ and _y_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Swap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSswap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDswap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCswap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZswap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHswap(const size_t n,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SWAP:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem x_buffer` : OpenCL buffer to store the output x vector.
* `const size_t x_offset` : The offset in elements from the start of the output x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the output x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xSCAL: Vector scaling
-------------
2016-06-13 20:17:26 +02:00
Multiplies _n_ elements of vector _x_ by a scalar constant _alpha_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Scal(const size_t n,
const T alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSscal(const size_t n,
const float alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDscal(const size_t n,
const double alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCscal(const size_t n,
const cl_float2 alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZscal(const size_t n,
const cl_double2 alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHscal(const size_t n,
const cl_half alpha,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SCAL:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `cl_mem x_buffer` : OpenCL buffer to store the output x vector.
* `const size_t x_offset` : The offset in elements from the start of the output x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the output x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xCOPY: Vector copy
-------------
2016-06-13 20:17:26 +02:00
Copies the contents of vector _x_ into vector _y_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Copy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastScopy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDcopy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCcopy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZcopy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHcopy(const size_t n,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to COPY:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xAXPY: Vector-times-constant plus vector
-------------
2016-06-13 20:17:26 +02:00
Performs the operation _y = alpha * x + y_ , in which _x_ and _y_ are vectors and _alpha_ is a scalar constant.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Axpy(const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSaxpy(const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDaxpy(const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCaxpy(const size_t n,
const cl_float2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZaxpy(const size_t n,
const cl_double2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-13 20:49:34 +02:00
StatusCode CLBlastHaxpy(const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to AXPY:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xDOT: Dot product of two vectors
-------------
2016-06-13 20:17:26 +02:00
Multiplies _n_ elements of the vectors _x_ and _y_ element-wise and accumulates the results. The sum is stored in the _dot_ buffer.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Dot(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSdot(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDdot(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHdot(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to DOT:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xDOTU: Dot product of two complex vectors
-------------
See the regular xDOT routine.
C++ API:
```
template < typename T >
StatusCode Dotu(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCdotu(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZdotu(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
Arguments to DOTU:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xDOTC: Dot product of two complex vectors, one conjugated
-------------
See the regular xDOT routine.
C++ API:
```
template < typename T >
StatusCode Dotc(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCdotc(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZdotc(const size_t n,
cl_mem dot_buffer, const size_t dot_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
Arguments to DOTC:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `cl_mem dot_buffer` : OpenCL buffer to store the output dot vector.
* `const size_t dot_offset` : The offset in elements from the start of the output dot vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xNRM2: Euclidian norm of a vector
-------------
2016-06-13 20:17:26 +02:00
Accumulates the square of _n_ elements in the _x_ vector and takes the square root. The resulting L2 norm is stored in the _nrm2_ buffer.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Nrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSnrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDnrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastScnrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDznrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHnrm2(const size_t n,
cl_mem nrm2_buffer, const size_t nrm2_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to NRM2:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem nrm2_buffer` : OpenCL buffer to store the output nrm2 vector.
* `const size_t nrm2_offset` : The offset in elements from the start of the output nrm2 vector.
* `cl_mem nrm2_buffer` : OpenCL buffer to store the output nrm2 vector.
* `const size_t nrm2_offset` : The offset in elements from the start of the output nrm2 vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xASUM: Absolute sum of values in a vector
-------------
2016-06-13 20:17:26 +02:00
Accumulates the absolute value of _n_ elements in the _x_ vector. The results are stored in the _asum_ buffer.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Asum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSasum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDasum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastScasum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDzasum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHasum(const size_t n,
cl_mem asum_buffer, const size_t asum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to ASUM:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem asum_buffer` : OpenCL buffer to store the output asum vector.
* `const size_t asum_offset` : The offset in elements from the start of the output asum vector.
* `cl_mem asum_buffer` : OpenCL buffer to store the output asum vector.
* `const size_t asum_offset` : The offset in elements from the start of the output asum vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xSUM: Sum of values in a vector (non-BLAS function)
-------------
2016-06-13 20:17:26 +02:00
Accumulates the values of _n_ elements in the _x_ vector. The results are stored in the _sum_ buffer. This routine is the non-absolute version of the xASUM BLAS routine.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Sum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastScsum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDzsum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastHsum(const size_t n,
cl_mem sum_buffer, const size_t sum_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SUM:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem sum_buffer` : OpenCL buffer to store the output sum vector.
* `const size_t sum_offset` : The offset in elements from the start of the output sum vector.
* `cl_mem sum_buffer` : OpenCL buffer to store the output sum vector.
* `const size_t sum_offset` : The offset in elements from the start of the output sum vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xAMAX: Index of absolute maximum value in a vector
-------------
2016-06-13 20:17:26 +02:00
Finds the index of the maximum of the absolute values in the _x_ vector. The resulting integer index is stored in the _imax_ buffer.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Amax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastiSamax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiDamax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiCamax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiZamax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastiHamax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to AMAX:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem imax_buffer` : OpenCL buffer to store the output imax vector.
* `const size_t imax_offset` : The offset in elements from the start of the output imax vector.
* `cl_mem imax_buffer` : OpenCL buffer to store the output imax vector.
* `const size_t imax_offset` : The offset in elements from the start of the output imax vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xMAX: Index of maximum value in a vector (non-BLAS function)
-------------
2016-06-13 20:17:26 +02:00
Finds the index of the maximum of the values in the _x_ vector. The resulting integer index is stored in the _imax_ buffer. This routine is the non-absolute version of the IxAMAX BLAS routine.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Max(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastiSmax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiDmax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiCmax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiZmax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastiHmax(const size_t n,
cl_mem imax_buffer, const size_t imax_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to MAX:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem imax_buffer` : OpenCL buffer to store the output imax vector.
* `const size_t imax_offset` : The offset in elements from the start of the output imax vector.
* `cl_mem imax_buffer` : OpenCL buffer to store the output imax vector.
* `const size_t imax_offset` : The offset in elements from the start of the output imax vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xMIN: Index of minimum value in a vector (non-BLAS function)
-------------
2016-06-13 20:17:26 +02:00
Finds the index of the minimum of the values in the _x_ vector. The resulting integer index is stored in the _imin_ buffer. This routine is the non-absolute minimum version of the IxAMAX BLAS routine.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Min(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastiSmin(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiDmin(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiCmin(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastiZmin(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 14:47:14 +02:00
StatusCode CLBlastiHmin(const size_t n,
cl_mem imin_buffer, const size_t imin_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to MIN:
2016-06-13 20:17:26 +02:00
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `cl_mem imin_buffer` : OpenCL buffer to store the output imin vector.
* `const size_t imin_offset` : The offset in elements from the start of the output imin vector.
* `cl_mem imin_buffer` : OpenCL buffer to store the output imin vector.
* `const size_t imin_offset` : The offset in elements from the start of the output imin vector.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xGEMV: General matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Performs the operation _y = alpha * A * x + beta * y_ , in which _x_ is an input vector, _y_ is an input and output vector, _A_ is an input matrix, and _alpha_ and _beta_ are scalars. The matrix _A_ can optionally be transposed before performing the operation.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Gemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSgemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const float beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDgemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const double beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCgemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_float2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZgemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_double2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHgemv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_half beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to GEMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GEMV:
* The value of `a_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xGBMV: General banded matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is banded instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Gbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSgbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const float beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDgbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const double beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCgbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_float2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZgbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_double2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHgbmv(const Layout layout, const Transpose a_transpose,
const size_t m, const size_t n, const size_t kl, const size_t ku,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_half beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to GBMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t kl` : Integer size argument. This value must be positive.
* `const size_t ku` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GBMV:
* The value of `a_ld` must be at least `kl + ku + 1` .
2016-05-08 09:49:00 +02:00
xHEMV: Hermitian matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is an Hermitian matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hemv(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChemv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_float2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhemv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_double2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
Arguments to HEMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HEMV:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xHBMV: Hermitian banded matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is an Hermitian banded matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_float2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_double2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
Arguments to HBMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HBMV:
* The value of `a_ld` must be at least `k + 1` .
2016-05-08 09:49:00 +02:00
xHPMV: Hermitian packed matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is an Hermitian packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hpmv(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChpmv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_float2 alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_float2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhpmv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_double2 alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_double2 beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
Arguments to HPMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem ap_buffer` : OpenCL buffer to store the input AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the input AP matrix.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xSYMV: Symmetric matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is symmetric instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Symv(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsymv(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const float beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsymv(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const double beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHsymv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_half beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYMV:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xSBMV: Symmetric banded matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is symmetric and banded instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Sbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const float beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const double beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHsbmv(const Layout layout, const Triangle triangle,
const size_t n, const size_t k,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_half beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SBMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SBMV:
* The value of `a_ld` must be at least `k + 1` .
2016-05-08 09:49:00 +02:00
xSPMV: Symmetric packed matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is a symmetric packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Spmv(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const T beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSspmv(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const float beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDspmv(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const double beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHspmv(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem ap_buffer, const size_t ap_offset,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_half beta,
cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SPMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem ap_buffer` : OpenCL buffer to store the input AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the input AP matrix.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem y_buffer` : OpenCL buffer to store the output y vector.
* `const size_t y_offset` : The offset in elements from the start of the output y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the output y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xTRMV: Triangular matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is triangular instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Trmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastStrmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDtrmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCtrmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZtrmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHtrmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to TRMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const Diagonal diagonal` : The property of the diagonal matrix, either `Diagonal::kNonUnit` (131) for non-unit values on the diagonal or `Diagonal::kUnit` (132) for unit values on the diagonal.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem x_buffer` : OpenCL buffer to store the output x vector.
* `const size_t x_offset` : The offset in elements from the start of the output x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the output x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for TRMV:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xTBMV: Triangular banded matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is triangular and banded instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Tbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastStbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDtbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCtbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZtbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHtbmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n, const size_t k,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to TBMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const Diagonal diagonal` : The property of the diagonal matrix, either `Diagonal::kNonUnit` (131) for non-unit values on the diagonal or `Diagonal::kUnit` (132) for unit values on the diagonal.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem x_buffer` : OpenCL buffer to store the output x vector.
* `const size_t x_offset` : The offset in elements from the start of the output x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the output x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for TBMV:
* The value of `a_ld` must be at least `k + 1` .
2016-05-08 09:49:00 +02:00
xTPMV: Triangular packed matrix-vector multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMV, but matrix _A_ is a triangular packed matrix instead and repreented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Tpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastStpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDtpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCtpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZtpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-22 15:38:26 +02:00
StatusCode CLBlastHtpmv(const Layout layout, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t n,
const cl_mem ap_buffer, const size_t ap_offset,
cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to TPMV:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const Diagonal diagonal` : The property of the diagonal matrix, either `Diagonal::kNonUnit` (131) for non-unit values on the diagonal or `Diagonal::kUnit` (132) for unit values on the diagonal.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const cl_mem ap_buffer` : OpenCL buffer to store the input AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the input AP matrix.
* `cl_mem x_buffer` : OpenCL buffer to store the output x vector.
* `const size_t x_offset` : The offset in elements from the start of the output x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the output x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xGER: General rank-1 matrix update
-------------
2016-06-13 20:17:26 +02:00
Performs the operation _A = alpha * x * y^T + A_ , in which _x_ is an input vector, _y^T_ is the transpose of the input vector _y_ , _A_ is the matrix to be updated, and _alpha_ is a scalar value.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Ger(const Layout layout,
const size_t m, const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSger(const Layout layout,
const size_t m, const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDger(const Layout layout,
const size_t m, const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-22 16:59:14 +02:00
StatusCode CLBlastHger(const Layout layout,
const size_t m, const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to GER:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GER:
* The value of `a_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xGERU: General rank-1 complex matrix update
-------------
2016-06-10 11:16:06 +02:00
Same operation as xGER, but with complex data-types.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Geru(const Layout layout,
const size_t m, const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCgeru(const Layout layout,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZgeru(const Layout layout,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to GERU:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GERU:
* The value of `a_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xGERC: General rank-1 complex conjugated matrix update
-------------
2016-06-10 11:16:06 +02:00
Same operation as xGERU, but the update is done based on the complex conjugate of the input vectors.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Gerc(const Layout layout,
const size_t m, const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCgerc(const Layout layout,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZgerc(const Layout layout,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to GERC:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GERC:
* The value of `a_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xHER: Hermitian rank-1 matrix update
-------------
2016-06-13 20:17:26 +02:00
Performs the operation _A = alpha * x * x^T + A_ , in which x is an input vector, x^T is the transpose of this vector, _A_ is the triangular Hermetian matrix to be updated, and alpha is a scalar value.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Her(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCher(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZher(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to HER:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HER:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xHPR: Hermitian packed rank-1 matrix update
-------------
2016-06-13 20:17:26 +02:00
Same operation as xHER, but matrix _A_ is an Hermitian packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hpr(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChpr(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhpr(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
Arguments to HPR:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem ap_buffer` : OpenCL buffer to store the output AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the output AP matrix.
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xHER2: Hermitian rank-2 matrix update
-------------
2016-06-13 20:17:26 +02:00
Performs the operation _A = alpha * x * y^T + conj(alpha) * y * x^T + A_ , in which _x_ is an input vector and _x^T_ its transpose, _y_ is an input vector and _y^T_ its transpose, _A_ is the triangular Hermetian matrix to be updated, _alpha_ is a scalar value and _conj(alpha)_ its complex conjugate.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Her2(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCher2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_float2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZher2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_double2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to HER2:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HER2:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xHPR2: Hermitian packed rank-2 matrix update
-------------
2016-06-13 20:17:26 +02:00
Same operation as xHER2, but matrix _A_ is an Hermitian packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hpr2(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChpr2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_float2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhpr2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_double2 alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
Arguments to HPR2:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem ap_buffer` : OpenCL buffer to store the output AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the output AP matrix.
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xSYR: Symmetric rank-1 matrix update
-------------
2016-06-10 11:16:06 +02:00
Same operation as xHER, but matrix A is a symmetric matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Syr(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsyr(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsyr(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-22 16:59:14 +02:00
StatusCode CLBlastHsyr(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYR:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYR:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xSPR: Symmetric packed rank-1 matrix update
-------------
2016-06-13 20:17:26 +02:00
Same operation as xSPR, but matrix _A_ is a symmetric packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Spr(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSspr(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDspr(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
2016-05-22 16:59:14 +02:00
StatusCode CLBlastHspr(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SPR:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem ap_buffer` : OpenCL buffer to store the output AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the output AP matrix.
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xSYR2: Symmetric rank-2 matrix update
-------------
2016-06-13 20:17:26 +02:00
Same operation as xHER2, but matrix _A_ is a symmetric matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Syr2(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsyr2(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsyr2(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-22 16:59:14 +02:00
StatusCode CLBlastHsyr2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYR2:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem a_buffer` : OpenCL buffer to store the output A matrix.
* `const size_t a_offset` : The offset in elements from the start of the output A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the output A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYR2:
* The value of `a_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xSPR2: Symmetric packed rank-2 matrix update
-------------
2016-06-13 20:17:26 +02:00
Same operation as xSPR2, but matrix _A_ is a symmetric packed matrix instead and represented as _AP_ .
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Spr2(const Layout layout, const Triangle triangle,
const size_t n,
const T alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSspr2(const Layout layout, const Triangle triangle,
const size_t n,
const float alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDspr2(const Layout layout, const Triangle triangle,
const size_t n,
const double alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
2016-05-22 16:59:14 +02:00
StatusCode CLBlastHspr2(const Layout layout, const Triangle triangle,
const size_t n,
const cl_half alpha,
const cl_mem x_buffer, const size_t x_offset, const size_t x_inc,
const cl_mem y_buffer, const size_t y_offset, const size_t y_inc,
cl_mem ap_buffer, const size_t ap_offset,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SPR2:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem x_buffer` : OpenCL buffer to store the input x vector.
* `const size_t x_offset` : The offset in elements from the start of the input x vector.
2016-06-13 20:17:26 +02:00
* `const size_t x_inc` : Stride/increment of the input x vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem y_buffer` : OpenCL buffer to store the input y vector.
* `const size_t y_offset` : The offset in elements from the start of the input y vector.
2016-06-13 20:17:26 +02:00
* `const size_t y_inc` : Stride/increment of the input y vector. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem ap_buffer` : OpenCL buffer to store the output AP matrix.
* `const size_t ap_offset` : The offset in elements from the start of the output AP matrix.
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
xGEMM: General matrix-matrix multiplication
-------------
2016-06-13 20:17:26 +02:00
Performs the matrix product _C = alpha * A * B + beta * C_ , in which _A_ (_m_ by _k_ ) and _B_ (_k_ by _n_ ) are two general rectangular input matrices, _C_ (_m_ by _n_ ) is the matrix to be updated, and _alpha_ and _beta_ are scalar values. The matrices _A_ and/or _B_ can optionally be transposed before performing the operation.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Gemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSgemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDgemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCgemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZgemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-25 13:29:53 +02:00
StatusCode CLBlastHgemm(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_half beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to GEMM:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const Transpose b_transpose` : Transposing the input matrix B, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem b_buffer` : OpenCL buffer to store the input B matrix.
* `const size_t b_offset` : The offset in elements from the start of the input B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the input B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for GEMM:
* When `transpose_a == Transpose::kNo` , then `a_ld` must be at least `m` , otherwise `a_ld` must be at least `k` .
* When `transpose_b == Transpose::kNo` , then `b_ld` must be at least `k` , otherwise `b_ld` must be at least `n` .
* The value of `c_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xSYMM: Symmetric matrix-matrix multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xGEMM, but _A_ is symmetric instead. In case of `side == kLeft` , _A_ is a symmetric _m_ by _m_ matrix and _C = alpha * A * B + beta * C_ is performed. Otherwise, in case of `side == kRight` , _A_ is a symmtric _n_ by _n_ matrix and _C = alpha * B * A + beta * C_ is performed.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Symm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsymm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsymm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCsymm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZsymm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-25 13:29:53 +02:00
StatusCode CLBlastHsymm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_half beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYMM:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Side side` : The position of the triangular matrix in the operation, either on the `Side::kLeft` (141) or `Side::kRight` (142).
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem b_buffer` : OpenCL buffer to store the input B matrix.
* `const size_t b_offset` : The offset in elements from the start of the input B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the input B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYMM:
* When `side = Side::kLeft` then `a_ld` must be at least `m` , otherwise `a_ld` must be at least `n` .
* The value of `b_ld` must be at least `m` .
* The value of `c_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xHEMM: Hermitian matrix-matrix multiplication
-------------
2016-06-13 20:17:26 +02:00
Same operation as xSYMM, but _A_ is an Hermitian matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Hemm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastChemm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZhemm(const Layout layout, const Side side, const Triangle triangle,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to HEMM:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Side side` : The position of the triangular matrix in the operation, either on the `Side::kLeft` (141) or `Side::kRight` (142).
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem b_buffer` : OpenCL buffer to store the input B matrix.
* `const size_t b_offset` : The offset in elements from the start of the input B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the input B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HEMM:
* When `side = Side::kLeft` then `a_ld` must be at least `m` , otherwise `a_ld` must be at least `n` .
* The value of `b_ld` must be at least `m` .
* The value of `c_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xSYRK: Rank-K update of a symmetric matrix
-------------
2016-06-13 20:17:26 +02:00
Performs the matrix product _C = alpha * A * A^T + beta * C_ or _C = alpha * A^T * A + beta * C_ , in which _A_ is a general matrix and _A^T_ is its transpose, _C_ (_n_ by _n_ ) is the symmetric matrix to be updated, and _alpha_ and _beta_ are scalar values.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Syrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsyrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsyrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCsyrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZsyrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-25 13:29:53 +02:00
StatusCode CLBlastHsyrk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_half beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYRK:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYRK:
* When `transpose == Transpose::kNo` , then `a_ld` must be at least `n` , otherwise `a_ld` must be at least `k` .
* The value of `c_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xHERK: Rank-K update of a hermitian matrix
-------------
2016-06-13 20:17:26 +02:00
Same operation as xSYRK, but _C_ is an Hermitian matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Herk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCherk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZherk(const Layout layout, const Triangle triangle, const Transpose a_transpose,
const size_t n, const size_t k,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to HERK:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HERK:
* When `transpose == Transpose::kNo` , then `a_ld` must be at least `n` , otherwise `a_ld` must be at least `k` .
* The value of `c_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00
xSYR2K: Rank-2K update of a symmetric matrix
-------------
2016-06-13 20:17:26 +02:00
Performs the matrix product _C = alpha * A * B^T + alpha * B * A^T + beta * C_ or _C = alpha * A^T * B + alpha * B^T * A + beta * C_ , in which _A_ and _B_ are general matrices and _A^T_ and _B^T_ are their transposed versions, _C_ (_n_ by _n_ ) is the symmetric matrix to be updated, and _alpha_ and _beta_ are scalar values.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Syr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastSsyr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDsyr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCsyr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZsyr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-25 13:29:53 +02:00
StatusCode CLBlastHsyr2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const cl_half beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to SYR2K:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose ab_transpose` : Transposing the packed input matrix AP, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem b_buffer` : OpenCL buffer to store the input B matrix.
* `const size_t b_offset` : The offset in elements from the start of the input B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the input B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const T beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for SYR2K:
* When `transpose == Transpose::kNo` , then `a_ld` must be at least `n` , otherwise `a_ld` must be at least `k` .
* When `transpose == Transpose::kNo` , then `b_ld` must be at least `n` , otherwise `b_ld` must be at least `k` .
* The value of `c_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xHER2K: Rank-2K update of a hermitian matrix
-------------
2016-06-13 20:17:26 +02:00
Same operation as xSYR2K, but _C_ is an Hermitian matrix instead.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T , typename U >
StatusCode Her2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const U beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastCher2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZher2k(const Layout layout, const Triangle triangle, const Transpose ab_transpose,
const size_t n, const size_t k,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, cl_event* event)
```
Arguments to HER2K:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose ab_transpose` : Transposing the packed input matrix AP, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const size_t n` : Integer size argument. This value must be positive.
* `const size_t k` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const cl_mem b_buffer` : OpenCL buffer to store the input B matrix.
* `const size_t b_offset` : The offset in elements from the start of the input B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the input B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `const U beta` : Input scalar constant.
* `cl_mem c_buffer` : OpenCL buffer to store the output C matrix.
* `const size_t c_offset` : The offset in elements from the start of the output C matrix.
2016-06-13 20:17:26 +02:00
* `const size_t c_ld` : Leading dimension of the output C matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for HER2K:
* When `transpose == Transpose::kNo` , then `a_ld` must be at least `n` , otherwise `a_ld` must be at least `k` .
* When `transpose == Transpose::kNo` , then `b_ld` must be at least `n` , otherwise `b_ld` must be at least `k` .
* The value of `c_ld` must be at least `n` .
2016-05-08 09:49:00 +02:00
xTRMM: Triangular matrix-matrix multiplication
-------------
2016-06-13 20:17:26 +02:00
Performs the matrix product _B = alpha * A * B_ or _B = alpha * B * A_ , in which _A_ is a unit or non-unit triangular matrix, _B_ (_m_ by _n_ ) is the general matrix to be updated, and _alpha_ is a scalar value.
2016-05-08 09:49:00 +02:00
C++ API:
```
template < typename T >
StatusCode Trmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const T alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
```
C API:
```
StatusCode CLBlastStrmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const float alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastDtrmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const double alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastCtrmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const cl_float2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
StatusCode CLBlastZtrmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const cl_double2 alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
2016-05-25 13:29:53 +02:00
StatusCode CLBlastHtrmm(const Layout layout, const Side side, const Triangle triangle, const Transpose a_transpose, const Diagonal diagonal,
const size_t m, const size_t n,
const cl_half alpha,
const cl_mem a_buffer, const size_t a_offset, const size_t a_ld,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
2016-05-08 09:49:00 +02:00
```
Arguments to TRMM:
2016-06-13 20:17:26 +02:00
* `const Layout layout` : Data-layout of the matrices, either `Layout::kRowMajor` (101) for row-major layout or `Layout::kColMajor` (102) for column-major data-layout.
* `const Side side` : The position of the triangular matrix in the operation, either on the `Side::kLeft` (141) or `Side::kRight` (142).
* `const Triangle triangle` : The part of the array of the triangular matrix to be used, either `Triangle::kUpper` (121) or `Triangle::kLower` (122).
* `const Transpose a_transpose` : Transposing the input matrix A, either `Transpose::kNo` (111), `Transpose::kYes` (112), or `Transpose::kConjugate` (113) for a complex-conjugate transpose.
* `const Diagonal diagonal` : The property of the diagonal matrix, either `Diagonal::kNonUnit` (131) for non-unit values on the diagonal or `Diagonal::kUnit` (132) for unit values on the diagonal.
* `const size_t m` : Integer size argument. This value must be positive.
* `const size_t n` : Integer size argument. This value must be positive.
2016-05-08 09:49:00 +02:00
* `const T alpha` : Input scalar constant.
* `const cl_mem a_buffer` : OpenCL buffer to store the input A matrix.
* `const size_t a_offset` : The offset in elements from the start of the input A matrix.
2016-06-13 20:17:26 +02:00
* `const size_t a_ld` : Leading dimension of the input A matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_mem b_buffer` : OpenCL buffer to store the output B matrix.
* `const size_t b_offset` : The offset in elements from the start of the output B matrix.
2016-06-13 20:17:26 +02:00
* `const size_t b_ld` : Leading dimension of the output B matrix. This value must be greater than 0.
2016-05-08 09:49:00 +02:00
* `cl_command_queue* queue` : Pointer to an OpenCL command queue associated with a context and device to execute the routine on.
* `cl_event* event` : Pointer to an OpenCL event to be able to wait for completion of the routine's OpenCL kernel(s). This is an optional argument.
2016-06-13 20:17:26 +02:00
Requirements for TRMM:
* When `side = Side::kLeft` then `a_ld` must be at least `m` , otherwise `a_ld` must be at least `n` .
* The value of `b_ld` must be at least `m` .
2016-05-08 09:49:00 +02:00