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

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

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