dllatt(1)

PROGRAM
dllatt - 1D LMS Lattice Predictor Filter

SYNTAX

dllatt

-i  input file (xviff file)

-o  resulting output file (xviff file)

[-s]
    number of stages for the filter

[-c]
    specify the convergence parameter

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

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

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

[-V]
    Gives the version for dllatt

[-U]
    Gives the usage for dllatt

[-P]
    Prompts for command line options

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

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

DESCRIPTION
dllatt 1D LMS 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: complex data is expected to be in rectangular (not polar) form.

dllatt does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dllatt 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.

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

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

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

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

EXAMPLES

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), ldllatt(3)

RESTRICTIONS
works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

dllatt 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.