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.