
dmtapp(1)                    Khoros                     dmtapp(1)

PROGRAM
     dmtapp - 1D MLMS Transversal Predictor Filter

SYNTAX
     dmtapp

     -i             input file (xviff file)

     -o             resulting output file (xviff file)

     [-s]           number of weights for the filter

     [-t]           time delay parameter

     [-c]           specify the convergence parameter

     [-b]           specify the smoothing parameter

     [-j]           scalar processing (0) or vector processing
                    (1)

     [-d]           down vectors(0) or across bands(1)

     [-g]           type of output file to be created:
                    0 (choose error sequence ),
                    1 (choose signal estimate sequence),
                    or 2 (choose transversal filter coefficients)
                       [default = 0]

     [-V]           Gives the version for dmtapp

     [-U]           Gives the usage for dmtapp

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called dmtapp.ans or
                    file1

     [-a [file1]]   Uses dmtapp.ans or file1 as the answer file

DESCRIPTION
     dmtapp 1D MLMS Transversal Filter. Generates an error
     sequence, a signal estimate sequence and a weight (transver-
     sal 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.

     For a more theoretical discussion of the MLMS transversal
     algorithm see:  Adaptive Signal Processing, by Bernard
     Widrow and Samuel D. Stearns, Prentice Hall, 1985; or Hand-
     book of Digital Signal Processing: Engineering Applications,
     Edited by Douglas F. Elliott, Academic Press, 1987.

     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 direc-
     tion of processing can be changed so that each band is pro-
     cessed as a signal (instead of each vector being a signal)
     by setting the -d option to 1.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input file (xviff file)

     -o     type: outfile
            desc: resulting output file (xviff file)

OPTIONAL ARGUMENTS
     -s     type: integer
            desc: number of weights for the filter
            default: 1
            bounds: value > 0

     -t     type: integer
            desc: time delay parameter
            default: 0
            bounds: value >= 0

     -c     type: float
            desc: specify the convergence parameter
            default: 0.01
            bounds: 0.000000 < [-c] < 1.000000

     -b     type: float
            desc: specify the smoothing parameter
            default: 0.99
            bounds: 0.000000 < [-b] < 1.000000

     -j     type: boolean
            desc: scalar processing (0) or vector processing (1)
            default: true

     -d     type: boolean
            desc: down vectors(0) or across bands(1)
            default: true

     -g     type: integer
            desc: type of output file to be created
            allowed values:
            0 (choose error sequence ),
            1 (choose signal estimate sequence),
            or 2 (choose transversal filter coefficients)

EXAMPLES
SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ldmtapp(3)

RESTRICTIONS
     works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

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

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

Khoros                    Release: 1.0                          1

