RETRO commands
PROGRAM NAME
vgpwl - Create 2D Piecewise Linear Periodic Function (K1)
DESCRIPTION
creates a two dimensional piecewise linear image. The image pixel values
follow a square waveform. The user can specify the period, phase,
minima and maxima, sampling frequency, rise and fall times, and image
dimensions.
NOTE: According to the Sampling Theorem, the sampling frequency should be
at least twice that of the signal frequency to generate a signal
properly.
Note that the X-direction corresponds to across the image from left to
right, and the Y-direction corresponds to down the image from top to
bottom.
The trigger input can be used to cause
vgpwl
to re-execute when used inside cantata. No image is read from this input.
REQUIRED ARGUMENTS
- -o
-
type: outfile
desc: resulting image
OPTIONAL ARGUMENTS
- -trigger
-
type: infile
desc: trigger input
default: {none}
- -r
-
type: integer
desc: number of rows
default: 512
bounds: value > 0
- -s
-
type: float
desc: sampling frequency
default: 1
bounds: value > 0.0
- -c
-
type: integer
desc: number of columns
default: 512
bounds: value > 0
- -l
-
type: float
desc: signal minimum
default: 0
bounds: no range checking
- -b
-
type: integer
desc: number of bands
default: 1
bounds: value > 0
- -m
-
type: float
desc: signal maximum
default: 1
bounds: no range checking
- -xp
-
type: float
desc: signal period in X-direction
default: 1
bounds: value > 0.0
- -yp
-
type: float
desc: signal period in Y-direction
default: 1
bounds: value > 0.0
- -xr
-
type: float
desc: rise time in X-direction
default: 0
bounds: value >= 0.0
- -yr
-
type: float
desc: rise time in Y-direction
default: 0
bounds: value >= 0.0
- -xf
-
type: float
desc: fall time in X-direction
default: 0
bounds: value >= 0.0
- -yf
-
type: float
desc: fall time in Y-direction
default: 0
bounds: value >= 0.0
- -xw
-
type: float
desc: pulse width in X-direction
default: 0
bounds: value >= 0.0
- -yw
-
type: float
desc: pulse width in Y-direction
default: 0
bounds: value >= 0.0
- -t
-
type: string toggle
desc: lets user choose data type of image
default: float
allowed values:
- float (select data type),
- or complex (choose data type)
EXAMPLES
vgpwl -o plinear.xv -t float
vgpwl -o test.xv -t complex -xr 10 -yr 10 -xw 5 -yw 7
SEE ALSO
RESTRICTIONS
can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type images.
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.