|
|
|
|
|
SynopsisMaps image values to rows in a table Syntaxdmimgpick infile imgfile outfile method [clobber] [verbose] Description'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. Exampledmimgpick 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). Parameters
Detailed Parameter DescriptionsParameter=infile (file required filetype=input)The input table name The input table. There must be columns with the same name as the axes in the 'imgfile' parameter. Parameter=imgfile (file required filetype=input)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. Parameter=outfile (file required filetype=output)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:
Parameter=clobber (boolean default=no)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). Parameter=verbose (integer default=0 min=0 max=5)The tool chatter level Verbose can be from 0 to 5, generating different amounts of debugging output. CHANGES IN CIAO 4.0Non-square input imagesIf the input image was not square, dmimgpick would have a problem related to how the tool checks if the pixel being "picked" is outside the image and the tool would fail with a segmentation fault. This bug was seen on Linux and Mac OS X platforms, and has been fixed. BugsSee the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs. |
 |
The Chandra X-Ray
Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA. Email: cxcweb@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2004. All rights reserved. |
![[CIAO Logo]](../imgs/ciao_logo_navbar.gif){kind=logo}