Initial commit
This commit is contained in:
		@ -0,0 +1,4 @@
 | 
			
		||||
CMSIS DSP_Lib example arm_variance_example for
 | 
			
		||||
  Cortex-M0, Cortex-M3, Cortex-M4 with FPU and Cortex-M7 with single precision FPU.
 | 
			
		||||
 | 
			
		||||
The example is configured for uVision Simulator.
 | 
			
		||||
@ -0,0 +1,204 @@
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Copyright (C) 2010-2012 ARM Limited. All rights reserved.
 | 
			
		||||
*
 | 
			
		||||
* $Date:         17. January 2013
 | 
			
		||||
* $Revision:     V1.4.0
 | 
			
		||||
*
 | 
			
		||||
* Project:       CMSIS DSP Library
 | 
			
		||||
* Title:         arm_variance_example_f32.c
 | 
			
		||||
*
 | 
			
		||||
* Description:   Example code demonstrating variance calculation of input sequence.
 | 
			
		||||
*
 | 
			
		||||
* Target Processor: Cortex-M4/Cortex-M3
 | 
			
		||||
*
 | 
			
		||||
* Redistribution and use in source and binary forms, with or without
 | 
			
		||||
* modification, are permitted provided that the following conditions
 | 
			
		||||
* are met:
 | 
			
		||||
*   - Redistributions of source code must retain the above copyright
 | 
			
		||||
*     notice, this list of conditions and the following disclaimer.
 | 
			
		||||
*   - Redistributions in binary form must reproduce the above copyright
 | 
			
		||||
*     notice, this list of conditions and the following disclaimer in
 | 
			
		||||
*     the documentation and/or other materials provided with the
 | 
			
		||||
*     distribution.
 | 
			
		||||
*   - Neither the name of ARM LIMITED nor the names of its contributors
 | 
			
		||||
*     may be used to endorse or promote products derived from this
 | 
			
		||||
*     software without specific prior written permission.
 | 
			
		||||
*
 | 
			
		||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 | 
			
		||||
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 | 
			
		||||
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 | 
			
		||||
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 | 
			
		||||
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 | 
			
		||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 | 
			
		||||
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 | 
			
		||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 | 
			
		||||
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 | 
			
		||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 | 
			
		||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 | 
			
		||||
* POSSIBILITY OF SUCH DAMAGE.
 | 
			
		||||
* -------------------------------------------------------------------- */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @ingroup groupExamples
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @defgroup VarianceExample Variance Example
 | 
			
		||||
 *
 | 
			
		||||
 * \par Description:
 | 
			
		||||
 * \par
 | 
			
		||||
 * Demonstrates the use of Basic Math and Support Functions to calculate the variance of an
 | 
			
		||||
 * input sequence with N samples. Uniformly distributed white noise is taken as input.
 | 
			
		||||
 *
 | 
			
		||||
 * \par Algorithm:
 | 
			
		||||
 * \par
 | 
			
		||||
 * The variance of a sequence is the mean of the squared deviation of the sequence from its mean.
 | 
			
		||||
 * \par
 | 
			
		||||
 * This is denoted by the following equation:
 | 
			
		||||
 * <pre> variance = ((x[0] - x') * (x[0] - x') + (x[1] - x') * (x[1] - x') + ... + * (x[n-1] - x') * (x[n-1] - x')) / (N-1)</pre>
 | 
			
		||||
 * where, <code>x[n]</code> is the input sequence, <code>N</code> is the number of input samples, and
 | 
			
		||||
 * <code>x'</code> is the mean value of the input sequence, <code>x[n]</code>.
 | 
			
		||||
 * \par
 | 
			
		||||
 * The mean value <code>x'</code> is defined as:
 | 
			
		||||
 * <pre> x' = (x[0] + x[1] + ... + x[n-1]) / N</pre>
 | 
			
		||||
 *
 | 
			
		||||
 * \par Block Diagram:
 | 
			
		||||
 * \par
 | 
			
		||||
 * \image html Variance.gif
 | 
			
		||||
 *
 | 
			
		||||
 *
 | 
			
		||||
 * \par Variables Description:
 | 
			
		||||
 * \par
 | 
			
		||||
 * \li \c testInput_f32 points to the input data
 | 
			
		||||
 * \li \c wire1, \c wir2, \c wire3 temporary buffers
 | 
			
		||||
 * \li \c blockSize number of samples processed at a time
 | 
			
		||||
 * \li \c refVarianceOut reference variance value
 | 
			
		||||
 *
 | 
			
		||||
 * \par CMSIS DSP Software Library Functions Used:
 | 
			
		||||
 * \par
 | 
			
		||||
 * - arm_dot_prod_f32()
 | 
			
		||||
 * - arm_mult_f32()
 | 
			
		||||
 * - arm_sub_f32()
 | 
			
		||||
 * - arm_fill_f32()
 | 
			
		||||
 * - arm_copy_f32()
 | 
			
		||||
 *
 | 
			
		||||
 * <b> Refer  </b>
 | 
			
		||||
 * \link arm_variance_example_f32.c \endlink
 | 
			
		||||
 *
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/** \example arm_variance_example_f32.c
 | 
			
		||||
  */
 | 
			
		||||
#include <math.h>
 | 
			
		||||
#include "arm_math.h"
 | 
			
		||||
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Defines each of the tests performed
 | 
			
		||||
* ------------------------------------------------------------------- */
 | 
			
		||||
#define MAX_BLOCKSIZE   32
 | 
			
		||||
#define DELTA           (0.000001f)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Declare I/O buffers
 | 
			
		||||
* ------------------------------------------------------------------- */
 | 
			
		||||
float32_t wire1[MAX_BLOCKSIZE];
 | 
			
		||||
float32_t wire2[MAX_BLOCKSIZE];
 | 
			
		||||
float32_t wire3[MAX_BLOCKSIZE];
 | 
			
		||||
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Test input data for Floating point Variance example for 32-blockSize
 | 
			
		||||
* Generated by the MATLAB randn() function
 | 
			
		||||
* ------------------------------------------------------------------- */
 | 
			
		||||
 | 
			
		||||
float32_t testInput_f32[32] =
 | 
			
		||||
{
 | 
			
		||||
  -0.432564811528221,  -1.665584378238097,   0.125332306474831,   0.287676420358549,
 | 
			
		||||
  -1.146471350681464,   1.190915465642999,   1.189164201652103,  -0.037633276593318,
 | 
			
		||||
   0.327292361408654,   0.174639142820925,  -0.186708577681439,   0.725790548293303,
 | 
			
		||||
  -0.588316543014189,   2.183185818197101,  -0.136395883086596,   0.113931313520810,
 | 
			
		||||
   1.066768211359189,   0.059281460523605,  -0.095648405483669,  -0.832349463650022,
 | 
			
		||||
   0.294410816392640,  -1.336181857937804,   0.714324551818952,   1.623562064446271,
 | 
			
		||||
  -0.691775701702287,   0.857996672828263,   1.254001421602532,  -1.593729576447477,
 | 
			
		||||
  -1.440964431901020,   0.571147623658178,  -0.399885577715363,   0.689997375464345
 | 
			
		||||
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Declare Global variables
 | 
			
		||||
* ------------------------------------------------------------------- */
 | 
			
		||||
uint32_t blockSize = 32;
 | 
			
		||||
float32_t  refVarianceOut = 0.903941793931839;
 | 
			
		||||
 | 
			
		||||
/* ----------------------------------------------------------------------
 | 
			
		||||
* Variance calculation test
 | 
			
		||||
* ------------------------------------------------------------------- */
 | 
			
		||||
 | 
			
		||||
int32_t main(void)
 | 
			
		||||
{
 | 
			
		||||
  arm_status status;
 | 
			
		||||
  float32_t mean, oneByBlockSize;
 | 
			
		||||
  float32_t variance;
 | 
			
		||||
  float32_t diff;
 | 
			
		||||
 | 
			
		||||
  status = ARM_MATH_SUCCESS;
 | 
			
		||||
 | 
			
		||||
  /* Calculation of mean value of input */
 | 
			
		||||
 | 
			
		||||
  /* x' = 1/blockSize * (x(0)* 1 + x(1) * 1 + ... + x(n-1) * 1) */
 | 
			
		||||
 | 
			
		||||
  /* Fill wire1 buffer with 1.0 value */
 | 
			
		||||
  arm_fill_f32(1.0,  wire1, blockSize);
 | 
			
		||||
 | 
			
		||||
  /* Calculate the dot product of wire1 and wire2 */
 | 
			
		||||
  /* (x(0)* 1 + x(1) * 1 + ...+ x(n-1) * 1) */
 | 
			
		||||
  arm_dot_prod_f32(testInput_f32, wire1, blockSize, &mean);
 | 
			
		||||
 | 
			
		||||
  /* Calculation of 1/blockSize */
 | 
			
		||||
  oneByBlockSize = 1.0 / (blockSize);
 | 
			
		||||
 | 
			
		||||
  /* 1/blockSize * (x(0)* 1 + x(1) * 1 + ... + x(n-1) * 1)  */
 | 
			
		||||
  arm_mult_f32(&mean, &oneByBlockSize, &mean, 1);
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
  /* Calculation of variance value of input */
 | 
			
		||||
 | 
			
		||||
  /* (1/blockSize) * (x(0) - x') * (x(0) - x') + (x(1) - x') * (x(1) - x') + ... + (x(n-1) - x') * (x(n-1) - x') */
 | 
			
		||||
 | 
			
		||||
  /* Fill wire2 with mean value x' */
 | 
			
		||||
  arm_fill_f32(mean,  wire2, blockSize);
 | 
			
		||||
 | 
			
		||||
  /* wire3 contains (x-x') */
 | 
			
		||||
  arm_sub_f32(testInput_f32, wire2, wire3, blockSize);
 | 
			
		||||
 | 
			
		||||
  /* wire2 contains (x-x') */
 | 
			
		||||
  arm_copy_f32(wire3, wire2, blockSize);
 | 
			
		||||
 | 
			
		||||
  /* (x(0) - x') * (x(0) - x') + (x(1) - x') * (x(1) - x') + ... + (x(n-1) - x') * (x(n-1) - x') */
 | 
			
		||||
  arm_dot_prod_f32(wire2, wire3, blockSize, &variance);
 | 
			
		||||
 | 
			
		||||
    /* Calculation of 1/blockSize */
 | 
			
		||||
  oneByBlockSize = 1.0 / (blockSize - 1);
 | 
			
		||||
 | 
			
		||||
  /* Calculation of variance */
 | 
			
		||||
  arm_mult_f32(&variance, &oneByBlockSize, &variance, 1);
 | 
			
		||||
 | 
			
		||||
  /* absolute value of difference between ref and test */
 | 
			
		||||
  diff = fabsf(refVarianceOut - variance);
 | 
			
		||||
 | 
			
		||||
  /* Comparison of variance value with reference */
 | 
			
		||||
  if (diff > DELTA)
 | 
			
		||||
  {
 | 
			
		||||
    status = ARM_MATH_TEST_FAILURE;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if ( status != ARM_MATH_SUCCESS)
 | 
			
		||||
  {
 | 
			
		||||
    while (1);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  while (1);                             /* main function does not return */
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 /** \endlink */
 | 
			
		||||
		Reference in New Issue
	
	Block a user