
dconvo(1)                    Khoros                     dconvo(1)

PROGRAM
     dconvo - Convolution sequence of 1-D signal(s)

SYNTAX
     dconvo

     -i1            input first file (xviff file)

     -i2            input second file (xviff file)

     -o             resulting output file (xviff file)

     [-j]           define arithmetic on data

     [-d]           data processing direction (0 = down vectors,
                    1 = across bands)

     [-g]           type of convolution file to be created( 0 =
                    time tomain, 1 = FFT based):
                    0 (choose time domain convolution estimate),
                    or 1 (choose FFT based circular convolution
                    estimate)
                       [default = 0]

     [-V]           Gives the version for dconvo

     [-U]           Gives the usage for dconvo

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     1D Convolution Estimate. Generates time domain or FFT based
     circular convolution estimate of a data sequence.  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), which is equivalent to treating the
     real number and imaginary parts of the complex pair indepen-
     dently.

     If the FFT based convolution estimate is specified and the
     length of the data sets is not an integral power of two,
     then the data sets will be zero padded to the next integral
     power of two prior to performing the FFT.

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

     The convolution default option is the -g 0 (time domain
     estimate option.

     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).  This means that data stored
     in multiband format will be processed as a set pixel loca-
     tion.  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
     -i1    type: infile
            desc: input first file (xviff file)

     -i2    type: infile
            desc: input second file (xviff file)

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

OPTIONAL ARGUMENTS
     -j     type: boolean
            desc: define arithmetic on data
            default: true

     -d     type: boolean
            desc: data processing direction (0 = down vectors, 1
            = across bands)
            default: true

     -g     type: integer
            desc: type of convolution file to be created( 0 =
            time tomain, 1 = FFT based)
            allowed values:
            0 (choose time domain convolution estimate),
            or 1 (choose FFT based circular convolution estimate)

EXAMPLES
     dconvo -i input_file -o output_file
     Will return a file containing the time domain convolution
     estimate of the input_file.  The data processing direction
     is in the vector direction.

     dconvo -i input_file -o output_file -g 1 -j 1 -d 1
     Will return a file containing the FFT based convolution
     estimate with vector operations of the input_file.  The data
     processing direction is in the band direction.

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

RESTRICTIONS
     works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

     dconvo 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

