DATAMANIP commands


PROGRAM NAME

kshot - Introduce Shot Noise in Input Object

DESCRIPTION

kshot corrupts a data object uniformly with spikes. The percentage of spikes in the image must be specified by the user. The spike value to be inserted can also be specified. For complex objects both the real and imaginary components need to be specified. If the input object is not complex then the imaginary value specified is ignored. Spike locations are determined using a uniformly distributed random number generator.

Validity Mask If there is a validity mask associated with the source object, the mask is transferred to the destination object. If the random number generator comes up with a spike location that has corresponding mask value set to zero, the spike is not inserted. However the point is included in the count of the number of points spiked.

Map Segment If the source object has a map, the destination object will have the mapped source data with the spikes inserted at random locations.

REQUIRED ARGUMENTS

-i
type: infile
desc: Input File
-spikes
type: double
desc: Percentage of spikes in the output
bounds: 0 < [-spikes] < 100
-o
type: outfile
desc: Output File

OPTIONAL ARGUMENTS

-real
type: double
desc: Real value of spike
default: 255
bounds: no range checking
-imag
type: double
desc: Imaginary value of spike
default: 0
bounds: no range checking

EXAMPLES

kshot -i obj1 -o obj2 -spikes 20 -real 255 -imag 255

Inserts a spike in 20% of the points of input complex object obj1. The value of the spike inserted is 255+j255.

SEE ALSO

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.