imageblur - blur photons in the XY plane using an image
imageblur [option=value]
imageblur applies a blur in the X-Y plane to bpipe formatted rays.
It uses an input FITS formatted image to generate the blur offsets. The image need not be normalized.
The offsets are calculated by:
Choosing a pixel in the image based upon its value relative to those of the other pixels.
Adding a uniform blur to the pixel indices to randomly sample the pixel.
Subtracting the x0
and y0
paramter values from the pixel indices.
Multiplying the results by the scale
parameter.
imageblur uses an IRAF compatible parameter interface. It recognizes the following parameters:
Input photon stream in bpipe format. The string 'stdin' causes scatter to read from standard input.
Output photon stream in bpipe format. The string 'stdout' causes scatter to write to standard output.
The filename of the image.
Pixels with probability values less than or equal to pmin
and greater than pmax
are excluded from consideration.
If clip_pdf
is true
, the absolute probability of each pixel is used. If clip_pdf
is false
, the probabilities are sorted and integrated, and the pixels whose contributions to the integrated probability lie between [0, pmin
] and (pmax
,1] are excluded.
The position within the image (in pixels) corresponding to a blur offset of (0,0). If set to the string center
the center of the image will be used.
The size of a pixel.
The first seed for the random number generator. It must be in the range [1,214748339].
The second seed for the random number generator. It must be in the range [1,214748339].
The random number block to start at. It must be in the range [1,1048575].
Print brief usage information and exit.
Print usage information and exit.
Print version and exit.
Copyright 2012 Smithsonian Astrophysical Observatory
This software is released under the GNU General Public License. You may find a copy at http://www.fsf.org/copyleft/gpl.html
Diab Jerius <djerius@head.cfa.harvard.edu>