TPSV - Triangular packed matrix vector solve

Functions
clblasStatus	clblasStpsv (clblasOrder order, clblasUplo uplo, clblasTranspose trans, clblasDiag diag, size_t N, const cl_mem A, size_t offa, cl_mem X, size_t offx, int incx, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	solving triangular packed matrix problems with float elements. More...
clblasStatus	clblasDtpsv (clblasOrder order, clblasUplo uplo, clblasTranspose trans, clblasDiag diag, size_t N, const cl_mem A, size_t offa, cl_mem X, size_t offx, int incx, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	solving triangular packed matrix problems with double elements. More...
clblasStatus	clblasCtpsv (clblasOrder order, clblasUplo uplo, clblasTranspose trans, clblasDiag diag, size_t N, const cl_mem A, size_t offa, cl_mem X, size_t offx, int incx, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	solving triangular packed matrix problems with float complex elements. More...
clblasStatus	clblasZtpsv (clblasOrder order, clblasUplo uplo, clblasTranspose trans, clblasDiag diag, size_t N, const cl_mem A, size_t offa, cl_mem X, size_t offx, int incx, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	solving triangular packed matrix problems with double complex elements. More...

Detailed Description

Function Documentation

clblasStatus clblasCtpsv	(	clblasOrder	order,
		clblasUplo	uplo,
		clblasTranspose	trans,
		clblasDiag	diag,
		size_t	N,
		const cl_mem	A,
		size_t	offa,
		cl_mem	X,
		size_t	offx,
		int	incx,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

solving triangular packed matrix problems with float complex elements.

Matrix-vector products:

• \( A X \leftarrow X \)
• \( A^T X \leftarrow X \)

Parameters

[in]	order	Row/column order.
[in]	uplo	The triangle in matrix being referenced.
[in]	trans	How matrix A is to be transposed.
[in]	diag	Specify whether matrix A is unit triangular.
[in]	N	Number of rows/columns in matrix A.
[in]	A	Buffer object storing matrix in packed format.A.
[in]	offa	Offset in number of elements for first element in matrix A.
[out]	X	Buffer object storing vector X.
[in]	offx	Offset in number of elements for first element in vector X.
[in]	incx	Increment for the elements of X. Must not be zero.
[in]	numCommandQueues	Number of OpenCL command queues in which the task is to be performed.
[in]	commandQueues	OpenCL command queues.
[in]	numEventsInWaitList	Number of events in the event wait list.
[in]	eventWaitList	Event wait list.
[in]	events	Event objects per each command queue that identify a particular kernel execution instance.

Returns

• clblasSuccess on success;
• clblasNotInitialized if clblasSetup() was not called;
• clblasInvalidValue if invalid parameters are passed:
  • either N or incx is zero, or
  • the leading dimension is invalid;
• clblasInvalidMemObject if either A or X object is Invalid, or an image object rather than the buffer one;
• clblasOutOfHostMemory if the library can't allocate memory for internal structures;
• clblasInvalidCommandQueue if the passed command queue is invalid;
• clblasInvalidContext if a context a passed command queue belongs to was released;
• clblasInvalidOperation if kernel compilation relating to a previous call has not completed for any of the target devices;
• clblasCompilerNotAvailable if a compiler is not available;
• clblasBuildProgramFailure if there is a failure to build a program executable.

clblasStatus clblasDtpsv	(	clblasOrder	order,
		clblasUplo	uplo,
		clblasTranspose	trans,
		clblasDiag	diag,
		size_t	N,
		const cl_mem	A,
		size_t	offa,
		cl_mem	X,
		size_t	offx,
		int	incx,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

solving triangular packed matrix problems with double elements.

Matrix-vector products:

• \( A X \leftarrow X \)
• \( A^T X \leftarrow X \)

Parameters

[in]	order	Row/column order.
[in]	uplo	The triangle in matrix being referenced.
[in]	trans	How matrix A is to be transposed.
[in]	diag	Specify whether matrix A is unit triangular.
[in]	N	Number of rows/columns in matrix A.
[in]	A	Buffer object storing matrix in packed format.A.
[in]	offa	Offset in number of elements for first element in matrix A.
[out]	X	Buffer object storing vector X.
[in]	offx	Offset in number of elements for first element in vector X.
[in]	incx	Increment for the elements of X. Must not be zero.
[in]	numCommandQueues	Number of OpenCL command queues in which the task is to be performed.
[in]	commandQueues	OpenCL command queues.
[in]	numEventsInWaitList	Number of events in the event wait list.
[in]	eventWaitList	Event wait list.
[in]	events	Event objects per each command queue that identify a particular kernel execution instance.

Returns

• clblasSuccess on success;
• clblasNotInitialized if clblasSetup() was not called;
• clblasInvalidValue if invalid parameters are passed:
  • either N or incx is zero, or
  • the leading dimension is invalid;
• clblasInvalidMemObject if either A or X object is Invalid, or an image object rather than the buffer one;
• clblasOutOfHostMemory if the library can't allocate memory for internal structures;
• clblasInvalidCommandQueue if the passed command queue is invalid;
• clblasInvalidContext if a context a passed command queue belongs to was released;
• clblasInvalidOperation if kernel compilation relating to a previous call has not completed for any of the target devices;
• clblasCompilerNotAvailable if a compiler is not available;
• clblasBuildProgramFailure if there is a failure to build a program executable.

clblasStatus clblasStpsv	(	clblasOrder	order,
		clblasUplo	uplo,
		clblasTranspose	trans,
		clblasDiag	diag,
		size_t	N,
		const cl_mem	A,
		size_t	offa,
		cl_mem	X,
		size_t	offx,
		int	incx,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

solving triangular packed matrix problems with float elements.

Matrix-vector products:

• \( A X \leftarrow X \)
• \( A^T X \leftarrow X \)

Parameters

[in]	order	Row/column order.
[in]	uplo	The triangle in matrix being referenced.
[in]	trans	How matrix A is to be transposed.
[in]	diag	Specify whether matrix A is unit triangular.
[in]	N	Number of rows/columns in matrix A.
[in]	A	Buffer object storing matrix in packed format.A.
[in]	offa	Offset in number of elements for first element in matrix A.
[out]	X	Buffer object storing vector X.
[in]	offx	Offset in number of elements for first element in vector X.
[in]	incx	Increment for the elements of X. Must not be zero.
[in]	numCommandQueues	Number of OpenCL command queues in which the task is to be performed.
[in]	commandQueues	OpenCL command queues.
[in]	numEventsInWaitList	Number of events in the event wait list.
[in]	eventWaitList	Event wait list.
[in]	events	Event objects per each command queue that identify a particular kernel execution instance.

Returns

• clblasSuccess on success;
• clblasNotInitialized if clblasSetup() was not called;
• clblasInvalidValue if invalid parameters are passed:
  • either N or incx is zero, or
  • the leading dimension is invalid;
• clblasInvalidMemObject if either A or X object is Invalid, or an image object rather than the buffer one;
• clblasOutOfHostMemory if the library can't allocate memory for internal structures;
• clblasInvalidCommandQueue if the passed command queue is invalid;
• clblasInvalidContext if a context a passed command queue belongs to was released;
• clblasInvalidOperation if kernel compilation relating to a previous call has not completed for any of the target devices;
• clblasCompilerNotAvailable if a compiler is not available;
• clblasBuildProgramFailure if there is a failure to build a program executable.

Examples:

example_stpsv.c.

clblasStatus clblasZtpsv	(	clblasOrder	order,
		clblasUplo	uplo,
		clblasTranspose	trans,
		clblasDiag	diag,
		size_t	N,
		const cl_mem	A,
		size_t	offa,
		cl_mem	X,
		size_t	offx,
		int	incx,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

solving triangular packed matrix problems with double complex elements.

Matrix-vector products:

• \( A X \leftarrow X \)
• \( A^T X \leftarrow X \)

Parameters

[in]	order	Row/column order.
[in]	uplo	The triangle in matrix being referenced.
[in]	trans	How matrix A is to be transposed.
[in]	diag	Specify whether matrix A is unit triangular.
[in]	N	Number of rows/columns in matrix A.
[in]	A	Buffer object storing matrix in packed format.A.
[in]	offa	Offset in number of elements for first element in matrix A.
[out]	X	Buffer object storing vector X.
[in]	offx	Offset in number of elements for first element in vector X.
[in]	incx	Increment for the elements of X. Must not be zero.
[in]	numCommandQueues	Number of OpenCL command queues in which the task is to be performed.
[in]	commandQueues	OpenCL command queues.
[in]	numEventsInWaitList	Number of events in the event wait list.
[in]	eventWaitList	Event wait list.
[in]	events	Event objects per each command queue that identify a particular kernel execution instance.

Returns

• clblasSuccess on success;
• clblasNotInitialized if clblasSetup() was not called;
• clblasInvalidValue if invalid parameters are passed:
  • either N or incx is zero, or
  • the leading dimension is invalid;
• clblasInvalidMemObject if either A or X object is Invalid, or an image object rather than the buffer one;
• clblasOutOfHostMemory if the library can't allocate memory for internal structures;
• clblasInvalidCommandQueue if the passed command queue is invalid;
• clblasInvalidContext if a context a passed command queue belongs to was released;
• clblasInvalidOperation if kernel compilation relating to a previous call has not completed for any of the target devices;
• clblasCompilerNotAvailable if a compiler is not available;
• clblasBuildProgramFailure if there is a failure to build a program executable.