LTPDA Toolbox™ contents Method: matrix/mchNoisegen   Method: matrix/modelSelect

Method matrix/mchNoisegenFilter

  MCHNOISEGENFILTER Construct a matrix filter from cross-spectral density matrix
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
  FUNCTION:    mchNoisegenFilter
 
  DESCRIPTION: Construct matrix filter from cross-spectral density. Such a
  filter can be used for multichannel noise generation in combination with
  the mchNoisegen method of the matrix class.
 
 
  CALL:        fil = mchNoisegenFilter(mod, pl)
 
  INPUT:
          mod: is a matrix object containing the model for the target
          cross-spectral density matrix. Elements of mod must be fsdata
          analysis objects.
 
  OUTPUT:
          fil: is a matrix object containing the noise generating filter.
          Such a filter can be used to generate colored noise from
          uncorrelated unitary variance white time series. Fil can be a
          matrix of filterbanks objects or of parfrac objects according to
          the chosen output options.
 
  NOTE:
 
          The cross-spectral matrix is assumed to be frequency by frequency
          of the type:
 
                          / csd11(f)  csd12(f) \
                CSD(f) =  |                    |
                          \ csd21(f)  csd22(f) /
 
 
 
  HISTORY:     22-04-2009 L Ferraioli
               Creation
 
  ------------------------------------------------------------------------
 
  Parameters Description
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Method Details
Access public
Defining Class matrix
Sealed 0
Static 0

Parameter Description

Sets for this method …
Default

Default
no description
Key Default Value Options Description
mchNoisegenFilter
TARGETOBJ 'miir'
  • 'miir'
  • 'parfrac'
 Choose the type of output objects:
  • 'miir' output a matrix containing filterbanks of parallel miir filters
  • 'parfrac' output a matrix containing parafracs objects
FS 1 none The sampling frequency of the discrete filters.
IUNITS '' none The unit to set as input unit for the output filters
OUNITS '' none The unit to set as output unit for the output filters
INITFILTER 1
  • 1
  • 0
 Initialize filters (works only for miir objects) to cope with startup transients.
MAXITER 50 none Maximum number of fit iterations.
POLETYPE 1
  • 1
  • 2
  • 3
 Choose the pole type for fitting initialization:
  • 1 == use real starting poles
  • 2 == generates complex conjugate poles of the type a.*exp(theta*pi*j) with theta = linspace(0,pi,N/2+1)
  • 3 == generates complex conjugate poles of the type a.*exp(theta*pi*j) with theta = linspace(0,pi,N/2+2)
MINORDER 7 none Minimum order to fit with.
MAXORDER 35 none Maximum order to fit with.
WEIGHTS 3
  • 1
  • 2
  • 3
  • 4
 Choose weighting for the fit:
  • 1 == equal weights for each point
  • 2 == weight with 1/abs(model)
  • 3 == weight with 1/abs(model).^2
  • 4 == weight with inverse of the square mean spread of the model
PLOT 0
  • 1
  • 0
 Plot results of each fitting step.
MSEVARTOL 0.10000000000000001 none Mean Squared Error Variation - Check if the realtive variation of the mean squared error is
smaller than the value specified. This option is useful for finding the minimum of Chi squared.
FITTOL 0.01 none Mean Squared Error Value - Check if the mean squared error value
is lower than the value specified.
USESYM 'on'
  • 'on'
  • 'off'
 Use symbolic calculation in eigen-decomposition.
  • 'on' - uses symbolic math toolbox calculation
    for poles stabilization
  • 'off' - perform double-precision calculation
    for poles stabilization
RAND_STREAM [] none Internal MATLAB state of the pseudorandom number generator. You can set the state with a structure which should contain all properties of the MATLAB class RandStream

Example
plist('TARGETOBJ', 'miir', 'FS', [1], 'IUNITS', '', 'OUNITS', '', 'INITFILTER', [true], 'MAXITER', [50], 'POLETYPE', [1], 'MINORDER', [7], 'MAXORDER', [35], 'WEIGHTS', [3], 'PLOT', [false], 'MSEVARTOL', [0.10000000000000001], 'FITTOL', [0.01], 'USESYM', 'on', 'RAND_STREAM', [[]])

back to top back to top

Some information of the method matrix/mchNoisegenFilter are listed below:
Class name matrix
Method name mchNoisegenFilter
Category Signal Processing
Package name ltpda
VCS Version 967b0eec0dece803a81af8ef54ad2f8c784b20b2
Min input args 1
Max input args -1
Min output args 1
Max output args 1
Can be used as modifier 1
Supported numeric types {'double'}



Method: matrix/mchNoisegen  Method: matrix/mchNoisegen   Method: matrix/modelSelect Method: matrix/modelSelect

©LTP Team