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.