
dgwindow(1)                  Khoros                   dgwindow(1)

PROGRAM
     dgwindow - 1D Window Creation.

SYNTAX
     dgwindow

     -o             resulting output file (xviff file)

     [-trigger]     trigger input

     [-s]           number of signals to generate

     [-p]           number of elements per signal

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

     [-t]           lets user choose data type of image:
                     'float' (select data type),
                      or 'complex' (choose data type)
                       [default = float]

     [-V]           Gives the version for dgwindow

     [-U]           Gives the usage for dgwindow

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     1D Window Creation. It creates a 1D data sequence (real or
     complex) based on a user selected window function.  dgwindow
     begins by generating a constant value signal ensemble of the
     desired dimension, with constant value 1.0.  It then applies
     the specified window function to this data set.

     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.

     The trigger input can be used to cause dgwindow to re-
     execute when used inside cantata. No image is read from this
     input.

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

OPTIONAL ARGUMENTS
     -trigger
            type: infile
            desc: trigger input

     -s     type: integer
            desc: number of signals to generate
            default: 1
            bounds: no range checking

     -p     type: integer
            desc: number of elements per signal
            default: 256
            bounds: no range checking

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

     -t     type: string
            desc: lets user choose data type of image
            allowed values:
             'float' (select data type),
              or 'complex' (choose data type)

EXAMPLES
     dgwindow -o output_file

     Right-Exponential window:
     dgwindow -o output_file -w 11  -e -0.75

     Complex Kaiser window:
     dgwindow -o output_file -w 5  -k 2.0 -t complex

     User Defined window:
     dgwindow -o output_file -w 13  -b 128

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ldgwindow(3)
     dwindow

RESTRICTIONS
     dgwindow only creates real or complex data sequences.

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

Khoros                    Release: 1.0                          1

