diff --git a/main/CFFTQ15.gif b/main/CFFTQ15.gif deleted file mode 100644 index 904a6d90..00000000 Binary files a/main/CFFTQ15.gif and /dev/null differ diff --git a/main/CFFTQ31.gif b/main/CFFTQ31.gif deleted file mode 100644 index 12b74262..00000000 Binary files a/main/CFFTQ31.gif and /dev/null differ diff --git a/main/CIFFTQ15.gif b/main/CIFFTQ15.gif deleted file mode 100644 index 57c16f63..00000000 Binary files a/main/CIFFTQ15.gif and /dev/null differ diff --git a/main/CIFFTQ31.gif b/main/CIFFTQ31.gif deleted file mode 100644 index 59852e26..00000000 Binary files a/main/CIFFTQ31.gif and /dev/null differ diff --git a/main/ChangeLog_pg.html b/main/ChangeLog_pg.html index 0c5d1929..7bd1173d 100644 --- a/main/ChangeLog_pg.html +++ b/main/ChangeLog_pg.html @@ -127,6 +127,10 @@ $(document).ready(function(){initNavTree('ChangeLog_pg.html',''); initResizable( Version Description +1.11.0

Improved documentation.

+

QR decomposition using Householder transform.

+ + 1.10.1 First release with new repository diff --git a/main/ConvolutionEquation.gif b/main/ConvolutionEquation.gif deleted file mode 100644 index d4334fa4..00000000 Binary files a/main/ConvolutionEquation.gif and /dev/null differ diff --git a/main/CorrelateEquation.gif b/main/CorrelateEquation.gif deleted file mode 100644 index 1a62fb17..00000000 Binary files a/main/CorrelateEquation.gif and /dev/null differ diff --git a/main/DCT4Equation.gif b/main/DCT4Equation.gif deleted file mode 100644 index b6d16cfc..00000000 Binary files a/main/DCT4Equation.gif and /dev/null differ diff --git a/main/IDCT4Equation.gif b/main/IDCT4Equation.gif deleted file mode 100644 index ad665199..00000000 Binary files a/main/IDCT4Equation.gif and /dev/null differ diff --git a/main/MatrixAddition.gif b/main/MatrixAddition.gif deleted file mode 100644 index d754c82f..00000000 Binary files a/main/MatrixAddition.gif and /dev/null differ diff --git a/main/MatrixInverse.gif b/main/MatrixInverse.gif deleted file mode 100644 index fb8e5bd1..00000000 Binary files a/main/MatrixInverse.gif and /dev/null differ diff --git a/main/MatrixScale.gif b/main/MatrixScale.gif deleted file mode 100644 index 6478d688..00000000 Binary files a/main/MatrixScale.gif and /dev/null differ diff --git a/main/MatrixSubtraction.gif b/main/MatrixSubtraction.gif deleted file mode 100644 index 933b9f45..00000000 Binary files a/main/MatrixSubtraction.gif and /dev/null differ diff --git a/main/MatrixTranspose.gif b/main/MatrixTranspose.gif deleted file mode 100644 index 219220e4..00000000 Binary files a/main/MatrixTranspose.gif and /dev/null differ diff --git a/main/dct4FormatsQ15Table.gif b/main/dct4FormatsQ15Table.gif deleted file mode 100644 index 050999cb..00000000 Binary files a/main/dct4FormatsQ15Table.gif and /dev/null differ diff --git a/main/dct4FormatsQ31Table.gif b/main/dct4FormatsQ31Table.gif deleted file mode 100644 index 74911877..00000000 Binary files a/main/dct4FormatsQ31Table.gif and /dev/null differ diff --git a/main/dct4NormalizingF32Table.gif b/main/dct4NormalizingF32Table.gif deleted file mode 100644 index f3536b8c..00000000 Binary files a/main/dct4NormalizingF32Table.gif and /dev/null differ diff --git a/main/dct4NormalizingQ15Table.gif b/main/dct4NormalizingQ15Table.gif deleted file mode 100644 index 625a4189..00000000 Binary files a/main/dct4NormalizingQ15Table.gif and /dev/null differ diff --git a/main/dct4NormalizingQ31Table.gif b/main/dct4NormalizingQ31Table.gif deleted file mode 100644 index 22d1f658..00000000 Binary files a/main/dct4NormalizingQ31Table.gif and /dev/null differ diff --git a/main/deprecated.html b/main/deprecated.html index c75cb364..d3942f48 100644 --- a/main/deprecated.html +++ b/main/deprecated.html @@ -127,41 +127,45 @@ $(document).ready(function(){initNavTree('deprecated.html',''); initResizable();
Global __SIMD32 (addr)
Global arm_cfft_radix2_f16 (const arm_cfft_radix2_instance_f16 *S, float16_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future
+
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future
Global arm_cfft_radix2_f32 (const arm_cfft_radix2_instance_f32 *S, float32_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future
+
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future
Global arm_cfft_radix2_init_f16 (arm_cfft_radix2_instance_f16 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
Global arm_cfft_radix2_init_f32 (arm_cfft_radix2_instance_f32 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
Global arm_cfft_radix2_init_q15 (arm_cfft_radix2_instance_q15 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed
+
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed
Global arm_cfft_radix2_init_q31 (arm_cfft_radix2_instance_q31 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Global arm_cfft_radix2_q15 (const arm_cfft_radix2_instance_q15 *S, q15_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Global arm_cfft_radix2_q31 (const arm_cfft_radix2_instance_q31 *S, q31_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Global arm_cfft_radix4_f16 (const arm_cfft_radix4_instance_f16 *S, float16_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
Global arm_cfft_radix4_f32 (const arm_cfft_radix4_instance_f32 *S, float32_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
Global arm_cfft_radix4_init_f16 (arm_cfft_radix4_instance_f16 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superceded by arm_cfft_f16 and will be removed in the future.
+
Do not use this function. It has been superceded by arm_cfft_f16 and will be removed in the future.
Global arm_cfft_radix4_init_f32 (arm_cfft_radix4_instance_f32 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superceded by arm_cfft_f32 and will be removed in the future.
+
Do not use this function. It has been superceded by arm_cfft_f32 and will be removed in the future.
Global arm_cfft_radix4_init_q15 (arm_cfft_radix4_instance_q15 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Global arm_cfft_radix4_init_q31 (arm_cfft_radix4_instance_q31 *S, uint16_t fftLen, uint8_t ifftFlag, uint8_t bitReverseFlag)
-
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Global arm_cfft_radix4_q15 (const arm_cfft_radix4_instance_q15 *S, q15_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Global arm_cfft_radix4_q31 (const arm_cfft_radix4_instance_q31 *S, q31_t *pSrc)
-
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Global arm_rfft_f32 (const arm_rfft_instance_f32 *S, float32_t *pSrc, float32_t *pDst)
-
Do not use this function. It has been superceded by arm_rfft_fast_f32 and will be removed in the future.
+
Do not use this function. It has been superceded by arm_rfft_fast_f32 and will be removed in the future.
Global arm_rfft_init_f32 (arm_rfft_instance_f32 *S, arm_cfft_radix4_instance_f32 *S_CFFT, uint32_t fftLenReal, uint32_t ifftFlagR, uint32_t bitReverseFlag)
-
Do not use this function. It has been superceded by arm_rfft_fast_init_f32 and will be removed in the future.
+
Do not use this function. It has been superceded by arm_rfft_fast_init_f32 and will be removed in the future.
+
Module FIR_Lattice
+
Those functions are no more tested nor maintained and will be removed in a future version.
+
Module FIR_Sparse
+
Those functions are no more tested nor maintained and will be removed in a future version.
diff --git a/main/footer.js b/main/footer.js index cd664a43..93b2e706 100644 --- a/main/footer.js +++ b/main/footer.js @@ -1,7 +1,7 @@ function writeHeader() { - document.write('Version 1.10.2-dev20'); + document.write('Version 1.11.0'); }; function writeFooter() { - document.write('Generated on Tue Aug 2 2022 05:26:22 for CMSIS-DSP 1.10.2-dev20+g2bd5292. Copyright © 2022 Arm Limited (or its affiliates). All rights reserved.'); + document.write('Generated on Wed Aug 3 2022 08:10:09 for CMSIS-DSP 1.11.0. Copyright © 2022 Arm Limited (or its affiliates). All rights reserved.'); }; diff --git a/main/group__ComplexFFT.html b/main/group__ComplexFFT.html index 3873e46b..0f2461c4 100644 --- a/main/group__ComplexFFT.html +++ b/main/group__ComplexFFT.html @@ -818,7 +818,7 @@ Functions
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future
Parameters
@@ -855,7 +855,7 @@ Functions
[in]Spoints to an instance of the floating-point Radix-2 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future
Parameters
@@ -904,7 +904,7 @@ Functions
[in]Spoints to an instance of the floating-point Radix-2 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
Parameters
@@ -971,7 +971,7 @@ Functions
[in,out]Spoints to an instance of the floating-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
Parameters
@@ -1038,7 +1038,7 @@ Functions
[in,out]Spoints to an instance of the floating-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed
Parameters
@@ -1105,7 +1105,7 @@ Functions
[in,out]Spoints to an instance of the Q15 CFFT/CIFFT structure.
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Parameters
@@ -1160,7 +1160,7 @@ Functions
[in,out]Spoints to an instance of the Q31 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Parameters
@@ -1197,7 +1197,7 @@ Functions
[in]Spoints to an instance of the fixed-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Parameters
@@ -1234,7 +1234,7 @@ Functions
[in]Spoints to an instance of the fixed-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f16 and will be removed in the future.
Parameters
@@ -1271,7 +1271,7 @@ Functions
[in]Spoints to an instance of the floating-point Radix-4 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_f32 and will be removed in the future.
Parameters
@@ -1320,7 +1320,7 @@ Functions
[in]Spoints to an instance of the floating-point Radix-4 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superceded by arm_cfft_f16 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superceded by arm_cfft_f16 and will be removed in the future.
Parameters
@@ -1387,7 +1387,7 @@ Functions
[in,out]Spoints to an instance of the floating-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superceded by arm_cfft_f32 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superceded by arm_cfft_f32 and will be removed in the future.
Parameters
@@ -1454,7 +1454,7 @@ Functions
[in,out]Spoints to an instance of the floating-point CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Parameters
@@ -1521,7 +1521,7 @@ Functions
[in,out]Spoints to an instance of the Q15 CFFT/CIFFT structure
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Parameters
@@ -1576,7 +1576,7 @@ Functions
[in,out]Spoints to an instance of the Q31 CFFT/CIFFT structure.
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q15 and will be removed in the future.
Parameters
@@ -1586,15 +1586,31 @@ Functions
Returns
none
Input and output formats:
Internally input is downscaled by 2 for every stage to avoid saturations inside CFFT/CIFFT process. Hence the output format is different for different FFT sizes. The input and output formats for different FFT sizes and number of bits to upscale are mentioned in the tables below for CFFT and CIFFT:
-
- -
-Input and Output Formats for Q15 CFFT
-
- -
-Input and Output Formats for Q15 CIFFT
-
+
+
[in]Spoints to an instance of the Q15 CFFT/CIFFT structure.
+ + + + + + + + + + +
CFFT Size Input format Output format Number of bits to upscale
16 1.15 5.11 4
64 1.15 7.9 6
256 1.15 9.7 8
1024 1.15 11.5 10
+ + + + + + + + + + + +
CIFFT Size Input format Output format Number of bits to upscale
16 1.15 5.11 0
64 1.15 7.9 0
256 1.15 9.7 0
1024 1.15 11.5 0
@@ -1623,7 +1639,7 @@ Input and Output Formats for Q15 CIFFT
-
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superseded by arm_cfft_q31 and will be removed in the future.
Parameters
@@ -1633,15 +1649,31 @@ Input and Output Formats for Q15 CIFFT
Returns
none
Input and output formats:
Internally input is downscaled by 2 for every stage to avoid saturations inside CFFT/CIFFT process. Hence the output format is different for different FFT sizes. The input and output formats for different FFT sizes and number of bits to upscale are mentioned in the tables below for CFFT and CIFFT:
-
- -
-Input and Output Formats for Q31 CFFT
-
- -
-Input and Output Formats for Q31 CIFFT
-
+
+
[in]Spoints to an instance of the Q31 CFFT/CIFFT structure
+ + + + + + + + + + +
CFFT Size Input format Output format Number of bits to upscale
16 1.31 5.27 4
64 1.31 7.25 6
256 1.31 9.23 8
1024 1.31 11.21 10
+ + + + + + + + + + + +
CIFFT Size Input format Output format Number of bits to upscale
16 1.31 5.27 0
64 1.31 7.25 0
256 1.31 9.23 0
1024 1.31 11.21 0
diff --git a/main/group__Conv.html b/main/group__Conv.html index ac287aad..6551e302 100644 --- a/main/group__Conv.html +++ b/main/group__Conv.html @@ -158,18 +158,20 @@ Functions

Description

Convolution is a mathematical operation that operates on two finite length vectors to generate a finite length output vector. Convolution is similar to correlation and is frequently used in filtering and data analysis. The CMSIS DSP library contains functions for convolving Q7, Q15, Q31, and floating-point data types. The library also provides fast versions of the Q15 and Q31 functions.

-
Algorithm
Let a[n] and b[n] be sequences of length srcALen and srcBLen samples respectively. Then the convolution
-    c[n] = a[n] * b[n]
- 
-
is defined as
- -
+
Algorithm
Let a[n] and b[n] be sequences of length srcALen and srcBLen samples respectively. Then the convolution

+\[ c[n] = a[n] * b[n] \] +

+
+
is defined as

+\[ c[n] = \sum_{k=0}^{srcALen} a[k] b[n-k] \] +

Note that c[n] is of length srcALen + srcBLen - 1 and is defined over the interval n=0, 1, 2, ..., srcALen + srcBLen - 2. pSrcA points to the first input vector of length srcALen and pSrcB points to the second input vector of length srcBLen. The output result is written to pDst and the calling function must allocate srcALen+srcBLen-1 words for the result.
Conceptually, when two signals a[n] and b[n] are convolved, the signal b[n] slides over a[n]. For each offset n, the overlapping portions of a[n] and b[n] are multiplied and summed together.
-
Note that convolution is a commutative operation:
-    a[n] * b[n] = b[n] * a[n].
- 
+
Note that convolution is a commutative operation:

+\[ a[n] * b[n] = b[n] * a[n]. \] +

+
This means that switching the A and B arguments to the convolution functions has no effect.
Fixed-Point Behavior
Convolution requires summing up a large number of intermediate products. As such, the Q7, Q15, and Q31 functions run a risk of overflow and saturation. Refer to the function specific documentation below for further details of the particular algorithm used.
Fast Versions
Fast versions are supported for Q31 and Q15. Cycles for Fast versions are less compared to Q31 and Q15 of conv and the design requires the input signals should be scaled down to avoid intermediate overflows.
diff --git a/main/group__Corr.html b/main/group__Corr.html index e22a7826..26f1bfae 100644 --- a/main/group__Corr.html +++ b/main/group__Corr.html @@ -164,14 +164,17 @@ Functions

Description

Correlation is a mathematical operation that is similar to convolution. As with convolution, correlation uses two signals to produce a third signal. The underlying algorithms in correlation and convolution are identical except that one of the inputs is flipped in convolution. Correlation is commonly used to measure the similarity between two signals. It has applications in pattern recognition, cryptanalysis, and searching. The CMSIS library provides correlation functions for Q7, Q15, Q31 and floating-point data types. Fast versions of the Q15 and Q31 functions are also provided.

-
Algorithm
Let a[n] and b[n] be sequences of length srcALen and srcBLen samples respectively. The convolution of the two signals is denoted by
-    c[n] = a[n] * b[n]
-
In correlation, one of the signals is flipped in time
-     c[n] = a[n] * b[-n]
-
-
and this is mathematically defined as
- -
+
Algorithm
Let a[n] and b[n] be sequences of length srcALen and srcBLen samples respectively. The convolution of the two signals is denoted by

+\[ c[n] = a[n] * b[n] \] +

+
+

In correlation, one of the signals is flipped in time

+

+\[ c[n] = a[n] * b[-n] \] +

+
and this is mathematically defined as

+\[ c[n] = \sum_{k=0}^{srcALen} a[k] b[k-n] \] +

The pSrcA points to the first input vector of length srcALen and pSrcB points to the second input vector of length srcBLen. The result c[n] is of length 2 * max(srcALen, srcBLen) - 1 and is defined over the interval n=0, 1, 2, ..., (2 * max(srcALen, srcBLen) - 2). The output result is written to pDst and the calling function must allocate 2 * max(srcALen, srcBLen) - 1 words for the result.
Note
The pDst should be initialized to all zeros before being used.
diff --git a/main/group__DCT4__IDCT4.html b/main/group__DCT4__IDCT4.html index 8dcb8d28..f8165557 100644 --- a/main/group__DCT4__IDCT4.html +++ b/main/group__DCT4__IDCT4.html @@ -165,13 +165,13 @@ Functions
Discrete Cosine Transform - type-IV
-
Algorithm
The N-point type-IV DCT is defined as a real, linear transformation by the formula:
- -
+
Algorithm
The N-point type-IV DCT is defined as a real, linear transformation by the formula:

+\[ X_c(k) = \sqrt{\frac{2}{N}}\sum_{n=0}^{N-1} x(n)cos\Big[\Big(n+\frac{1}{2}\Big)\Big(k+\frac{1}{2}\Big)\frac{\pi}{N}\Big] \] +

where k = 0, 1, 2, ..., N-1
-
Its inverse is defined as follows:
- -
+
Its inverse is defined as follows:

+\[ x(n) = \sqrt{\frac{2}{N}}\sum_{k=0}^{N-1} X_c(k)cos\Big[\Big(n+\frac{1}{2}\Big)\Big(k+\frac{1}{2}\Big)\frac{\pi}{N}\Big] \] +

where n = 0, 1, 2, ..., N-1
The DCT4 matrices become involutory (i.e. they are self-inverse) by multiplying with an overall scale factor of sqrt(2/N). The symmetry of the transform matrix indicates that the fast algorithms for the forward and inverse transform computation are identical. Note that the implementation of Inverse DCT4 and DCT4 is same, hence same process function can be used for both.
Lengths supported by the transform:
As DCT4 internally uses Real FFT, it supports all the lengths 128, 512, 2048 and 8192. The library provides separate functions for Q15, Q31, and floating-point data types.
@@ -297,10 +297,17 @@ Discrete Cosine Transform - type-IV
Normalizing factor
The normalizing factor is sqrt(2/N), which depends on the size of transform N. Floating-point normalizing factors are mentioned in the table below for different DCT sizes:
-
- -
- + + + + + + + + + +
DCT Size Normalizing factor value
2048 0.03125
512 0.0625
128 0.125
+ @@ -369,10 +376,17 @@ Discrete Cosine Transform - type-IV
Normalizing factor
The normalizing factor is sqrt(2/N), which depends on the size of transform N. Normalizing factors in 1.15 format are mentioned in the table below for different DCT sizes:
-
- -
- + + + + + + + + + +
DCT Size Normalizing factor value (hexadecimal)
2048 0x400
512 0x800
128 0x1000
+ @@ -441,10 +455,17 @@ Discrete Cosine Transform - type-IV
Normalizing factor:
The normalizing factor is sqrt(2/N), which depends on the size of transform N. Normalizing factors in 1.31 format are mentioned in the table below for different DCT sizes:
-
- -
- + + + + + + + + + +
DCT Size Normalizing factor value (hexadecimal)
2048 0x4000000
512 0x8000000
128 0x10000000
+ @@ -488,10 +509,17 @@ Discrete Cosine Transform - type-IV
Returns
none
Input an output formats
Internally inputs are downscaled in the RFFT process function to avoid overflows. Number of bits downscaled, depends on the size of the transform. The input and output formats for different DCT sizes and number of bits to upscale are mentioned in the table below:
-
- -
- + + + + + + + + + +
DCT Size Input format Output format Number of bits to upscale
2048 1.15 11.5 10
512 1.15 9.7 8
128 1.15 7.9 6
+ @@ -535,10 +563,17 @@ Discrete Cosine Transform - type-IV
Returns
none
Input an output formats
Input samples need to be downscaled by 1 bit to avoid saturations in the Q31 DCT process, as the conversion from DCT2 to DCT4 involves one subtraction. Internally inputs are downscaled in the RFFT process function to avoid overflows. Number of bits downscaled, depends on the size of the transform. The input and output formats for different DCT sizes and number of bits to upscale are mentioned in the table below:
-
- -
- + + + + + + + + + +
DCT Size Input format Output format Number of bits to upscale
2048 2.30 12.20 11
512 2.30 10.22 9
128 2.30 8.24 7
+ diff --git a/main/group__FIR__Lattice.html b/main/group__FIR__Lattice.html index 86d7b4fa..939df3da 100644 --- a/main/group__FIR__Lattice.html +++ b/main/group__FIR__Lattice.html @@ -148,6 +148,7 @@ Functions  

Description

+
Deprecated:
Those functions are no more tested nor maintained and will be removed in a future version.

This set of functions implements Finite Impulse Response (FIR) lattice filters for Q15, Q31 and floating-point data types. Lattice filters are used in a variety of adaptive filter applications. The filter structure is feedforward and the net impulse response is finite length. The functions operate on blocks of input and output data and each call to the function processes blockSize samples through the filter. pSrc and pDst point to input and output arrays containing blockSize values.

Algorithm
diff --git a/main/group__FIR__Sparse.html b/main/group__FIR__Sparse.html index 9564a0b9..4d922ce0 100644 --- a/main/group__FIR__Sparse.html +++ b/main/group__FIR__Sparse.html @@ -154,6 +154,7 @@ Functions  

Description

+
Deprecated:
Those functions are no more tested nor maintained and will be removed in a future version.

This group of functions implements sparse FIR filters. Sparse FIR filters are equivalent to standard FIR filters except that most of the coefficients are equal to zero. Sparse filters are used for simulating reflections in communications and audio applications.

There are separate functions for Q7, Q15, Q31, and floating-point data types. The functions operate on blocks of input and output data and each call to the function processes blockSize samples through the filter. pSrc and pDst points to input and output arrays respectively containing blockSize values.

Algorithm
The sparse filter instant structure contains an array of tap indices pTapDelay which specifies the locations of the non-zero coefficients. This is in addition to the coefficient array b. The implementation essentially skips the multiplications by zero and leads to an efficient realization.
diff --git a/main/group__MatrixAdd.html b/main/group__MatrixAdd.html
index 9a6fa079..70ae1e3f 100644
--- a/main/group__MatrixAdd.html
+++ b/main/group__MatrixAdd.html
@@ -142,10 +142,10 @@ Functions
  
 
 

Description

-

Adds two matrices.

- -
-Addition of two 3 x 3 matrices
+

Adds two matrices.

Addition of two 3 x 3 matrices
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} \\ a_{2,1} & a_{2,2} & a_{2,3} \\ a_{3,1} & a_{3,2} & a_{3,3} \\ \end{pmatrix} + \begin{pmatrix} b_{1,1} & b_{1,2} & b_{1,3} \\ b_{2,1} & b_{2,2} & b_{2,3} \\ b_{3,1} & b_{3,2} & b_{3,3} \\ \end{pmatrix} = \begin{pmatrix} a_{1,1}+b_{1,1} & a_{1,2}+b_{1,2} & a_{1,3}+b_{1,3} \\ a_{2,1}+b_{2,1} & a_{2,2}+b_{2,2} & a_{2,3}+b_{2,3} \\ a_{3,1}+b_{3,1} & a_{3,2}+b_{3,2} & a_{3,3}+b_{3,3} \\ \end{pmatrix} \] +

The functions check to make sure that pSrcA, pSrcB, and pDst have the same number of rows and columns.

Function Documentation

diff --git a/main/group__MatrixComplexTrans.html b/main/group__MatrixComplexTrans.html index b0a9bfad..6a8c4f05 100644 --- a/main/group__MatrixComplexTrans.html +++ b/main/group__MatrixComplexTrans.html @@ -143,10 +143,11 @@ Functions

Description

Tranposes a complex matrix.

-

Transposing an M x N matrix flips it around the center diagonal and results in an N x M matrix.

- -
-Transpose of a 3 x 3 matrix
+

Transposing an M x N matrix flips it around the center diagonal and results in an N x M matrix.

+
Transpose of a 3 x 3 matrix
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} \\ a_{2,1} & a_{2,2} & a_{2,3} \\ a_{3,1} & a_{3,2} & a_{3,3} \\ \end{pmatrix}^T = \begin{pmatrix} a_{1,1} & a_{2,1} & a_{3,1} \\ a_{1,2} & a_{2,2} & a_{3,2} \\ a_{1,3} & a_{2,3} & a_{3,3} \\ \end{pmatrix} \] +

Function Documentation

◆ arm_mat_cmplx_trans_f16()

diff --git a/main/group__MatrixInv.html b/main/group__MatrixInv.html index d9df086d..5806034b 100644 --- a/main/group__MatrixInv.html +++ b/main/group__MatrixInv.html @@ -160,12 +160,12 @@ Functions

Computes the inverse of a matrix.

The inverse is defined only if the input matrix is square and non-singular (the determinant is non-zero). The function checks that the input and output matrices are square and of the same size.

Matrix inversion is numerically sensitive and the CMSIS DSP library only supports matrix inversion of floating-point matrices.

-
Algorithm
The Gauss-Jordan method is used to find the inverse. The algorithm performs a sequence of elementary row-operations until it reduces the input matrix to an identity matrix. Applying the same sequence of elementary row-operations to an identity matrix yields the inverse matrix. If the input matrix is singular, then the algorithm terminates and returns error status ARM_MATH_SINGULAR.
- -
-Matrix Inverse of a 3 x 3 matrix using Gauss-Jordan Method
-
-

Function Documentation

+
Algorithm
The Gauss-Jordan method is used to find the inverse. The algorithm performs a sequence of elementary row-operations until it reduces the input matrix to an identity matrix. Applying the same sequence of elementary row-operations to an identity matrix yields the inverse matrix. If the input matrix is singular, then the algorithm terminates and returns error status ARM_MATH_SINGULAR.
+
Matrix Inverse of a 3 x 3 matrix using Gauss-Jordan Method
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} & | & 1 & 0 & 0\\ a_{2,1} & a_{2,2} & a_{2,3} & | & 0 & 1 & 0\\ a_{3,1} & a_{3,2} & a_{3,3} & | & 0 & 0 & 1\\ \end{pmatrix} \rightarrow \begin{pmatrix} 1 & 0 & 0 & | & x_{1,1} & x_{2,1} & x_{3,1} \\ 0 & 1 & 0 & | & x_{1,2} & x_{2,2} & x_{3,2} \\ 0 & 0 & 1 & | & x_{1,3} & x_{2,3} & x_{3,3} \\ \end{pmatrix} \] +

+

Function Documentation

◆ arm_mat_inverse_f16()

diff --git a/main/group__MatrixScale.html b/main/group__MatrixScale.html index c2a7de51..b3ae1a33 100644 --- a/main/group__MatrixScale.html +++ b/main/group__MatrixScale.html @@ -142,10 +142,11 @@ Functions  

Description

-

Multiplies a matrix by a scalar. This is accomplished by multiplying each element in the matrix by the scalar. For example:

- -
-Matrix Scaling of a 3 x 3 matrix
+

Multiplies a matrix by a scalar. This is accomplished by multiplying each element in the matrix by the scalar. For example:

+
Matrix Scaling of a 3 x 3 matrix
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} \\ a_{2,1} & a_{2,2} & a_{2,3} \\ a_{3,1} & a_{3,2} & a_{3,3} \\ \end{pmatrix} K = \begin{pmatrix} K a_{1,1} & K a_{1,2} & K a_{1,3} \\ K a_{2,1} & K a_{2,2} & K a_{2,3} \\ K a_{3,1} & K a_{3,2} & K a_{3,3} \\ \end{pmatrix} \] +

The function checks to make sure that the input and output matrices are of the same size.

In the fixed-point Q15 and Q31 functions, scale is represented by a fractional multiplication scaleFract and an arithmetic shift shift. The shift allows the gain of the scaling operation to exceed 1.0. The overall scale factor applied to the fixed-point data is

     scale = scaleFract * 2^shift.
diff --git a/main/group__MatrixSub.html b/main/group__MatrixSub.html
index 4561800f..599a899e 100644
--- a/main/group__MatrixSub.html
+++ b/main/group__MatrixSub.html
@@ -145,11 +145,11 @@ Functions
  
 
 

Description

-

Subtract two matrices.

- -
-Subraction of two 3 x 3 matrices
-

The functions check to make sure that pSrcA, pSrcB, and pDst have the same number of rows and columns.

+

Subtract two matrices.

Subraction of two 3 x 3 matrices
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} \\ a_{2,1} & a_{2,2} & a_{2,3} \\ a_{3,1} & a_{3,2} & a_{3,3} \\ \end{pmatrix} - \begin{pmatrix} b_{1,1} & b_{1,2} & b_{1,3} \\ b_{2,1} & b_{2,2} & b_{2,3} \\ b_{3,1} & b_{3,2} & b_{3,3} \\ \end{pmatrix} = \begin{pmatrix} a_{1,1}-b_{1,1} & a_{1,2}-b_{1,2} & a_{1,3}-b_{1,3} \\ a_{2,1}-b_{2,1} & a_{2,2}-b_{2,2} & a_{2,3}-b_{2,3} \\ a_{3,1}-b_{3,1} & a_{3,2}-b_{3,2} & a_{3,3}-b_{3,3} \\ \end{pmatrix} \] +

+

The functions check to make sure that pSrcA, pSrcB, and pDst have the same number of rows and columns.

Function Documentation

◆ arm_mat_sub_f16()

diff --git a/main/group__MatrixTrans.html b/main/group__MatrixTrans.html index 6ab7f291..79485e6b 100644 --- a/main/group__MatrixTrans.html +++ b/main/group__MatrixTrans.html @@ -149,10 +149,11 @@ Functions

Description

Tranposes a matrix.

-

Transposing an M x N matrix flips it around the center diagonal and results in an N x M matrix.

- -
-Transpose of a 3 x 3 matrix
+

Transposing an M x N matrix flips it around the center diagonal and results in an N x M matrix.

+
Transpose of a 3 x 3 matrix
+

+\[ \begin{pmatrix} a_{1,1} & a_{1,2} & a_{1,3} \\ a_{2,1} & a_{2,2} & a_{2,3} \\ a_{3,1} & a_{3,2} & a_{3,3} \\ \end{pmatrix}^T = \begin{pmatrix} a_{1,1} & a_{2,1} & a_{3,1} \\ a_{1,2} & a_{2,2} & a_{3,2} \\ a_{1,3} & a_{2,3} & a_{3,3} \\ \end{pmatrix} \] +

Function Documentation

◆ arm_mat_trans_f16()

diff --git a/main/group__RealFFT.html b/main/group__RealFFT.html index 2b7ec13a..ef591a2c 100644 --- a/main/group__RealFFT.html +++ b/main/group__RealFFT.html @@ -240,7 +240,7 @@ Real Inverse Fast Fourier Transform
-
Deprecated:
Do not use this function. It has been superceded by arm_rfft_fast_f32 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superceded by arm_rfft_fast_f32 and will be removed in the future.
Parameters
@@ -585,7 +585,7 @@ Real Inverse Fast Fourier Transform
[in]Spoints to an instance of the floating-point RFFT/RIFFT structure
-
Deprecated:
Do not use this function. It has been superceded by arm_rfft_fast_init_f32 and will be removed in the future.
+
Deprecated:
Do not use this function. It has been superceded by arm_rfft_fast_init_f32 and will be removed in the future.
Parameters
diff --git a/version.js b/version.js index 96acc83b..cd5c0ba4 100644 --- a/version.js +++ b/version.js @@ -1,6 +1,6 @@ //--- list of versions --- const versions = { - "main": "1.10.2-dev20", + "main": "1.11.0", "latest": "1.10.1" } //--- list of versions ---
[in,out]Spoints to an instance of the floating-point RFFT/RIFFT structure