
dcpad(1)                     Khoros                      dcpad(1)

PROGRAM
     dcpad - 1D Constant Pad.

SYNTAX
     dcpad

     -i             input data file (xviff file)

     -o             resulting output file (xviff file)

     [-l]           length of file to be generated

     [-p]           number of constant values at the beginning of
                    data sequence

     [-j]           real constant value for padding

     [-k]           imaginary constant value for padding

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

     [-V]           Gives the version for dcpad

     [-U]           Gives the usage for dcpad

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     performs a constant value padding of a 1D data sequence. The
     length of the new signal ensemble must be greater or equal
     to the length of the original signals plus the offset.  The
     constant value can be any real or complex number.  Complex
     data is assumed to be in rectangular form.  If the data type
     is real, then the imaginary constant value is ignored.

     Data can be processed with either band or vector orienta-
     tion.  The default data processing direction is in the vec-
     tor direction.  This means that data stored in multiband
     format will be processed as a set of data sequences, where
     each sequence corresponds to a pixel location, and the
     points of each sequence are defined by the bands correspond-
     ing to that 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 data file (xviff file)

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

OPTIONAL ARGUMENTS
     -l     type: integer
            desc: length of file to be generated
            default: 256
            bounds: value > 0

     -p     type: integer
            desc: number of constant values at the beginning of
            data sequence
            default: 0
            bounds: value >= 0

     -j     type: float
            desc: real constant value for padding
            default: 0
            bounds: no range checking

     -k     type: float
            desc: imaginary constant value for padding
            default: 0
            bounds: no range checking

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

EXAMPLES
     dcpad -i input_file -o output_file

     dcpad -i input_file -o output_file -k 3.1436 -l 512 -p 200

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

RESTRICTIONS
     dcpad supports signal ensembles of type float or complex
     only.

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

Khoros                    Release: 1.0                          1

