218 KiB
CLBlast: API reference
xSWAP: Swap two vectors
Interchanges n elements of vectors x and y.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to SWAP:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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
Multiplies n elements of vector x by a scalar constant alpha.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to SCAL:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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
Copies the contents of vector x into vector y.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to COPY:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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
Performs the operation y = alpha * x + y, in which x and y are vectors and alpha is a scalar constant.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to AXPY:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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
Multiplies n elements of the vectors x and y element-wise and accumulates the results. The sum is stored in the dot buffer.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to DOT:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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:
CLBlastStatusCode 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)
CLBlastStatusCode 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:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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:
CLBlastStatusCode 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)
CLBlastStatusCode 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:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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
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.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to NRM2:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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
Accumulates the absolute value of n elements in the x vector. The results are stored in the asum buffer.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to ASUM:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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)
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.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to SUM:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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
Finds the index of the maximum of the absolute values in the x vector. The resulting integer index is stored in the imax buffer.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to AMAX:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.
xAMIN: Index of absolute minimum value in a vector (non-BLAS function)
Finds the index of the minimum of the absolute values in the x vector. The resulting integer index is stored in the imin buffer.
C++ API:
template <typename T>
StatusCode Amin(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:
CLBlastStatusCode CLBlastiSamin(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)
CLBlastStatusCode CLBlastiDamin(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)
CLBlastStatusCode CLBlastiCamin(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)
CLBlastStatusCode CLBlastiZamin(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)
CLBlastStatusCode CLBlastiHamin(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)
Arguments to AMIN:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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)
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.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to MAX:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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)
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.
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:
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
CLBlastStatusCode 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)
Arguments to MIN:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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
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.
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:
CLBlastStatusCode CLBlastSgemv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastDgemv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastCgemv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZgemv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastHgemv(const CLBlastLayout layout, const CLBlastTranspose 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)
Arguments to GEMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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 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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for GEMV:
- The value of
a_ld
must be at leastm
.
xGBMV: General banded matrix-vector multiplication
Same operation as xGEMV, but matrix A is banded instead.
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:
CLBlastStatusCode CLBlastSgbmv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastDgbmv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastCgbmv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZgbmv(const CLBlastLayout layout, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastHgbmv(const CLBlastLayout layout, const CLBlastTranspose 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)
Arguments to GBMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for GBMV:
- The value of
a_ld
must be at leastkl + ku + 1
.
xHEMV: Hermitian matrix-vector multiplication
Same operation as xGEMV, but matrix A is an Hermitian matrix instead.
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:
CLBlastStatusCode CLBlastChemv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhemv(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for HEMV:
- The value of
a_ld
must be at leastn
.
xHBMV: Hermitian banded matrix-vector multiplication
Same operation as xGEMV, but matrix A is an Hermitian banded matrix instead.
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:
CLBlastStatusCode CLBlastChbmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhbmv(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for HBMV:
- The value of
a_ld
must be at leastk + 1
.
xHPMV: Hermitian packed matrix-vector multiplication
Same operation as xGEMV, but matrix A is an Hermitian packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastChpmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhpmv(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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
Same operation as xGEMV, but matrix A is symmetric instead.
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:
CLBlastStatusCode CLBlastSsymv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDsymv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHsymv(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SYMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for SYMV:
- The value of
a_ld
must be at leastn
.
xSBMV: Symmetric banded matrix-vector multiplication
Same operation as xGEMV, but matrix A is symmetric and banded instead.
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:
CLBlastStatusCode CLBlastSsbmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDsbmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHsbmv(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SBMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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.
Requirements for SBMV:
- The value of
a_ld
must be at leastk + 1
.
xSPMV: Symmetric packed matrix-vector multiplication
Same operation as xGEMV, but matrix A is a symmetric packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastSspmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDspmv(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHspmv(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SPMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.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
Same operation as xGEMV, but matrix A is triangular instead.
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:
CLBlastStatusCode CLBlastStrmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtrmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtrmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtrmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastHtrmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TRMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::kUnit
(132) for unit values on the diagonal.const size_t n
: Integer size argument. This value must be positive.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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.
Requirements for TRMV:
- The value of
a_ld
must be at leastn
.
xTBMV: Triangular banded matrix-vector multiplication
Same operation as xGEMV, but matrix A is triangular and banded instead.
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:
CLBlastStatusCode CLBlastStbmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtbmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtbmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtbmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastHtbmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TBMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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.
Requirements for TBMV:
- The value of
a_ld
must be at leastk + 1
.
xTPMV: Triangular packed matrix-vector multiplication
Same operation as xGEMV, but matrix A is a triangular packed matrix instead and repreented as AP.
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:
CLBlastStatusCode CLBlastStpmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtpmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtpmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtpmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastHtpmv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TPMV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::kUnit
(132) for unit values on the diagonal.const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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.
xTRSV: Solves a triangular system of equations
C++ API:
template <typename T>
StatusCode Trsv(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:
CLBlastStatusCode CLBlastStrsv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtrsv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtrsv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtrsv(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TRSV:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::kUnit
(132) for unit values on the diagonal.const size_t n
: Integer size argument. This value must be positive.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t x_inc
: Stride/increment of the output x vector. This value must be greater than 0.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
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.
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:
CLBlastStatusCode CLBlastSger(const CLBlastLayout 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)
CLBlastStatusCode CLBlastDger(const CLBlastLayout 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)
CLBlastStatusCode CLBlastHger(const CLBlastLayout 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)
Arguments to GER:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::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.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for GER:
- The value of
a_ld
must be at leastm
.
xGERU: General rank-1 complex matrix update
Same operation as xGER, but with complex data-types.
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:
CLBlastStatusCode CLBlastCgeru(const CLBlastLayout 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)
CLBlastStatusCode CLBlastZgeru(const CLBlastLayout 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::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.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for GERU:
- The value of
a_ld
must be at leastm
.
xGERC: General rank-1 complex conjugated matrix update
Same operation as xGERU, but the update is done based on the complex conjugate of the input vectors.
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:
CLBlastStatusCode CLBlastCgerc(const CLBlastLayout 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)
CLBlastStatusCode CLBlastZgerc(const CLBlastLayout 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::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.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for GERC:
- The value of
a_ld
must be at leastm
.
xHER: Hermitian rank-1 matrix update
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.
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:
CLBlastStatusCode CLBlastCher(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZher(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for HER:
- The value of
a_ld
must be at leastn
.
xHPR: Hermitian packed rank-1 matrix update
Same operation as xHER, but matrix A is an Hermitian packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastChpr(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhpr(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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
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.
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:
CLBlastStatusCode CLBlastCher2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZher2(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for HER2:
- The value of
a_ld
must be at leastn
.
xHPR2: Hermitian packed rank-2 matrix update
Same operation as xHER2, but matrix A is an Hermitian packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastChpr2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhpr2(const CLBlastLayout layout, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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
Same operation as xHER, but matrix A is a symmetric matrix instead.
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:
CLBlastStatusCode CLBlastSsyr(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDsyr(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHsyr(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SYR:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for SYR:
- The value of
a_ld
must be at leastn
.
xSPR: Symmetric packed rank-1 matrix update
Same operation as xSPR, but matrix A is a symmetric packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastSspr(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDspr(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHspr(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SPR:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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
Same operation as xHER2, but matrix A is a symmetric matrix instead.
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:
CLBlastStatusCode CLBlastSsyr2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDsyr2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHsyr2(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SYR2:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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.const size_t a_ld
: Leading dimension of the output A matrix. This value must be greater than 0.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.
Requirements for SYR2:
- The value of
a_ld
must be at leastn
.
xSPR2: Symmetric packed rank-2 matrix update
Same operation as xSPR2, but matrix A is a symmetric packed matrix instead and represented as AP.
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:
CLBlastStatusCode CLBlastSspr2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDspr2(const CLBlastLayout layout, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHspr2(const CLBlastLayout layout, const CLBlastTriangle 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)
Arguments to SPR2:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.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
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.
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,
cl_mem temp_buffer = nullptr)
C API:
CLBlastStatusCode CLBlastSgemm(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastDgemm(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastCgemm(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZgemm(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastHgemm(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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)
Arguments to GEMM:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Transpose b_transpose
: Transposing the input matrix B, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for GEMM:
- When
transpose_a == Transpose::kNo
, thena_ld
must be at leastm
, otherwisea_ld
must be at leastk
. - When
transpose_b == Transpose::kNo
, thenb_ld
must be at leastk
, otherwiseb_ld
must be at leastn
. - The value of
c_ld
must be at leastm
.
xSYMM: Symmetric matrix-matrix multiplication
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.
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:
CLBlastStatusCode CLBlastSsymm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastDsymm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastCsymm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZsymm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastHsymm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
Arguments to SYMM:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Side side
: The position of the triangular matrix in the operation, either on theSide::kLeft
(141) orSide::kRight
(142).const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for SYMM:
- When
side = Side::kLeft
thena_ld
must be at leastm
, otherwisea_ld
must be at leastn
. - The value of
b_ld
must be at leastm
. - The value of
c_ld
must be at leastm
.
xHEMM: Hermitian matrix-matrix multiplication
Same operation as xSYMM, but A is an Hermitian matrix instead.
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:
CLBlastStatusCode CLBlastChemm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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)
CLBlastStatusCode CLBlastZhemm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Side side
: The position of the triangular matrix in the operation, either on theSide::kLeft
(141) orSide::kRight
(142).const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for HEMM:
- When
side = Side::kLeft
thena_ld
must be at leastm
, otherwisea_ld
must be at leastn
. - The value of
b_ld
must be at leastm
. - The value of
c_ld
must be at leastm
.
xSYRK: Rank-K update of a symmetric matrix
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.
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:
CLBlastStatusCode CLBlastSsyrk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastDsyrk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastCsyrk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZsyrk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastHsyrk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
Arguments to SYRK:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for SYRK:
- When
transpose == Transpose::kNo
, thena_ld
must be at leastn
, otherwisea_ld
must be at leastk
. - The value of
c_ld
must be at leastm
.
xHERK: Rank-K update of a hermitian matrix
Same operation as xSYRK, but C is an Hermitian matrix instead.
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:
CLBlastStatusCode CLBlastCherk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZherk(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for HERK:
- When
transpose == Transpose::kNo
, thena_ld
must be at leastn
, otherwisea_ld
must be at leastk
. - The value of
c_ld
must be at leastm
.
xSYR2K: Rank-2K update of a symmetric matrix
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.
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:
CLBlastStatusCode CLBlastSsyr2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastDsyr2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastCsyr2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZsyr2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastHsyr2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
Arguments to SYR2K:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose ab_transpose
: Transposing the packed input matrix AP, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for SYR2K:
- When
transpose == Transpose::kNo
, thena_ld
must be at leastn
, otherwisea_ld
must be at leastk
. - When
transpose == Transpose::kNo
, thenb_ld
must be at leastn
, otherwiseb_ld
must be at leastk
. - The value of
c_ld
must be at leastn
.
xHER2K: Rank-2K update of a hermitian matrix
Same operation as xSYR2K, but C is an Hermitian matrix instead.
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:
CLBlastStatusCode CLBlastCher2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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)
CLBlastStatusCode CLBlastZher2k(const CLBlastLayout layout, const CLBlastTriangle triangle, const CLBlastTranspose 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:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose ab_transpose
: Transposing the packed input matrix AP, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.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.
Requirements for HER2K:
- When
transpose == Transpose::kNo
, thena_ld
must be at leastn
, otherwisea_ld
must be at leastk
. - When
transpose == Transpose::kNo
, thenb_ld
must be at leastn
, otherwiseb_ld
must be at leastk
. - The value of
c_ld
must be at leastn
.
xTRMM: Triangular matrix-matrix multiplication
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.
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:
CLBlastStatusCode CLBlastStrmm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtrmm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtrmm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtrmm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastHtrmm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TRMM:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Side side
: The position of the triangular matrix in the operation, either on theSide::kLeft
(141) orSide::kRight
(142).const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the output B matrix. This value must be greater than 0.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.
Requirements for TRMM:
- When
side = Side::kLeft
thena_ld
must be at leastm
, otherwisea_ld
must be at leastn
. - The value of
b_ld
must be at leastm
.
xTRSM: Solves a triangular system of equations
Solves the equation A * X = alpha * B for the unknown m by n matrix X, in which A is an n by n unit or non-unit triangular matrix and B is an m by n matrix. The matrix B is overwritten by the solution X.
C++ API:
template <typename T>
StatusCode Trsm(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:
CLBlastStatusCode CLBlastStrsm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastDtrsm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastCtrsm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
CLBlastStatusCode CLBlastZtrsm(const CLBlastLayout layout, const CLBlastSide side, const CLBlastTriangle triangle, const CLBlastTranspose a_transpose, const CLBlastDiagonal 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)
Arguments to TRSM:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Side side
: The position of the triangular matrix in the operation, either on theSide::kLeft
(141) orSide::kRight
(142).const Triangle triangle
: The part of the array of the triangular matrix to be used, eitherTriangle::kUpper
(121) orTriangle::kLower
(122).const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Diagonal diagonal
: The property of the diagonal matrix, eitherDiagonal::kNonUnit
(131) for non-unit values on the diagonal orDiagonal::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the output B matrix. This value must be greater than 0.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.
xHAD: Element-wise vector product (Hadamard)
Performs the Hadamard element-wise product z = alpha * x * y + beta * z, in which x, y, and z are vectors and alpha and beta are scalar constants.
C++ API:
template <typename T>
StatusCode Had(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,
const T beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastShad(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,
const float beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDhad(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,
const double beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastChad(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,
const cl_float2 beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZhad(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,
const cl_double2 beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHhad(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,
const cl_half beta,
cl_mem z_buffer, const size_t z_offset, const size_t z_inc,
cl_command_queue* queue, cl_event* event)
Arguments to HAD:
const size_t n
: Integer size argument. This value must be positive.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.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.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.const size_t y_inc
: Stride/increment of the input y vector. This value must be greater than 0.const T beta
: Input scalar constant.cl_mem z_buffer
: OpenCL buffer to store the output z vector.const size_t z_offset
: The offset in elements from the start of the output z vector.const size_t z_inc
: Stride/increment of the output z vector. This value must be greater than 0.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.
xOMATCOPY: Scaling and out-place transpose/copy (non-BLAS function)
Performs scaling and out-of-place transposition/copying of matrices according to B = alpha*op(A), in which A is an input matrix (m rows by n columns), B an output matrix, and alpha a scalar value. The operation op can be a normal matrix copy, a transposition or a conjugate transposition.
C++ API:
template <typename T>
StatusCode Omatcopy(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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSomatcopy(const CLBlastLayout layout, const CLBlastTranspose 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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDomatcopy(const CLBlastLayout layout, const CLBlastTranspose 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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastComatcopy(const CLBlastLayout layout, const CLBlastTranspose 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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZomatcopy(const CLBlastLayout layout, const CLBlastTranspose 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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHomatcopy(const CLBlastLayout layout, const CLBlastTranspose 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,
cl_mem b_buffer, const size_t b_offset, const size_t b_ld,
cl_command_queue* queue, cl_event* event)
Arguments to OMATCOPY:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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 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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.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.const size_t b_ld
: Leading dimension of the output B matrix. This value must be greater than 0.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.
Requirements for OMATCOPY:
- The value of
a_ld
must be at leastm
. - The value of
b_ld
must be at leastn
.
xIM2COL: Im2col function (non-BLAS function)
Performs the im2col algorithm, in which im is the input matrix and col is the output matrix.
C++ API:
template <typename T>
StatusCode Im2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSim2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDim2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastCim2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZim2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHim2col(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w,
const cl_mem im_buffer, const size_t im_offset,
cl_mem col_buffer, const size_t col_offset,
cl_command_queue* queue, cl_event* event)
Arguments to IM2COL:
const size_t channels
: Integer size argument. This value must be positive.const size_t height
: Integer size argument. This value must be positive.const size_t width
: Integer size argument. This value must be positive.const size_t kernel_h
: Integer size argument. This value must be positive.const size_t kernel_w
: Integer size argument. This value must be positive.const size_t pad_h
: Integer size argument. This value must be positive.const size_t pad_w
: Integer size argument. This value must be positive.const size_t stride_h
: Integer size argument. This value must be positive.const size_t stride_w
: Integer size argument. This value must be positive.const size_t dilation_h
: Integer size argument. This value must be positive.const size_t dilation_w
: Integer size argument. This value must be positive.const cl_mem im_buffer
: OpenCL buffer to store the input im tensor.const size_t im_offset
: The offset in elements from the start of the input im tensor.cl_mem col_buffer
: OpenCL buffer to store the output col tensor.const size_t col_offset
: The offset in elements from the start of the output col tensor.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.
xCONVGEMM: Batched convolution as GEMM (non-BLAS function)
Integrates im2col and GEMM for batched 3D convolution, in which im is the 4D input tensor (NCHW - batch-channelin-height-width), kernel the 4D kernel weights tensor (KCHW - channelout-channelin-height-width), and result the 4D output tensor (NCHW - batch-channelout-height-width).
C++ API:
template <typename T>
StatusCode Convgemm(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w, const size_t num_kernels, const size_t batch_count,
const cl_mem im_buffer, const size_t im_offset,
const cl_mem kernel_buffer, const size_t kernel_offset,
cl_mem result_buffer, const size_t result_offset,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSconvgemm(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w, const size_t num_kernels, const size_t batch_count,
const cl_mem im_buffer, const size_t im_offset,
const cl_mem kernel_buffer, const size_t kernel_offset,
cl_mem result_buffer, const size_t result_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDconvgemm(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w, const size_t num_kernels, const size_t batch_count,
const cl_mem im_buffer, const size_t im_offset,
const cl_mem kernel_buffer, const size_t kernel_offset,
cl_mem result_buffer, const size_t result_offset,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHconvgemm(const size_t channels, const size_t height, const size_t width, const size_t kernel_h, const size_t kernel_w, const size_t pad_h, const size_t pad_w, const size_t stride_h, const size_t stride_w, const size_t dilation_h, const size_t dilation_w, const size_t num_kernels, const size_t batch_count,
const cl_mem im_buffer, const size_t im_offset,
const cl_mem kernel_buffer, const size_t kernel_offset,
cl_mem result_buffer, const size_t result_offset,
cl_command_queue* queue, cl_event* event)
Arguments to CONVGEMM:
const size_t channels
: Integer size argument. This value must be positive.const size_t height
: Integer size argument. This value must be positive.const size_t width
: Integer size argument. This value must be positive.const size_t kernel_h
: Integer size argument. This value must be positive.const size_t kernel_w
: Integer size argument. This value must be positive.const size_t pad_h
: Integer size argument. This value must be positive.const size_t pad_w
: Integer size argument. This value must be positive.const size_t stride_h
: Integer size argument. This value must be positive.const size_t stride_w
: Integer size argument. This value must be positive.const size_t dilation_h
: Integer size argument. This value must be positive.const size_t dilation_w
: Integer size argument. This value must be positive.const size_t num_kernels
: Integer size argument. This value must be positive.const size_t batch_count
: Integer size argument. This value must be positive.const cl_mem im_buffer
: OpenCL buffer to store the input im tensor.const size_t im_offset
: The offset in elements from the start of the input im tensor.const cl_mem kernel_buffer
: OpenCL buffer to store the input kernel tensor.const size_t kernel_offset
: The offset in elements from the start of the input kernel tensor.cl_mem result_buffer
: OpenCL buffer to store the output result tensor.const size_t result_offset
: The offset in elements from the start of the output result tensor.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.
xAXPYBATCHED: Batched version of AXPY
As AXPY, but multiple operations are batched together for better performance.
C++ API:
template <typename T>
StatusCode AxpyBatched(const size_t n,
const T *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSaxpyBatched(const size_t n,
const float *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDaxpyBatched(const size_t n,
const double *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastCaxpyBatched(const size_t n,
const cl_float2 *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZaxpyBatched(const size_t n,
const cl_double2 *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHaxpyBatched(const size_t n,
const cl_half *alphas,
const cl_mem x_buffer, const size_t *x_offsets, const size_t x_inc,
cl_mem y_buffer, const size_t *y_offsets, const size_t y_inc,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
Arguments to AXPYBATCHED:
const size_t n
: Integer size argument. This value must be positive.const T *alphas
: Input scalar constants.const cl_mem x_buffer
: OpenCL buffer to store the input x vector.const size_t *x_offsets
: The offsets in elements from the start of the input x vector.const size_t x_inc
: Stride/increment of the input x vector. This value must be greater than 0.cl_mem y_buffer
: OpenCL buffer to store the output y vector.const size_t *y_offsets
: The offsets in elements from the start of the output y vector.const size_t y_inc
: Stride/increment of the output y vector. This value must be greater than 0.const size_t batch_count
: Number of batches. This value must be positive.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.
xGEMMBATCHED: Batched version of GEMM
As GEMM, but multiple operations are batched together for better performance.
C++ API:
template <typename T>
StatusCode GemmBatched(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 *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const T *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSgemmBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const float *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const float *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDgemmBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const double *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const double *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastCgemmBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_float2 *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const cl_float2 *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZgemmBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_double2 *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const cl_double2 *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHgemmBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const cl_half *alphas,
const cl_mem a_buffer, const size_t *a_offsets, const size_t a_ld,
const cl_mem b_buffer, const size_t *b_offsets, const size_t b_ld,
const cl_half *betas,
cl_mem c_buffer, const size_t *c_offsets, const size_t c_ld,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
Arguments to GEMMBATCHED:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Transpose b_transpose
: Transposing the input matrix B, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.const T *alphas
: Input scalar constants.const cl_mem a_buffer
: OpenCL buffer to store the input A matrix.const size_t *a_offsets
: The offsets in elements from the start of the input A matrix.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.const cl_mem b_buffer
: OpenCL buffer to store the input B matrix.const size_t *b_offsets
: The offsets in elements from the start of the input B matrix.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.const T *betas
: Input scalar constants.cl_mem c_buffer
: OpenCL buffer to store the output C matrix.const size_t *c_offsets
: The offsets in elements from the start of the output C matrix.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.const size_t batch_count
: Number of batches. This value must be positive.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.
Requirements for GEMMBATCHED:
- When
transpose_a == Transpose::kNo
, thena_ld
must be at leastm
, otherwisea_ld
must be at leastk
. - When
transpose_b == Transpose::kNo
, thenb_ld
must be at leastk
, otherwiseb_ld
must be at leastn
. - The value of
c_ld
must be at leastm
.
xGEMMSTRIDEDBATCHED: StridedBatched version of GEMM
As GEMM, but multiple strided operations are batched together for better performance.
C++ API:
template <typename T>
StatusCode GemmStridedBatched(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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const T beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
C API:
CLBlastStatusCode CLBlastSgemmStridedBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const float beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastDgemmStridedBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const double beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastCgemmStridedBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const cl_float2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastZgemmStridedBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const cl_double2 beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
CLBlastStatusCode CLBlastHgemmStridedBatched(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose 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 size_t a_stride,
const cl_mem b_buffer, const size_t b_offset, const size_t b_ld, const size_t b_stride,
const cl_half beta,
cl_mem c_buffer, const size_t c_offset, const size_t c_ld, const size_t c_stride,
const size_t batch_count,
cl_command_queue* queue, cl_event* event)
Arguments to GEMMSTRIDEDBATCHED:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Transpose b_transpose
: Transposing the input matrix B, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.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.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.const size_t a_stride
: The (fixed) stride between two batches of the A matrix.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.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.const size_t b_stride
: The (fixed) stride between two batches of the B matrix.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.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.const size_t c_stride
: The (fixed) stride between two batches of the C matrix.const size_t batch_count
: Number of batches. This value must be positive.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.
Requirements for GEMMSTRIDEDBATCHED:
- When
transpose_a == Transpose::kNo
, thena_ld
must be at leastm
, otherwisea_ld
must be at leastk
. - When
transpose_b == Transpose::kNo
, thenb_ld
must be at leastk
, otherwiseb_ld
must be at leastn
. - The value of
c_ld
must be at leastm
.
GemmTempBufferSize: Retrieves the size of the temporary buffer for GEMM (auxiliary function)
Retrieves the required size of the temporary buffer for the GEMM kernel for specific arguments and for a specific device/platform and tuning parameters. This could be 0 in case no temporary buffer is required. Arguments are similar to those for GEMM.
C++ API:
template <typename T>
StatusCode GemmTempBufferSize(const Layout layout, const Transpose a_transpose, const Transpose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t& temp_buffer_size)
C API:
CLBlastStatusCode CLBlastSGemmTempBufferSize(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t* temp_buffer_size)
CLBlastStatusCode CLBlastDGemmTempBufferSize(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t* temp_buffer_size)
CLBlastStatusCode CLBlastCGemmTempBufferSize(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t* temp_buffer_size)
CLBlastStatusCode CLBlastZGemmTempBufferSize(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t* temp_buffer_size)
CLBlastStatusCode CLBlastHGemmTempBufferSize(const CLBlastLayout layout, const CLBlastTranspose a_transpose, const CLBlastTranspose b_transpose,
const size_t m, const size_t n, const size_t k,
const size_t a_offset, const size_t a_ld,
const size_t b_offset, const size_t b_ld,
const size_t c_offset, const size_t c_ld,
cl_command_queue* queue, size_t* temp_buffer_size)
Arguments to GemmTempBufferSize:
const Layout layout
: Data-layout of the matrices, eitherLayout::kRowMajor
(101) for row-major layout orLayout::kColMajor
(102) for column-major data-layout.const Transpose a_transpose
: Transposing the input matrix A, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::kConjugate
(113) for a complex-conjugate transpose.const Transpose b_transpose
: Transposing the input matrix B, eitherTranspose::kNo
(111),Transpose::kYes
(112), orTranspose::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.const size_t a_offset
: The offset in elements from the start of the input A matrix.const size_t a_ld
: Leading dimension of the input A matrix. This value must be greater than 0.const size_t b_offset
: The offset in elements from the start of the input B matrix.const size_t b_ld
: Leading dimension of the input B matrix. This value must be greater than 0.const size_t c_offset
: The offset in elements from the start of the output C matrix.const size_t c_ld
: Leading dimension of the output C matrix. This value must be greater than 0.cl_command_queue* queue
: Pointer to an OpenCL command queue associated with a context and device to execute the routine on.size_t& temp_buffer_size
: The result of this function: the required buffer size.
ClearCache: Resets the cache of compiled binaries (auxiliary function)
CLBlast stores binaries of compiled kernels into a cache in case the same kernel is used later on for the same device. This cache can be cleared to free up system memory or it can be useful in case of debugging.
C++ API:
StatusCode ClearCache()
C API:
CLBlastStatusCode CLBlastClearCache()
FillCache: Populates the cache of compiled binaries for a specific device (auxiliary function)
CLBlast stores binaries of compiled kernels into a cache in case the same kernel is used later on for the same device. This cache is automatically populated whenever a new binary is created. Thus, the first run of a specific kernel could take extra time. For debugging or performance evaluation purposes, it might be useful to populate the cache upfront. This function populates the cache for all kernels in CLBlast for all precisions, but for a specific device only.
C++ API:
StatusCode FillCache(const cl_device_id device)
C API:
CLBlastStatusCode CLBlastFillCache(const cl_device_id device)
Arguments to FillCache:
const cl_device_id device
: The OpenCL device to fill the cache for.
RetrieveParameters: Retrieves current tuning parameters (auxiliary function)
This function retrieves current tuning parameters for a specific device-precision-kernel combination. This can be used for debugging or inspection. See tuning.md for more details on which kernel names and parameters are valid.
C++ API:
StatusCode RetrieveParameters(const cl_device_id device, const std::string &kernel_name,
const Precision precision,
std::unordered_map<std::string,size_t> ¶meters)
A C API is not available for this function.
Arguments to RetrieveParameters (C++ version):
const cl_device_id device
: The OpenCL device to query the parameters for.const std::string &kernel_name
: The target kernel name. This has to be one of the existing CLBlast kernels (Xaxpy, Xdot, Xgemv, XgemvFast, XgemvFastRot, Xgemv, Xger, Copy, Pad, Transpose, Padtranspose, Xgemm, or XgemmDirect). If this argument is incorrect, this function will return with theclblast::kInvalidOverrideKernel
status-code.const Precision precision
: The CLBlast precision enum to query the parameters for.std::unordered_map<std::string,size_t> ¶meters
: An unordered map of strings to integers. This will be filled with the current tuning parameters for a specific kernel.
OverrideParameters: Override tuning parameters (auxiliary function)
This function overrides tuning parameters for a specific device-precision-kernel combination. The next time the target routine is called it will be re-compiled and use the new parameters. All further times (until OverrideParameters
is called again) it will load the kernel from the cache and thus continue to use the new parameters. Note that the first time after calling OverrideParameters
a performance drop can be observable due to the re-compilation of the kernel. See tuning.md for more details on which kernel names and parameters are valid.
C++ API:
StatusCode OverrideParameters(const cl_device_id device, const std::string &kernel_name,
const Precision precision,
const std::unordered_map<std::string,size_t> ¶meters)
C API:
CLBlastStatusCode CLBlastOverrideParameters(const cl_device_id device, const char* kernel_name,
const CLBlastPrecision precision, const size_t num_parameters,
const char** parameters_names, const size_t* parameters_values)
Arguments to OverrideParameters (C++ version):
const cl_device_id device
: The OpenCL device to set the new parameters for.const std::string &kernel_name
: The target kernel name. This has to be one of the existing CLBlast kernels (Xaxpy, Xdot, Xgemv, XgemvFast, XgemvFastRot, Xgemv, Xger, Copy, Pad, Transpose, Padtranspose, Xgemm, or XgemmDirect). If this argument is incorrect, this function will return with theclblast::kInvalidOverrideKernel
status-code.const Precision precision
: The CLBlast precision enum to set the new parameters for.const std::unordered_map<std::string,size_t> ¶meters
: An unordered map of strings to integers. This has to contain all the tuning parameters for a specific kernel as reported by the included tuners (e.g.{ {"COPY_DIMX",8}, {"COPY_DIMY",32}, {"COPY_VW",4}, {"COPY_WPT",8} }
for theCopy
kernel). If this argument is incorrect, this function will return with theclblast::kMissingOverrideParameter
status-code.
Tune<kernel_name>: Run the tuner for a particular kernel (advanced usage)
The CLBlast kernels can be tuned using the tuning binaries, but also programmatically through an API. This is only recommended for advanced usage, see for more information the tuning docs.
C++ API:
// Tunes the "Xaxpy" kernel, used for many level-1 routines such as XAXPY, XCOPY, and XSWAP
template <typename T>
StatusCode PUBLIC_API TuneXaxpy(cl_command_queue* queue, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Xdot" kernel, used for level-1 reduction routines such as XDOT, XMAX, and XSUM
template <typename T>
StatusCode PUBLIC_API TuneXdot(cl_command_queue* queue, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Xgemv" kernel, used for matrix-vector level-2 routines such as XGEMV, XGBMV, and XHEMV
template <typename T>
StatusCode PUBLIC_API TuneXgemv(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Xger" kernel, used for matrix update level-2 routines such as XGER, XHER, and XSYR2
template <typename T>
StatusCode PUBLIC_API TuneXger(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Xgemm" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TuneXgemm(cl_command_queue* queue, const size_t m, const size_t n, const size_t k,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "XgemmDiret" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TuneXgemmDirect(cl_command_queue* queue, const size_t m, const size_t n, const size_t k,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Copy" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TuneCopy(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Pad" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TunePad(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Transpose" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TuneTranspose(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Padtranspose" kernel, used for most level-3 routines such as XGEMM, XSYMM, and XHER2K
template <typename T>
StatusCode PUBLIC_API TunePadtranspose(cl_command_queue* queue, const size_t m, const size_t n,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
// Tunes the "Xgemm" kernel, used for the level-3 routine XTRSM
template <typename T>
StatusCode PUBLIC_API TuneInvert(cl_command_queue* queue, const size_t m, const size_t n, const size_t k,
const double fraction, std::unordered_map<std::string,size_t> ¶meters);
Arguments to Tune<kernel_name> (C++ version):
cl_command_queue* queue
: Pointer to an OpenCL command queue associated with a context and device to tune the kernel for.const size_t m
: The routine argumentm
to tune for (not applicable for all kernels)const size_t n
: The routine argumentn
to tune forconst size_t k
: The routine argumentk
to tune for (not applicable for all kernels)const double fraction
: A value between 0.0 and 1.0 which determines the fraction of the tuning search space to explore.std::unordered_map<std::string,size_t> ¶meters
: An unordered map of strings to integers. This will return the best found tuning parameters.