potri: Cholesky inverse

Functions
int	plasma_cpotri (plasma_enum_t uplo, int n, plasma_complex32_t *pA, int lda)
void	plasma_omp_cpotri (plasma_enum_t uplo, plasma_desc_t A, plasma_sequence_t *sequence, plasma_request_t *request)
int	plasma_dpotri (plasma_enum_t uplo, int n, double *pA, int lda)
void	plasma_omp_dpotri (plasma_enum_t uplo, plasma_desc_t A, plasma_sequence_t *sequence, plasma_request_t *request)
int	plasma_spotri (plasma_enum_t uplo, int n, float *pA, int lda)
void	plasma_omp_spotri (plasma_enum_t uplo, plasma_desc_t A, plasma_sequence_t *sequence, plasma_request_t *request)
int	plasma_zpotri (plasma_enum_t uplo, int n, plasma_complex64_t *pA, int lda)
void	plasma_omp_zpotri (plasma_enum_t uplo, plasma_desc_t A, plasma_sequence_t *sequence, plasma_request_t *request)

Detailed Description

Function Documentation

int plasma_cpotri	(	plasma_enum_t	uplo,
		int	n,
		plasma_complex32_t *	pA,
		int	lda
	)

Computes the inverse of a Hermitian positive definite matrix A using the Cholesky factorization

\[ A = U^H \times U, \]

or

\[ A = L \times L^H. \]

Parameters

[in]	uplo	= PlasmaUpper: Upper triangle of A is stored; = PlasmaLower: Lower triangle of A is stored.
[in]	n	The order of the matrix A. n >= 0.
[in,out]	pA	On entry, the triangular factor U or L from the Cholesky factorization A = U^H*U or A = L*L^H, as computed by plasma_cpotrf. On exit, the upper or lower triangle of the (Hermitian) inverse of A, overwriting the input factor U or L.
[in]	lda	The leading dimension of the array A. lda >= max(1,n).

Return values

PLASMA_SUCCESS	successful exit
<	0 if -i, the i-th argument had an illegal value
>	0 if i, the (i,i) element of the factor U or L is zero, and the inverse could not be computed.

See also

plasma_cpotri

plasma_dpotri

plasma_spotri

void plasma_omp_cpotri	(	plasma_enum_t	uplo,
		plasma_desc_t	A,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes the inverse of a complex Hermitian positive definite matrix A using the Cholesky factorization A = U^H*U or A = L*L^H computed by plasma_cpotrf.

Parameters

[in]	uplo	PlasmaUpper: Upper triangle of A is stored; PlasmaLower: Lower triangle of A is stored.
[in]	A	On entry, the triangular factor U or L from the Cholesky factorization A = U^H*U or A = L*L^H, as computed by plasma_cpotrf. On exit, the upper or lower triangle of the (Hermitian) inverse of A, overwriting the input factor U or L.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes). Check the sequence->status for errors.
[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_cpotri

plasma_omp_cpotri

plasma_omp_cpotri

plasma_omp_dpotri

plasma_omp_spotri

int plasma_dpotri	(	plasma_enum_t	uplo,
		int	n,
		double *	pA,
		int	lda
	)

Computes the inverse of a symmetric positive definite matrix A using the Cholesky factorization

\[ A = U^T \times U, \]

or

\[ A = L \times L^T. \]

Parameters

[in]	uplo	= PlasmaUpper: Upper triangle of A is stored; = PlasmaLower: Lower triangle of A is stored.
[in]	n	The order of the matrix A. n >= 0.
[in,out]	pA	On entry, the triangular factor U or L from the Cholesky factorization A = U^T*U or A = L*L^T, as computed by plasma_dpotrf. On exit, the upper or lower triangle of the (symmetric) inverse of A, overwriting the input factor U or L.
[in]	lda	The leading dimension of the array A. lda >= max(1,n).

Return values

PLASMA_SUCCESS	successful exit
<	0 if -i, the i-th argument had an illegal value
>	0 if i, the (i,i) element of the factor U or L is zero, and the inverse could not be computed.

See also

plasma_cpotri

plasma_dpotri

plasma_spotri

void plasma_omp_dpotri	(	plasma_enum_t	uplo,
		plasma_desc_t	A,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes the inverse of a complex symmetric positive definite matrix A using the Cholesky factorization A = U^T*U or A = L*L^T computed by plasma_dpotrf.

Parameters

[in]	uplo	PlasmaUpper: Upper triangle of A is stored; PlasmaLower: Lower triangle of A is stored.
[in]	A	On entry, the triangular factor U or L from the Cholesky factorization A = U^T*U or A = L*L^T, as computed by plasma_dpotrf. On exit, the upper or lower triangle of the (symmetric) inverse of A, overwriting the input factor U or L.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes). Check the sequence->status for errors.
[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_dpotri

plasma_omp_dpotri

plasma_omp_cpotri

plasma_omp_dpotri

plasma_omp_spotri

int plasma_spotri	(	plasma_enum_t	uplo,
		int	n,
		float *	pA,
		int	lda
	)

Computes the inverse of a symmetric positive definite matrix A using the Cholesky factorization

\[ A = U^T \times U, \]

or

\[ A = L \times L^T. \]

Parameters

[in]	uplo	= PlasmaUpper: Upper triangle of A is stored; = PlasmaLower: Lower triangle of A is stored.
[in]	n	The order of the matrix A. n >= 0.
[in,out]	pA	On entry, the triangular factor U or L from the Cholesky factorization A = U^T*U or A = L*L^T, as computed by plasma_spotrf. On exit, the upper or lower triangle of the (symmetric) inverse of A, overwriting the input factor U or L.
[in]	lda	The leading dimension of the array A. lda >= max(1,n).

Return values

PLASMA_SUCCESS	successful exit
<	0 if -i, the i-th argument had an illegal value
>	0 if i, the (i,i) element of the factor U or L is zero, and the inverse could not be computed.

See also

plasma_cpotri

plasma_dpotri

plasma_spotri

void plasma_omp_spotri	(	plasma_enum_t	uplo,
		plasma_desc_t	A,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes the inverse of a complex symmetric positive definite matrix A using the Cholesky factorization A = U^T*U or A = L*L^T computed by plasma_spotrf.

Parameters

[in]	uplo	PlasmaUpper: Upper triangle of A is stored; PlasmaLower: Lower triangle of A is stored.
[in]	A	On entry, the triangular factor U or L from the Cholesky factorization A = U^T*U or A = L*L^T, as computed by plasma_spotrf. On exit, the upper or lower triangle of the (symmetric) inverse of A, overwriting the input factor U or L.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes). Check the sequence->status for errors.
[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_spotri

plasma_omp_spotri

plasma_omp_cpotri

plasma_omp_dpotri

plasma_omp_spotri

int plasma_zpotri	(	plasma_enum_t	uplo,
		int	n,
		plasma_complex64_t *	pA,
		int	lda
	)

Computes the inverse of a Hermitian positive definite matrix A using the Cholesky factorization

\[ A = U^H \times U, \]

or

\[ A = L \times L^H. \]

Parameters

[in]	uplo	= PlasmaUpper: Upper triangle of A is stored; = PlasmaLower: Lower triangle of A is stored.
[in]	n	The order of the matrix A. n >= 0.
[in,out]	pA	On entry, the triangular factor U or L from the Cholesky factorization A = U^H*U or A = L*L^H, as computed by plasma_zpotrf. On exit, the upper or lower triangle of the (Hermitian) inverse of A, overwriting the input factor U or L.
[in]	lda	The leading dimension of the array A. lda >= max(1,n).

Return values

PLASMA_SUCCESS	successful exit
<	0 if -i, the i-th argument had an illegal value
>	0 if i, the (i,i) element of the factor U or L is zero, and the inverse could not be computed.

See also

plasma_cpotri

plasma_dpotri

plasma_spotri

void plasma_omp_zpotri	(	plasma_enum_t	uplo,
		plasma_desc_t	A,
		plasma_sequence_t *	sequence,
		plasma_request_t *	request
	)

Computes the inverse of a complex Hermitian positive definite matrix A using the Cholesky factorization A = U^H*U or A = L*L^H computed by plasma_zpotrf.

Parameters

[in]	uplo	PlasmaUpper: Upper triangle of A is stored; PlasmaLower: Lower triangle of A is stored.
[in]	A	On entry, the triangular factor U or L from the Cholesky factorization A = U^H*U or A = L*L^H, as computed by plasma_zpotrf. On exit, the upper or lower triangle of the (Hermitian) inverse of A, overwriting the input factor U or L.
[in]	sequence	Identifies the sequence of function calls that this call belongs to (for completion checks and exception handling purposes). Check the sequence->status for errors.
[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_zpotri

plasma_omp_zpotri

plasma_omp_cpotri

plasma_omp_dpotri

plasma_omp_spotri