
dmlatt(1)                    Khoros                     dmlatt(1)

PROGRAM
     dmlatt - 1D MLMS Lattice Predictor Filter

SYNTAX
     dmlatt

     -i             input file (xviff file)

     -o             resulting output file (xviff file)

     [-s]           number of stages for the filter

     [-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 lattice filter coefficients)
                       [default = 0]

     [-V]           Gives the version for dmlatt

     [-U]           Gives the usage for dmlatt

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     dmlatt 1D MLMS Lattice Filter. Generates an error sequence,
     a signal estimate sequence and a PARCOR (lattice filter
     coefficients) sequence.  These coefficients can be used in
     darpsd after a call to dfilconv to generate a power spectrum
     estimate of the input signal.  The filter coefficients can
     be used with the error sequence in dlsynth to resynthesize
     the signal.  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: com-
     plex data is expected to be in rectangular (not polar) form.

     dmlatt does not work on explicit location data and will
     return an error when such a file is encountered.  No output
     file will be created.  dmlatt 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 stages for the filter
            default: 1
            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 lattice filter coefficients)

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

RESTRICTIONS
     works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

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

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

Khoros                    Release: 1.0                          1

