input_create1D

Input

create1D, which contains the following modules:
	dgexpon
	dggauss
	dgpoiss
	dgpwl
	dgrleigh
	dgsin
	dgsinc
	dgunif
	dgwindow
Any mention of xvimage is actually a "field 2D".  Also, the INPUTs and

Outputs

 which are mapped to avs parameters, inputs, and outputs, are for the
khoros library routine.
*********************************************************************************
Documentation for avs module dgexpon
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the

Parameter

option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     variance       variance of data set

Type

         data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.

Description

     creates a one dimensional exponential distributed noise data
     set.   The  user  can specify the variance and signal dimen-
     sions.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are specified, and the first vector
     has  a  variance of 1.0, the second vector has a variance of
     6.0, the "parameter file" will look like this:
     band #1:  1.0 6.0
     The advantage of this "parameter file" is that it allows the
     creation  of  an ensemble of 1D signals that are 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.
     The resulting images may be of type FLOAT or COMPLEX.
     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.

See also

     dgexpon(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.

Author

     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dggauss
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     mean           mean of data set
     variance       variance of data set
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional gaussian noise data set.  The user
     can specify the mean, variance, and signal dimensions.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are specified, and the first vector
     has  mean  of 0.0 and variance of 1.0, the second vector has
     mean of 4.0 and variance of 6.0, the "parameter  file"  will
     look like this:
     band #1:  0.0 4.0
     band #2:  1.0 6.0
     The advantage of this "parameter file" is that it allows the
     creation  of  an ensemble of 1D signals that are 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.
     The resulting images may be of type FLOAT or COMPLEX.
     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.
SEE ALSO
     dggauss(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgpoiss
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     variance       variance of data set
     time           time argument for poisson data generation
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional  Poisson  distributed  noise  data
     set.   The user can specify the variance, the time argument,
     and signal dimensions.
     The time argument represents a positive  interval  of  time.
     Each element of the resulting data set represents the number
     of discrete events occuring within that  time  period.   The
     result is an integer data set.  To maintain consistency with

Other

noise  generators  available  in  this  package,  the
     resulting data set can be of type float or complex.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are  specified,  the  first  has  a
     variance  of 1.0 and a time argument of 3.0, the second vec-
     tor has a variance of 6.0 and a time argument  of  4.0,  the
     "parameter file" will look like this:
     band #1:  1.0 6.0
     band #2:  3.0 4.0
     The advantage of this "parameter file" is that it allows the
     creation  of  an ensemble of 1D signals that are 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.
     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.
SEE ALSO
     dgpoiss(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgpwl
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     fs             sampling frequency
     minimum        minimum value of function
     maximum        maximum value of function
     period         period of the function in seconds
     rise           rise time in seconds
     fall           fall time in seconds
     width          width of pulse
     delay          initial delay in number of data points
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional set of signals.  The  image  pixel
     values  follow  a  square waveform. The user can specify the
     period, phase, minima and maxima, sampling  frequency,  rise
     and fall times, an initial delay, and signal dimensions.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are specified, and the first vector
     has  a sampling frequency of 10.0, an minimum of 6.0, a max-
     imum of 10.0, period of 2.0, rise of 0.0, fall of 1.0, width
     of  13.0,  initial  delay  of  0.0,  initial delay of 0; the
     second vector is identical, except that the minimum  is  3.0
     and  the  initial  delay  is  7,  then the image data in the
     "parameter file" will look like this:
     band #1:  10.0 10.0
     band #2:  6.0  3.0
     band #3:  10.0  10.0
     band #4:  2.0  2.0
     band #5:  0.0  0.0
     band #6:  1.0  1.0
     band #7:  13.0  13.0
     band #8:  0.0  7.0
     The advantage of this "parameter 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  indi-
     cated   to  be  zeroed.   After  the  indicated  delay,  the
     sinusoidal 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).
     NOTE: According to the Sampling Theorem, the  sampling  fre-
     quency should be at least twice that of the signal frequency
     to generate a signal properly.
     The resulting images may be of type FLOAT or COMPLEX.
     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.
SEE ALSO
     dgpwl(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1992,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgrleigh
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     variance       variance of data set
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional Rayleigh  distributed  noise  data
     set.   The  user  can specify the variance and signal dimen-
     sions.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are specified, and the first vector
     has  a  variance of 1.0, the second vector has a variance of
     6.0, the "parameter file" will look like this:
     band #1:  1.0 6.0
     The advantage of this "parameter file" is that it allows the
     creation  of  an ensemble of 1D signals that are 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.
     The resulting images may be of type FLOAT or COMPLEX.
     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.
SEE ALSO
     dgrleigh(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgsin
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     fs             sampling frequency
     amp            amplitude of function
     freq           frequency of the function in Hertz
     phase          phase shiftof sinusoid in Hertz
     delay          initial delay in number of data points
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     sampling       type of sampling. 0 is for  radians/pixel,  1
                    is for hertz.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional ensemble of signals  (data  sets).
     The  image  pixel  values  follow a sinusoidal waveform. The
     user can specify the frequency, phase,  amplitude,  sampling
     frequency, an initial delay, and signal dimensions.
     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:
     []
     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, fre-
     quency of 2.0, phase of 0.0, initial delay of 0; the  second
     vector  is  identical,  except that the amplitude is 3.0 and
     the initial delay is 7, 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  0.0
     band #5:  0.0  7.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  indi-
     cated   to  be  zeroed.   After  the  indicated  delay,  the
     sinusoidal 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).
     The resulting images may be of type  FLOAT  or  COMPLEX.   A
     real image is generated using the formula:
     f = A*cos(2*pi*i*f/s + p);
     where A is magnitude, f is frequency, i is a point  counter,
     p  is the phase shift in radians, and s is the sampling fre-
     quency. A complex image is generated similarly:
     f = A*cos(2*pi*i*f/s + ps) +
             j*A*sin(2*pi*i*f/s + p);
     where j is sqrt(-1).
     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.
SEE ALSO
     dgsin(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgsinc
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     fs             sampling frequency
     amp            amplitude of sinc function
     freq           frequency of the function in Hertz
     delay          initial delay in number of data points
     center         centering option: 0 - center it on  the  data
                    set, 1 left justify it
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
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  indi-
     cates 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:
     []
     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, fre-
     quency 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  indi-
     cated  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  orienta-
     tion.   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 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.
SEE ALSO
     dgsinc(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgunif
INPUT
     image          as an optional input, this  argument  can  be
                    used  to  pass  the  pointer to the parameter
                    "kernel", if this argument is NULL, then  the
                    parameter option is not used.
     numvec         number of data vectors
     numpts         number of points per data vector
     minimum        minimum value of function
     maximum        maximum value of function
     type           data type of  output  image.   This  must  be
                    either VFF_TYP_FLOAT or VFF_TYP_COMPLEX.
     procdir        process direction.  This can be either 0  for
                    vector processing or 1 for band processing.
OUTPUT
     image          holds the result of the data generation.  The
                    output  data  type  is  the same as the input
                    data type.
     return Value:  1 on success, 0 on failure.
DESCRIPTION
     creates a one dimensional uniform noise data set.  The  user
     can specify the minimum, maximum, and signal dimensions.
     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 will be contained in a
     single vector of float type information.  The row and column
     size information is irrelevant.  The format of the  informa-
     tion is as follows:
     []
     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.
     For example if 2 vectors are specified, and the first vector
     has minimum of 0.0 and maximum of 1.0, the second vector has
     minimum of 4.0 and maximum of 6.0, the "parameter file" will
     look like this:
     band #1:  0.0 4.0
     band #2:  1.0 6.0
     The advantage of this "parameter file" is that it allows the
     creation  of  an ensemble of 1D signals that are 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.
     The resulting images may be of type FLOAT or COMPLEX.
     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.
SEE ALSO
     dgunif(1), intro(3), vipl(3), verror(3), vutils(3)
RESTRICTIONS
     can only generate  VFF_TYP_FLOAT  and  VFF_TYP_COMPLEX  type
     images.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1991,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************
Documentation for avs module dgwindow
INPUT
     image          pointer to VIFF  structure  containing  image
                    data to be processed.
     type           output images data storage type.
     window_option  window function to be used.
     nsig           number of signals in ensemble.
     nelem          number of data elements in a signal.
     theta          theta parameter for kaiser function.
     damp           damping factor for exponential functions.
     width          desired window width for user defined window.
     procdir        process  direction:    0   indicated   vector
                    oriented   processing,   1   indicates   band
                    oriented processing.
OUTPUT
     image          pointer to VIFF  structure  containing  image
                    data after processing.
     Return Value:  1 on success, 0 on failure.
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.
SEE ALSO
     dgwindow(1), intro(3), vipl(3), verror(3), vutils(3)  ldwin-
     dow
RESTRICTIONS
     dgwindow only creates real or complex data sequences.
AUTHOR
     Jeremy Worley
COPYRIGHT
     Copyright  1992,  University  of  New  Mexico.   All  rights
     reserved.
*********************************************************************************