Maps image values to rows in a table
dmimgpick infile imgfile outfile method [clobber] [verbose]
'dmimgpick' will map values from an image to rows in
a table. Typical kinds of uses include getting background
values for source postions, exposure values for sources, etc.
The input image must have axis names that map to columns in
the input table. An error will be generated if the tool
cannot find the axes names. For each row in the table, the
columns that correspond to the image axes are mapped into the
image coordinates. The values closest to the location are
extracted and then interpolated based on the user selected
criteria.
dmimgpick mysrc.fits expmap.fits srcexp.fits method=minimum
For each source in the source list, find the value of the
exposure map and get the minimum value (useful for edge detections).
The input table name
The input table. There must be columns with the same name
as the axes in the 'imgfile' parameter.
The input image file
The input image file. The axes names need to match the columns
in the 'infile' parameter. The output column in the
'outfile' will be the name of the input image file
and will have the same units as the image.
The output file name
A copy of the input file with a new column (double data type)
containing the interpolated image values.
Parameter=method (string required default=weight)
Interpolation method
The column values in the table are mapped to the image and the
4 closest pixel values (and their locations) are returned.
The user can select from the following interpolation methods:
-
weight - a weighted average. The weight is the distance
from the image pixels to the location mapped onto the image.
-
average - a simple average of the 4 pixel values.
-
mininum - the minimum of the 4 pixel values
-
maximum - the maximum of the 4 pixel values
-
closest - the value of the pixel closest to the mapped location
-
furthest - the value of the pixel furthest from the mapped location
Remove output if it exists?
Used to specify whether or not to clobber existing file that
has the same name as the specified output file (only DM
dataset will be clobbered).
The tool chatter level
Verbose can be from 0 to 5, generating different amounts
of debugging output.
|
![[CIAO Logo]](../imgs/ciao_logo_navbar.gif){kind=logo}