
dwindow(1)                   Khoros                    dwindow(1)

PROGRAM
     dwindow - 1D Window (Apodization) Functions.

SYNTAX
     dwindow

     -i             input data file (xviff file)

     -o             resulting output file (xviff file)

     [-k]           desired THETA parameter for Kaiser window

     [-e]           desired damping parameter for Exponential
                    window

     [-b]           desired window width for User defined window

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

     [-w]           windowed output file to be created:
                    0 (selection of Rectangular window ),
                    1 (selection of Bartlett window ),
                    2 (selection of Hamming window),
                    3 (selection of Hanning window),
                    4 (selection of Parzen window),
                    5 (selection of Kaiser window),
                    6 (selection of Exponential window),
                    7 (selection of Blackman window),
                    8 (selection of Blackman-Harris window),
                    9 (selection of Right-Triangular window),
                    10 (selection of Left-Triangular window),
                    11 (selection of Right-Exponential window),
                    12 (selection of Left-Exponential window),
                    or 13 (selection of Left-Triangular window)
                       [default = 0]

     [-V]           Gives the version for dwindow

     [-U]           Gives the usage for dwindow

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     1D Window (Apodization) Functions. It multiplies a user
     selected 1D data sequence (real or complex) by the appropri-
     ate window function.  The length of the data record is
     expected to be an even number.  NOTE: complex data is
     expected to be in rectangular (not polar) form.

     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
     -k     type: float
            desc: desired THETA parameter for Kaiser window
            default: 1
            bounds: no range checking

     -e     type: float
            desc: desired damping parameter for Exponential win-
            dow
            default: 1
            bounds: value >= 0.0

     -b     type: integer
            desc: desired window width for User defined window
            default: 1
            bounds: value >= 0

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

     -w     type: integer
            desc: windowed output file to be created
            allowed values:
            0 (selection of Rectangular window ),
            1 (selection of Bartlett window ),
            2 (selection of Hamming window),
            3 (selection of Hanning window),
            4 (selection of Parzen window),
            5 (selection of Kaiser window),
            6 (selection of Exponential window),
            7 (selection of Blackman window),
            8 (selection of Blackman-Harris window),
            9 (selection of Right-Triangular window),
            10 (selection of Left-Triangular window),
            11 (selection of Right-Exponential window),
            12 (selection of Left-Exponential window),
            or 13 (selection of Left-Triangular window)

EXAMPLES
     dwindow -i input_file -o output_file

     Right-Exponential window:
     dwindow -i input_file -o output_file -w 11  -e -0.75

     Kaiser window:
     dwindow -i input_file -o output_file -w 5  -k 2.0

     User Defined window:
     dwindow -i input_file -o output_file -w 13  -b 128

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ldwindow(3)
     dgwindow

RESTRICTIONS
     dwindow processes signals of type float or complex only.

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

Khoros                    Release: 1.0                          1

