TRSM - Solving triangular systems of equations

Functions
clblasStatus	clblasStrsm (clblasOrder order, clblasSide side, clblasUplo uplo, clblasTranspose transA, clblasDiag diag, size_t M, size_t N, cl_float alpha, const cl_mem A, size_t offA, size_t lda, cl_mem B, size_t offB, size_t ldb, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	Solving triangular systems of equations with multiple right-hand sides and float elements. Extended version. More...
clblasStatus	clblasDtrsm (clblasOrder order, clblasSide side, clblasUplo uplo, clblasTranspose transA, clblasDiag diag, size_t M, size_t N, cl_double alpha, const cl_mem A, size_t offA, size_t lda, cl_mem B, size_t offB, size_t ldb, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	Solving triangular systems of equations with multiple right-hand sides and double elements. Extended version. More...
clblasStatus	clblasCtrsm (clblasOrder order, clblasSide side, clblasUplo uplo, clblasTranspose transA, clblasDiag diag, size_t M, size_t N, FloatComplex alpha, const cl_mem A, size_t offA, size_t lda, cl_mem B, size_t offB, size_t ldb, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	Solving triangular systems of equations with multiple right-hand sides and float complex elements. Extended version. More...
clblasStatus	clblasZtrsm (clblasOrder order, clblasSide side, clblasUplo uplo, clblasTranspose transA, clblasDiag diag, size_t M, size_t N, DoubleComplex alpha, const cl_mem A, size_t offA, size_t lda, cl_mem B, size_t offB, size_t ldb, cl_uint numCommandQueues, cl_command_queue *commandQueues, cl_uint numEventsInWaitList, const cl_event *eventWaitList, cl_event *events)
	Solving triangular systems of equations with multiple right-hand sides and double complex elements. Extended version. More...

Detailed Description

Function Documentation

clblasStatus clblasCtrsm	(	clblasOrder	order,
		clblasSide	side,
		clblasUplo	uplo,
		clblasTranspose	transA,
		clblasDiag	diag,
		size_t	M,
		size_t	N,
		FloatComplex	alpha,
		const cl_mem	A,
		size_t	offA,
		size_t	lda,
		cl_mem	B,
		size_t	offB,
		size_t	ldb,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

Solving triangular systems of equations with multiple right-hand sides and float complex elements. Extended version.

Solving triangular systems of equations:

• \( B \leftarrow \alpha A^{-1} B \)
• \( B \leftarrow \alpha A^{-T} B \)
• \( B \leftarrow \alpha B A^{-1} \)
• \( B \leftarrow \alpha B A^{-T} \)

where T is an upper or lower triangular matrix.

Parameters

[in]	order	Row/column order.
[in]	side	The side of triangular matrix.
[in]	uplo	The triangle in matrix being referenced.
[in]	transA	How matrix A is to be transposed.
[in]	diag	Specify whether matrix is unit triangular.
[in]	M	Number of rows in matrix B.
[in]	N	Number of columns in matrix B.
[in]	alpha	The factor of matrix A.
[in]	A	Buffer object storing matrix A.
[in]	offA	Offset of the first element of the matrix A in the buffer object. Counted in elements.
[in]	lda	Leading dimension of matrix A. For detailed description, see clblasStrsm().
[out]	B	Buffer object storing matrix B.
[in]	offB	Offset of the first element of the matrix B in the buffer object. Counted in elements.
[in]	ldb	Leading dimension of matrix B. For detailed description, see clblasStrsm().
[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;
• clblasInvalidValue if either offA or offB exceeds the size of the respective buffer object;
• the same error codes as clblasStrsm() otherwise.

clblasStatus clblasDtrsm	(	clblasOrder	order,
		clblasSide	side,
		clblasUplo	uplo,
		clblasTranspose	transA,
		clblasDiag	diag,
		size_t	M,
		size_t	N,
		cl_double	alpha,
		const cl_mem	A,
		size_t	offA,
		size_t	lda,
		cl_mem	B,
		size_t	offB,
		size_t	ldb,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

Solving triangular systems of equations with multiple right-hand sides and double elements. Extended version.

Note

This function is not thread-safe.

Solving triangular systems of equations:

• \( B \leftarrow \alpha A^{-1} B \)
• \( B \leftarrow \alpha A^{-T} B \)
• \( B \leftarrow \alpha B A^{-1} \)
• \( B \leftarrow \alpha B A^{-T} \)

where T is an upper or lower triangular matrix.

Parameters

[in]	order	Row/column order.
[in]	side	The side of triangular matrix.
[in]	uplo	The triangle in matrix being referenced.
[in]	transA	How matrix A is to be transposed.
[in]	diag	Specify whether matrix is unit triangular.
[in]	M	Number of rows in matrix B.
[in]	N	Number of columns in matrix B.
[in]	alpha	The factor of matrix A.
[in]	A	Buffer object storing matrix A.
[in]	offA	Offset of the first element of the matrix A in the buffer object. Counted in elements.
[in]	lda	Leading dimension of matrix A. For detailed description, see clblasStrsm().
[out]	B	Buffer object storing matrix B.
[in]	offB	Offset of the first element of the matrix A in the buffer object. Counted in elements.
[in]	ldb	Leading dimension of matrix B. For detailed description, see clblasStrsm().
[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;
• clblasInvalidDevice if a target device does not support floating point arithmetic with double precision;
• clblasInvalidValue if either offA or offB exceeds the size of the respective buffer object;
• the same error codes as the clblasStrsm() function otherwise.

clblasStatus clblasStrsm	(	clblasOrder	order,
		clblasSide	side,
		clblasUplo	uplo,
		clblasTranspose	transA,
		clblasDiag	diag,
		size_t	M,
		size_t	N,
		cl_float	alpha,
		const cl_mem	A,
		size_t	offA,
		size_t	lda,
		cl_mem	B,
		size_t	offB,
		size_t	ldb,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

Solving triangular systems of equations with multiple right-hand sides and float elements. Extended version.

Note

This function is not thread-safe.

Solving triangular systems of equations:

• \( B \leftarrow \alpha A^{-1} B \)
• \( B \leftarrow \alpha A^{-T} B \)
• \( B \leftarrow \alpha B A^{-1} \)
• \( B \leftarrow \alpha B A^{-T} \)

where T is an upper or lower triangular matrix.

Parameters

[in]	order	Row/column order.
[in]	side	The side of triangular matrix.
[in]	uplo	The triangle in matrix being referenced.
[in]	transA	How matrix A is to be transposed.
[in]	diag	Specify whether matrix is unit triangular.
[in]	M	Number of rows in matrix B.
[in]	N	Number of columns in matrix B.
[in]	alpha	The factor of matrix A.
[in]	A	Buffer object storing matrix A.
[in]	offA	Offset of the first element of the matrix A in the buffer object. Counted in elements.
[in]	lda	Leading dimension of matrix A. It cannot be less than M when the side parameter is set to clblasLeft, or less than N when it is set to clblasRight.
[out]	B	Buffer object storing matrix B.
[in]	offB	Offset of the first element of the matrix B in the buffer object. Counted in elements.
[in]	ldb	Leading dimension of matrix B. It cannot be less than N when the order parameter is set to clblasRowMajor, or less than M when it is set to clblasColumnMajor.
[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;
• clblasInvalidValue if either offA or offB exceeds the size of the respective buffer object;
• the same error codes as clblasStrsm() otherwise.

Examples:

example_strsm.c.

clblasStatus clblasZtrsm	(	clblasOrder	order,
		clblasSide	side,
		clblasUplo	uplo,
		clblasTranspose	transA,
		clblasDiag	diag,
		size_t	M,
		size_t	N,
		DoubleComplex	alpha,
		const cl_mem	A,
		size_t	offA,
		size_t	lda,
		cl_mem	B,
		size_t	offB,
		size_t	ldb,
		cl_uint	numCommandQueues,
		cl_command_queue *	commandQueues,
		cl_uint	numEventsInWaitList,
		const cl_event *	eventWaitList,
		cl_event *	events
	)

Solving triangular systems of equations with multiple right-hand sides and double complex elements. Extended version.

Solving triangular systems of equations:

• \( B \leftarrow \alpha A^{-1} B \)
• \( B \leftarrow \alpha A^{-T} B \)
• \( B \leftarrow \alpha B A^{-1} \)
• \( B \leftarrow \alpha B A^{-T} \)

where T is an upper or lower triangular matrix.

Parameters

[in]	order	Row/column order.
[in]	side	The side of triangular matrix.
[in]	uplo	The triangle in matrix being referenced.
[in]	transA	How matrix A is to be transposed.
[in]	diag	Specify whether matrix is unit triangular.
[in]	M	Number of rows in matrix B.
[in]	N	Number of columns in matrix B.
[in]	alpha	The factor of matrix A.
[in]	A	Buffer object storing matrix A.
[in]	offA	Offset of the first element of the matrix A in the buffer object. Counted in elements.
[in]	lda	Leading dimension of matrix A. For detailed description, see clblasStrsm().
[out]	B	Buffer object storing matrix B.
[in]	offB	Offset of the first element of the matrix B in the buffer object. Counted in elements.
[in]	ldb	Leading dimension of matrix B. For detailed description, see clblasStrsm().
[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;
• clblasInvalidDevice if a target device does not support floating point arithmetic with double precision;
• clblasInvalidValue if either offA or offB exceeds the size of the respective buffer object;
• the same error codes as the clblasStrsm() function otherwise