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 orientation. The default data processing direction is in the vector 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 corresponding 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 window
    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.