Functions
int	plasma_cgeqrs (int m, int n, int nrhs, plasma_complex32_t pA, int lda, plasma_desc_t T, plasma_complex32_t pB, int ldb)

void	plasma_omp_cgeqrs (plasma_desc_t A, plasma_desc_t T, plasma_desc_t B, plasma_workspace_t work, plasma_sequence_t sequence, plasma_request_t request)

int	plasma_dgeqrs (int m, int n, int nrhs, double pA, int lda, plasma_desc_t T, double pB, int ldb)

void	plasma_omp_dgeqrs (plasma_desc_t A, plasma_desc_t T, plasma_desc_t B, plasma_workspace_t work, plasma_sequence_t sequence, plasma_request_t request)

int	plasma_sgeqrs (int m, int n, int nrhs, float pA, int lda, plasma_desc_t T, float pB, int ldb)

void	plasma_omp_sgeqrs (plasma_desc_t A, plasma_desc_t T, plasma_desc_t B, plasma_workspace_t work, plasma_sequence_t sequence, plasma_request_t request)

int	plasma_zgeqrs (int m, int n, int nrhs, plasma_complex64_t pA, int lda, plasma_desc_t T, plasma_complex64_t pB, int ldb)

void	plasma_omp_zgeqrs (plasma_desc_t A, plasma_desc_t T, plasma_desc_t B, plasma_workspace_t work, plasma_sequence_t sequence, plasma_request_t request)

Detailed Description

Function Documentation

int plasma_cgeqrs	(	int	m,
		int	n,
		int	nrhs,
		plasma_complex32_t *	pA,
		int	lda,
		plasma_desc_t	T,
		plasma_complex32_t *	pB,
		int	ldb
	)

Computes a minimum-norm solution min || A*X - B || using the QR factorization A = Q*R computed by plasma_cgeqrf.

Parameters

[in]	m	The number of rows of the matrix A. m >= 0.
[in]	n	The number of columns of the matrix A. m >= n >= 0.
[in]	nrhs	The number of columns of B. nrhs >= 0.
[in]	pA	Details of the QR factorization of the original matrix A as returned by plasma_cgeqrf.
[in]	lda	The leading dimension of the array A. lda >= m.
[in]	T	Auxiliary factorization data, computed by plasma_cgeqrf.
[in,out]	pB	On entry, pointer to the m-by-nrhs right hand side matrix B. On exit, the n-by-nrhs solution matrix X.
[in]	ldb	The leading dimension of the array B. ldb >= max(1,n).

Return values

PlasmaSuccess	successful exit
<	0 if -i, the i-th argument had an illegal value

See also: plasma_omp_cgeqrs; plasma_cgeqrs; plasma_dgeqrs; plasma_sgeqrs; plasma_cgeqrf; plasma_cgels

void plasma_omp_cgeqrs	(	plasma_desc_t	A,
		plasma_desc_t	T,
		plasma_desc_t	B,
		plasma_workspace_t	work,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes a minimum-norm solution using the tile QR factorization. Non-blocking tile version of plasma_cgeqrs(). May return before the computation is finished. Allows for pipelining of operations at runtime.

Parameters

[in]	A	Descriptor of matrix A. A is stored in the tile layout.
[in]	T	Descriptor of matrix T. Auxiliary factorization data, computed by plasma_cgeqrf.
[in,out]	B	Descriptor of matrix B. On entry, right-hand side matrix B in the tile layout. On exit, solution matrix X in the tile layout.
[in]	work	Workspace for the auxiliary arrays needed by some coreblas kernels. For multiplication by Q contains preallocated space for work arrays. Allocated by the plasma_workspace_create function.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes).
[out]	request	Identifies this function call (for exception handling purposes).

Return values

void	Errors are returned by setting sequence->status and request->status to error values. The sequence->status and request->status should never be set to PlasmaSuccess (the initial values) since another async call may be setting a failure value at the same time.

See also: plasma_cgeqrs; plasma_omp_cgeqrs; plasma_omp_dgeqrs; plasma_omp_sgeqrs; plasma_omp_cgeqrf; plasma_omp_cgels

int plasma_dgeqrs	(	int	m,
		int	n,
		int	nrhs,
		double *	pA,
		int	lda,
		plasma_desc_t	T,
		double *	pB,
		int	ldb
	)

Computes a minimum-norm solution min || A*X - B || using the QR factorization A = Q*R computed by plasma_dgeqrf.

Parameters

[in]	m	The number of rows of the matrix A. m >= 0.
[in]	n	The number of columns of the matrix A. m >= n >= 0.
[in]	nrhs	The number of columns of B. nrhs >= 0.
[in]	pA	Details of the QR factorization of the original matrix A as returned by plasma_dgeqrf.
[in]	lda	The leading dimension of the array A. lda >= m.
[in]	T	Auxiliary factorization data, computed by plasma_dgeqrf.
[in,out]	pB	On entry, pointer to the m-by-nrhs right hand side matrix B. On exit, the n-by-nrhs solution matrix X.
[in]	ldb	The leading dimension of the array B. ldb >= max(1,n).

Return values

PlasmaSuccess	successful exit
<	0 if -i, the i-th argument had an illegal value

See also: plasma_omp_dgeqrs; plasma_cgeqrs; plasma_dgeqrs; plasma_sgeqrs; plasma_dgeqrf; plasma_dgels

void plasma_omp_dgeqrs	(	plasma_desc_t	A,
		plasma_desc_t	T,
		plasma_desc_t	B,
		plasma_workspace_t	work,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes a minimum-norm solution using the tile QR factorization. Non-blocking tile version of plasma_dgeqrs(). May return before the computation is finished. Allows for pipelining of operations at runtime.

Parameters

[in]	A	Descriptor of matrix A. A is stored in the tile layout.
[in]	T	Descriptor of matrix T. Auxiliary factorization data, computed by plasma_dgeqrf.
[in,out]	B	Descriptor of matrix B. On entry, right-hand side matrix B in the tile layout. On exit, solution matrix X in the tile layout.
[in]	work	Workspace for the auxiliary arrays needed by some coreblas kernels. For multiplication by Q contains preallocated space for work arrays. Allocated by the plasma_workspace_create function.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes).
[out]	request	Identifies this function call (for exception handling purposes).

Return values

void	Errors are returned by setting sequence->status and request->status to error values. The sequence->status and request->status should never be set to PlasmaSuccess (the initial values) since another async call may be setting a failure value at the same time.

See also: plasma_dgeqrs; plasma_omp_cgeqrs; plasma_omp_dgeqrs; plasma_omp_sgeqrs; plasma_omp_dgeqrf; plasma_omp_dgels

int plasma_sgeqrs	(	int	m,
		int	n,
		int	nrhs,
		float *	pA,
		int	lda,
		plasma_desc_t	T,
		float *	pB,
		int	ldb
	)

Computes a minimum-norm solution min || A*X - B || using the QR factorization A = Q*R computed by plasma_sgeqrf.

Parameters

[in]	m	The number of rows of the matrix A. m >= 0.
[in]	n	The number of columns of the matrix A. m >= n >= 0.
[in]	nrhs	The number of columns of B. nrhs >= 0.
[in]	pA	Details of the QR factorization of the original matrix A as returned by plasma_sgeqrf.
[in]	lda	The leading dimension of the array A. lda >= m.
[in]	T	Auxiliary factorization data, computed by plasma_sgeqrf.
[in,out]	pB	On entry, pointer to the m-by-nrhs right hand side matrix B. On exit, the n-by-nrhs solution matrix X.
[in]	ldb	The leading dimension of the array B. ldb >= max(1,n).

Return values

PlasmaSuccess	successful exit
<	0 if -i, the i-th argument had an illegal value

See also: plasma_omp_sgeqrs; plasma_cgeqrs; plasma_dgeqrs; plasma_sgeqrs; plasma_sgeqrf; plasma_sgels

void plasma_omp_sgeqrs	(	plasma_desc_t	A,
		plasma_desc_t	T,
		plasma_desc_t	B,
		plasma_workspace_t	work,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes a minimum-norm solution using the tile QR factorization. Non-blocking tile version of plasma_sgeqrs(). May return before the computation is finished. Allows for pipelining of operations at runtime.

Parameters

[in]	A	Descriptor of matrix A. A is stored in the tile layout.
[in]	T	Descriptor of matrix T. Auxiliary factorization data, computed by plasma_sgeqrf.
[in,out]	B	Descriptor of matrix B. On entry, right-hand side matrix B in the tile layout. On exit, solution matrix X in the tile layout.
[in]	work	Workspace for the auxiliary arrays needed by some coreblas kernels. For multiplication by Q contains preallocated space for work arrays. Allocated by the plasma_workspace_create function.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes).
[out]	request	Identifies this function call (for exception handling purposes).

Return values

void	Errors are returned by setting sequence->status and request->status to error values. The sequence->status and request->status should never be set to PlasmaSuccess (the initial values) since another async call may be setting a failure value at the same time.

See also: plasma_sgeqrs; plasma_omp_cgeqrs; plasma_omp_dgeqrs; plasma_omp_sgeqrs; plasma_omp_sgeqrf; plasma_omp_sgels

int plasma_zgeqrs	(	int	m,
		int	n,
		int	nrhs,
		plasma_complex64_t *	pA,
		int	lda,
		plasma_desc_t	T,
		plasma_complex64_t *	pB,
		int	ldb
	)

Computes a minimum-norm solution min || A*X - B || using the QR factorization A = Q*R computed by plasma_zgeqrf.

Parameters

[in]	m	The number of rows of the matrix A. m >= 0.
[in]	n	The number of columns of the matrix A. m >= n >= 0.
[in]	nrhs	The number of columns of B. nrhs >= 0.
[in]	pA	Details of the QR factorization of the original matrix A as returned by plasma_zgeqrf.
[in]	lda	The leading dimension of the array A. lda >= m.
[in]	T	Auxiliary factorization data, computed by plasma_zgeqrf.
[in,out]	pB	On entry, pointer to the m-by-nrhs right hand side matrix B. On exit, the n-by-nrhs solution matrix X.
[in]	ldb	The leading dimension of the array B. ldb >= max(1,n).

Return values

PlasmaSuccess	successful exit
<	0 if -i, the i-th argument had an illegal value

See also: plasma_omp_zgeqrs; plasma_cgeqrs; plasma_dgeqrs; plasma_sgeqrs; plasma_zgeqrf; plasma_zgels

void plasma_omp_zgeqrs	(	plasma_desc_t	A,
		plasma_desc_t	T,
		plasma_desc_t	B,
		plasma_workspace_t	work,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes a minimum-norm solution using the tile QR factorization. Non-blocking tile version of plasma_zgeqrs(). May return before the computation is finished. Allows for pipelining of operations at runtime.

Parameters

[in]	A	Descriptor of matrix A. A is stored in the tile layout.
[in]	T	Descriptor of matrix T. Auxiliary factorization data, computed by plasma_zgeqrf.
[in,out]	B	Descriptor of matrix B. On entry, right-hand side matrix B in the tile layout. On exit, solution matrix X in the tile layout.
[in]	work	Workspace for the auxiliary arrays needed by some coreblas kernels. For multiplication by Q contains preallocated space for work arrays. Allocated by the plasma_workspace_create function.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes).
[out]	request	Identifies this function call (for exception handling purposes).

Return values

void	Errors are returned by setting sequence->status and request->status to error values. The sequence->status and request->status should never be set to PlasmaSuccess (the initial values) since another async call may be setting a failure value at the same time.

See also: plasma_zgeqrs; plasma_omp_cgeqrs; plasma_omp_dgeqrs; plasma_omp_sgeqrs; plasma_omp_zgeqrf; plasma_omp_zgels

Functions

Detailed Description

Function Documentation