From 9f95ff5b6ba01db09552b84a0ab79607060a2666 Mon Sep 17 00:00:00 2001 From: Ali Labbene Date: Wed, 11 Dec 2019 08:59:21 +0100 Subject: Official ARM version: v5.4.0 Add CMSIS V5.4.0, please refer to index.html available under \docs folder. Note: content of \CMSIS\Core\Include has been copied under \Include to keep the same structure used in existing projects, and thus avoid projects mass update Note: the following components have been removed from ARM original delivery (as not used in ST packages) - CMSIS_EW2018.pdf - .gitattributes - .gitignore - \Device - \CMSIS - \CoreValidation - \DAP - \Documentation - \DoxyGen - \Driver - \Pack - \RTOS\CMSIS_RTOS_Tutorial.pdf - \RTOS\RTX - \RTOS\Template - \RTOS2\RTX - \Utilities - All ARM/GCC projects files are deleted from \DSP, \RTOS and \RTOS2 Change-Id: Ia026c3f0f0d016627a4fb5a9032852c33d24b4d3 --- docs/DSP/html/group__groupMatrix.html | 176 ++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 docs/DSP/html/group__groupMatrix.html (limited to 'docs/DSP/html/group__groupMatrix.html') diff --git a/docs/DSP/html/group__groupMatrix.html b/docs/DSP/html/group__groupMatrix.html new file mode 100644 index 0000000..357135d --- /dev/null +++ b/docs/DSP/html/group__groupMatrix.html @@ -0,0 +1,176 @@ + + + + + +Matrix Functions +CMSIS-DSP: Matrix Functions + + + + + + + + + + + + + + +
+
+ + + + + + + +
+
CMSIS-DSP +  Version 1.5.2 +
+
CMSIS DSP Software Library
+
+
+ +
+
    + +
+
+ + + +
+
+ +
+
+
+ +
+ + + + +
+ +
+ +
+
+Content
+
+
Matrix Functions
+
+
+ + + + + + + + + + + + + + + + + + +

+Content

 Matrix Addition
 
 Complex Matrix Multiplication
 
 Matrix Initialization
 
 Matrix Inverse
 
 Matrix Multiplication
 
 Matrix Scale
 
 Matrix Subtraction
 
 Matrix Transpose
 
+

Description

+

This set of functions provides basic matrix math operations. The functions operate on matrix data structures. For example, the type definition for the floating-point matrix structure is shown below:

+
+    typedef struct
+    {
+      uint16_t numRows;     // number of rows of the matrix.
+      uint16_t numCols;     // number of columns of the matrix.
+      float32_t *pData;     // points to the data of the matrix.
+    } arm_matrix_instance_f32;
+

There are similar definitions for Q15 and Q31 data types.

+

The structure specifies the size of the matrix and then points to an array of data. The array is of size numRows X numCols and the values are arranged in row order. That is, the matrix element (i, j) is stored at:

+
+    pData[i*numCols + j]
+
Init Functions
There is an associated initialization function for each type of matrix data structure. The initialization function sets the values of the internal structure fields. Refer to the function arm_mat_init_f32(), arm_mat_init_q31() and arm_mat_init_q15() for floating-point, Q31 and Q15 types, respectively.
+
Use of the initialization function is optional. However, if initialization function is used then the instance structure cannot be placed into a const data section. To place the instance structure in a const data section, manually initialize the data structure. For example: 
+arm_matrix_instance_f32 S = {nRows, nColumns, pData};
+arm_matrix_instance_q31 S = {nRows, nColumns, pData};
+arm_matrix_instance_q15 S = {nRows, nColumns, pData};
+
where nRows specifies the number of rows, nColumns specifies the number of columns, and pData points to the data array.
+
Size Checking
By default all of the matrix functions perform size checking on the input and output matrices. For example, the matrix addition function verifies that the two input matrices and the output matrix all have the same number of rows and columns. If the size check fails the functions return: 
+    ARM_MATH_SIZE_MISMATCH
+
Otherwise the functions return 
+    ARM_MATH_SUCCESS
+
There is some overhead associated with this matrix size checking. The matrix size checking is enabled via the #define 
+    ARM_MATH_MATRIX_CHECK
+
within the library project settings. By default this macro is defined and size checking is enabled. By changing the project settings and undefining this macro size checking is eliminated and the functions run a bit faster. With size checking disabled the functions always return ARM_MATH_SUCCESS.
+
+
+ + + + -- cgit