APULPF3_MATRIX_FUNCTIONS

Functions
int_fast16_t	APULPF3_matrixMult (APULPF3_ComplexMatrix *matA, APULPF3_ComplexMatrix *matB, APULPF3_ComplexMatrix *result)
	APU function for multiplying two matrices. The number of rows in the first matrix must be equal to the number of columns in the second matrix. More...
int_fast16_t	APULPF3_matrixSum (APULPF3_ComplexMatrix *matA, APULPF3_ComplexMatrix *matB, APULPF3_ComplexMatrix *result)
	APU function for adding two matrices. The matrices must be of exact same sizes. More...
int_fast16_t	APULPF3_matrixScalarSum (APULPF3_ComplexMatrix *mat, float complex *scalar, APULPF3_ComplexMatrix *result)
	APU function for adding a scalar to a each of a matrix' elements. More...
int_fast16_t	APULPF3_matrixScalarMult (APULPF3_ComplexMatrix *mat, float complex *scalar, APULPF3_ComplexMatrix *result)
	APU function for multiplying each of a matrix' elements by a scalar. More...
int_fast16_t	APULPF3_matrixNorm (APULPF3_ComplexMatrix *mat, float complex *result)
	Compute the Frobenius norm of a matrix. More...

Detailed Description

Function Documentation

APULPF3_matrixMult()

int_fast16_t APULPF3_matrixMult	(	APULPF3_ComplexMatrix *	matA,
		APULPF3_ComplexMatrix *	matB,
		APULPF3_ComplexMatrix *	result
	)

APU function for multiplying two matrices. The number of rows in the first matrix must be equal to the number of columns in the second matrix.

Defined as:

C[MxP] = A[MxN] * B[NxP]

in which A, B, and C are complex matrices with size [MxP], [MxN], and [NxP] respectively.

Precondition

APULPF3_init() has to be called first.

Parameters

[in]	matA	a pointer to input matrix A
[in]	matB	a pointer to input matrix B
[out]	result	a pointer to a matrix where the output will be placed

Note

See ti_drivers_APU_DataManagement for directions on efficient APU memory management.

Returns

A status code indicating whether the APU operation was a success.

Return values

APULPF3_STATUS_SUCCESS	The call was successful.
APULPF3_STATUS_ERROR	The input matrices were incompatible, i.e. the number of colums in matA were not equal to the number of rows in matB.

APULPF3_matrixSum()

int_fast16_t APULPF3_matrixSum	(	APULPF3_ComplexMatrix *	matA,
		APULPF3_ComplexMatrix *	matB,
		APULPF3_ComplexMatrix *	result
	)

APU function for adding two matrices. The matrices must be of exact same sizes.

Defined as:

C[MxN] = A[MxN] + B[MxN]

in which A, B, and C are complex matrices with size [MxN].

Precondition

APULPF3_init() has to be called first.

Parameters

[in]	matA	a pointer to input matrix A
[in]	matB	a pointer to input matrix B
[out]	result	a pointer to a matrix where the output will be placed

Note

See ti_drivers_APU_DataManagement for directions on efficient APU memory management.

Returns

A status code indicating whether the APU operation was a success.

Return values

APULPF3_STATUS_SUCCESS	The call was successful.
APULPF3_STATUS_ERROR	The input matrices were incompatible, i.e. the matrices were not of the exact same size.

APULPF3_matrixScalarSum()

int_fast16_t APULPF3_matrixScalarSum	(	APULPF3_ComplexMatrix *	mat,
		float complex *	scalar,
		APULPF3_ComplexMatrix *	result
	)

APU function for adding a scalar to a each of a matrix' elements.

Defined as:

C[MxN] = _a_ + B[MxN]

in which a is a scalar and B, and C are complex matrices with size [MxN].

Precondition

APULPF3_init() has to be called first.

Parameters

[in]	mat	a pointer to input matrix A
[in]	scalar	a pointer to a scalar
[out]	result	a pointer to a matrix where the output will be placed

Note

See ti_drivers_APU_DataManagement for directions on efficient APU memory management.

Returns

A status code indicating whether the APU operation was a success.

Return values

APULPF3_STATUS_SUCCESS

The call was successful.

APULPF3_matrixScalarMult()

int_fast16_t APULPF3_matrixScalarMult	(	APULPF3_ComplexMatrix *	mat,
		float complex *	scalar,
		APULPF3_ComplexMatrix *	result
	)

APU function for multiplying each of a matrix' elements by a scalar.

Defined as:

C[MxN] = _a_ * B[MxN]

in which a is a scalar and B, and C are complex matrices with size [MxN].

Precondition

APULPF3_init() has to be called first.

Parameters

[in]	mat	a pointer to input matrix A
[in]	scalar	a pointer to a scalar
[out]	result	a pointer to a matrix where the output will be placed

Note

See ti_drivers_APU_DataManagement for directions on efficient APU memory management.

Returns

A status code indicating whether the APU operation was a success.

Return values

APULPF3_STATUS_SUCCESS

The call was successful.

APULPF3_matrixNorm()

int_fast16_t APULPF3_matrixNorm	(	APULPF3_ComplexMatrix *	mat,
		float complex *	result
	)

Compute the Frobenius norm of a matrix.

Defined as:

_c_ = ||X|| = sqrt(sum(xij * xij')), i = 1 to M and j = 1 to N

in which, X[MxN] is the input matrix and c is the Frobenius norm.

Parameters

[in]	mat	the input matrix
[out]	result	a pointer where the output will be placed

Note

See ti_drivers_APU_DataManagement for directions on efficient APU memory management.

Returns

A status code indicating whether the APU operation was a success.

Return values

APULPF3_STATUS_SUCCESS

The call was successful.