Inverse

Performs inversion of a matrix.

Syntax

Intel IPP Style:

IppStatus ippsqInvert_m_32f (Ipp32f* pSrc, Ipp32f* pDst, Ipp32s widthHeight);

DSP style:

ippsq_status ippsq_mat_inverse_f32 (ippsq_matrix_instance_f32 *pSrc, ippsq_matrix_instance_f32 *pDst);

Include Files

dsp.h

Parameters

pSrc

Pointer to the source matrix data or structure.

pDst

Pointer to destination matrix data or structure.

widthHeight

Number of rows and columns of a square input matrix.

Description

This function performs inversion of a square source matrix. The source matrix data pSrc changes after the function call.

Before using DSP-style flavors of this function, you need to initialize the matrix data structure using the Init function.

Note

The inverse operation can be performed for square matrices only.

Return Values

IPPSQ_MATH_SUCCESS

Indicates no error.

IPPSQ_MATH_ARGUMENT_ERROR

Indicates an error when any of the specified pointers is NULL.

IPPSQ_MATH_SIZE_MISMATCH

Indicates an error when matrix sizes are not compatible with the operation.

ippStsSingularErr, IPPSQ_MATH_SINGULAR

Indicates an error when the input matrix is singular and cannot be inverted.

Example

ex_dsqmatinv.c

See Also

For more complete information about compiler optimizations, see our Optimization Notice.