
dfilconv(1)                  Khoros                   dfilconv(1)

PROGRAM
     dfilconv - 1D Filter Coefficient Conversion

SYNTAX
     dfilconv

     -i             input file (xviff file)

     -o             resulting output file (xviff file)

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

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

     [-t]           type of conversion to be performed:
                    0 (choose lattice to transversal filter
                    conversion (default)),
                    or 1 (choose transversal to lattice filter
                    conversion)
                       [default = 0]

     [-V]           Gives the version for dfilconv

     [-U]           Gives the usage for dfilconv

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     dfilconv 1D Filter Coefficient Conversion.  Converts 1D
     filter coefficients from the transversal (tapped-delay)
     filter realization to the lattice realization and vice
     versa.  It can operate on Real and Complex data.  If complex
     data, the user has the option of using complex arithmetic or
     scalar arithmetic (treat the real number and imaginary
     number independently).

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

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

     -t     type: integer
            desc: type of conversion to be performed
            allowed values:
            0 (choose lattice to transversal filter conversion
            (default)),
            or 1 (choose transversal to lattice filter conver-
            sion)

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

RESTRICTIONS
     works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

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

     dfilconv does not expect input transversal weights to
     include the first 1 weight.  Likewise when converting from
     lattice weights to transversal weights, it will not output
     that first weight.

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

Khoros                    Release: 1.0                          1

