dgsinc(1)

PROGRAM
dgsinc - Creates a 1d sinc data set.

SYNTAX

dgsinc

-o  resulting image

[-i]
    input value file (xviff file)

[-trigger]
    trigger input

[-v]
    number of data sets

[-n]
    number of points

[-s]
    sampling frequency

[-m]
    maximum signal level

[-f]
    signal frequency

[-b]
    initial delay

[-c]
    orientation (0 - centered, 1 is left justified

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

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

[-V]
    Gives the version for dgsinc

[-U]
    Gives the usage for dgsinc

[-P]
    Prompts for command line options

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

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

DESCRIPTION
creates a one dimensional ensemble of signals (data sets). The image pixel values follow a sinc waveform. The user can specify the frequency, amplitude, sampling frequency, an initial delay, centering option, and signal dimensions.
The centering option allows one of three values: 0 indicates that the sinc should be centered about the midpoint of the data set. For instance, if 256 points are specified, then the center will be at 128. Option 1 is used for left justification. This means that the center will be located at 0, and only the right side of the sinc will be generated.
If a "value file" is specified, it will contain a kernel that describes the signal ensemble to be generated. This is an viff format file. The information for each data set will be contained in a single vector of float type information. The format of the information is as follows:
[<sampling freq.><amplitude><frequency><init. delay><centering>]
where each item enclosed in triangular brackets represents a single float. The information set in square brackets is repeated as a group one per vector. as many times as there are vectors (specified in the first float).
For example if 2 vectors are specified, and the first vector has a sampling frequency of 10.0, an amplitude of 6.0, frequency of 2.0, initial delay of 0, and standard centering; the second vector is identical, except that the amplitude is 3.0, the initial delay is 7, and standard centering then the image data in the "value file" will look like this:
band #1: 10.0 10.0
band #2: 6.0 3.0
band #3: 2.0 2.0
band #4: 0.0 7.0
band #5: 0.0 0.0
The advantage of this "value file" is that it allows the creation of an ensemble of 1D signals that independant of each other. Number of data sets, number of points per data set, data type, and process direction must be entered on the command line, or the defaults can be taken. If more data sets are requested than are specified in the parameter file, then an error will occur. If fewer data sets are requested than are specified, then the unused parameters will be ignored.
A non zero initial delay causes the number of points indicated to be zeroed. After the indicated delay, the sinc signal is generated with a time shift equivalent to the delay specified (i.e. the t=0 line is shifted to the right based on the value of the delay).
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 dgsinc to re-execute when used inside cantata. No image is read from this input.

REQUIRED ARGUMENTS

-o  type: outfile
    desc: resulting image

OPTIONAL ARGUMENTS

-i  type: infile
    desc: input value file (xviff file)

-trigger
    type: infile
    desc: trigger input

-v  type: integer
    desc: number of data sets
    default: 1
    bounds: value > 0

-n  type: integer
    desc: number of points
    default: 256
    bounds: value > 0

-s  type: float
    desc: sampling frequency
    default: 2
    bounds: value > 0.0

-m  type: float
    desc: maximum signal level
    default: 1
    bounds: no range checking

-f  type: float
    desc: signal frequency
    default: 1
    bounds: value > 0.0

-b  type: integer
    desc: initial delay
    default: 0
    bounds: value >= 0

-c  type: boolean
    desc: orientation (0 - centered, 1 is left justified
    default: true

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

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

EXAMPLES
dgsinc -o sinc.xv -v 2 -n 512 -s 10.0 -f 4.0 -m 4.0 -b 2 -d 1
The above command line will cause a file sinc.xv to be created that has two sincs of length 512 with a sampling frequency of 10.0, a sinc frequency of 4.0, amplitude 4.0 an initial delay of two points, stored in band format.

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

RESTRICTIONS
can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type images.

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