ldmtapp(3)

LIBRARY ROUTINE
ldmtapp - 1D MLMS Transversal Predictor Filter

LIBRARY CALL
#include "vinclude.h"
int ldmtapp ( image, alpha, beta, delay, stages, arith_type, out_option, procdir )
int delay, stages, out_option, arith_type, procdir;
float alpha, beta;
struct xvimage *image;

INPUT

image
    pointer to VIFF structure containing image data to be processed.

alpha
    convergence parameter (0<alpha<1).

beta
    smoothing parameter (0<beta<1), common practice is to have beta = 1-alpha, the optimum value is beta = 2.0/(filter order).

delay
    time delay parameter (delay >= 0).

stages
    used to determine the dimension (length or number of filter coefficients) of the filter. If it is a positive, non-zero integer. Default value is set to 1.

arith_type
    type of arithmetic to be used on complex data. 0 specifies scalar arithmetic and 1 specifies vector arithmetic.

out_option
    specifies the output file to be generated. 0 specifies an error sequence, 1 specifies a signal estimate sequence, and 2 specifies a filter coefficient sequence.

procdir
    process direction: 0 indicated vector oriented processing, 1 indicates band oriented processing.

OUTPUT

image
    pointer to VIFF structure containing image data after processing.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS

Jeremy Worley 05 Mar 1992 10:55 MST
    Added an explicit declaration of propertype() to ldmtapp(). Also added an explicit declaration of the argument delay to lmtapxx().

DESCRIPTION
dmtapp 1D MLMS Transversal Filter. Generates an error sequence, a signal estimate sequence and a weight (transversal or tapped delay filter coefficients) sequence. It is based on the Adaptive Line Enhancer (ALE) configuration, and can be configured to perform as an adaptive predictor filter by setting the delay element to 1. It can operate on Real and Complex data. If complex data, the user has the option of using complex arithmetic (vector) or real arithmetic (scalar = treat the real number and imaginary number independently).

NOTE: complex data is expected to be in rectangular (not polar) form.

dmtapp does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dmtapp works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files.

Input/Output Files

The input file must be of type VFF_TYP_FLOAT or VFF_TYP_COMPLEX. The output file returned will be of size specified by the user. If the data is of type VFF_TYP_COMPLEX and complex aithmetic is selected then the output file will be of type VFF_TYP_FLOAT. *********************************************************************

Process direction

Data can be processed with either band or vector orientation (-d option). The default data processing direction is in the vector direction (-d = 0). pixel location. The direction of processing can be changed so that each band is processed as a signal (instead of each vector being a signal) by setting the -d option to 1.

SEE ALSO
dmtapp(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

ldmtapp does not work on explicit location data and will return an error when such a data file is encountered.

AUTHOR
Ramiro Jordan

COPYRIGHT
Copyright 1992, University of New Mexico. All rights reserved.