DATAMANIP commands
PROGRAM NAME
kimpulse - Generate Object Containing Impulse Value Data
DESCRIPTION
kimpulse
creates a data object with impulses in the value segment. The dimension of the
object is Width * Height * Depth * Time * Elements. The data type of the
value segment can be bit, byte, unsigned byte, short, unsigned short,
integer, unsigned integer, long, unsigned long, float, double, complex
and double complex.
The value assumed to each impulse can be specified (-fgreal and -fgimag). Both
the real and imaginary component of the value assumed by the impulse, are
accepted but the imaginary value is used only when the output type is
complex or double complex. The value assumed by the background is
specified by the -bgreal and -bgimag variables. Like the impulse value, the
imaginary background value is used only when the output type is complex or
double complex.
The spacing (period) of the impulses can be specified for each of the 5
dimensions
of the output object (-wsp -hsp -dsp -tsp & -esp). The number of impulses
along each dimension can also be specified (-wnum -hnum -dnum -tnum & -enum).
This parameter is useful if impulses are not desired beyond a certain point in
each dimension. If the number of impulses specified is greater than the number
obtained by dividing the size of the object by the spacing between impulses
then the latter denotes the number of impulses along a dimension.
It is also possible to specify an offset for each of the 5 dimensions. The
first impulse is generated relative to the offset value specified by the
variables -woff -hoff -doff -toff -eoff. An error message is generated if
the offset specified is greater than the size of that dimension.
REQUIRED ARGUMENTS
- -o
-
type: outfile
desc: Output file containing impulse value data
OPTIONAL ARGUMENTS
- -wsize
-
type: integer
desc: Width of impulse value data
default: 512
bounds: value > 0
- -wnum
-
type: integer
desc: Number of impulses generated along the width dimension
default: 1
bounds: value > 0
- -hsize
-
type: integer
desc: Height of impulse value data
default: 512
bounds: value > 0
- -hnum
-
type: integer
desc: Number of impulses generated along the height dimension
default: 1
bounds: value > 0
- -dsize
-
type: integer
desc: Depth of impulse value data
default: 1
bounds: value > 0
- -dnum
-
type: integer
desc: Number of impulses generated along the depth dimension
default: 1
bounds: value > 0
- -tsize
-
type: integer
desc: Time of impulse value data
default: 1
bounds: value > 0
- -tnum
-
type: integer
desc: Number of impulses generated along the time dimension
default: 1
bounds: value > 0
- -esize
-
type: integer
desc: Element dimension of impulse value data
default: 1
bounds: value > 0
- -enum
-
type: integer
desc: Number of impulses generated along the element dimension
default: 1
bounds: value > 0
- -wsp
-
type: integer
desc: Spacing between two impulses along the width dimension
default: 256
bounds: value > 0
- -woff
-
type: integer
desc: Offset of first impulse along width dimension
default: 0
bounds: value >= 0
- -hsp
-
type: integer
desc: Spacing between two impulses along the height dimension
default: 256
bounds: value > 0
- -hoff
-
type: integer
desc: Offset of first impulse along height dimension
default: 0
bounds: value >= 0
- -dsp
-
type: integer
desc: Spacing between two impulses along the depth dimension
default: 1
bounds: value > 0
- -doff
-
type: integer
desc: Offset of first impulse along depth dimension
default: 0
bounds: value >= 0
- -tsp
-
type: integer
desc: Spacing between two impulses along the time dimension
default: 1
bounds: value > 0
- -toff
-
type: integer
desc: Offset of first impulse along time dimension
default: 0
bounds: value >= 0
- -esp
-
type: integer
desc: Spacing between two impulses along the element dimension
default: 1
bounds: value > 0
- -eoff
-
type: integer
desc: Offset of the first impulse along the element dimension
default: 0
bounds: value >= 0
- -fgreal
-
type: double
desc: Real value assigned to the generated impulse
default: 255
bounds: no range checking
- -bgreal
-
type: double
desc: Real value assigned to background value data
default: 0
bounds: no range checking
- -fgimag
-
type: double
desc: Imaginary value of generated impulse
default: 0
bounds: no range checking
- -bgimag
-
type: double
desc: Imaginary value assigned to background
default: 0
bounds: no range checking
- -type
-
type: list
desc: Data type of impulse value data
default: 3 "unsigned byte"
EXAMPLES
% kimpulse -wsize 512 -hsize 512 -w_off 255 -h_off 255 -w_num 1 -h_num 1 -o example
creates an image example of size 512x512 with an impulse of value 255 in the
center. The background has the value 0.
% kimpulse -wsize 512 -hsize 512 -w_off 255 -h_off 255 -w_num 2 -h_num 2 -wsp 10 -hsp 20 -o exampl -fgreal 1.0 -bgreal 0.0 -fgimag 0.0 -bgimag 0.5 -type complex
creates a COMPLEX image example of size 512x512 with four impulses of
value (1.0,0.0). The background has the value (0.0,0.5). The impulses appear
as an array with one corner at (255,255), with spacing (period) in the W
direction of 10 and in the H direction of 20.
SEE ALSO
kgsin(1)
RESTRICTIONS
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.