Synopsis
Replaces mask values with those found in lookup table
Syntax
dmmaskfill infile maskfile outfile [clobber] [verbose]
Description
`dmmaskfill' takes in an input mask image (integer data-type) and a table (which must have 2 columns). It looks up the image mask value in the 1st column of the table and replaces it with the value in the 2nd column in the table ('coloring by number').
Example
dmmaskfill infile=stats.fits[cols mask,mean] maskfile=mask.fits outfile=filled.fits
The values in the file 'mask.fits' are looked up in the 'mask' column of 'stats.fits'. The output image ('filled.fits') contains the values of the 'mean' column that correspond to the mask value.
Parameters
| name | type | ftype | def | min | max | reqd |
|---|---|---|---|---|---|---|
| infile | file | input | yes | |||
| maskfile | file | input | yes | |||
| outfile | file | output | yes | |||
| clobber | boolean | no | ||||
| verbose | integer | 0 | 0 | 5 |
Detailed Parameter Descriptions
Parameter=infile (file required filetype=input)
The input (lookup) table.
The table must have two columns. The first column (assumed to be an interger data-type) is what is matched to the values in the maskfile. The 2nd column is the value that is used in the output image. A DM '[cols ]' filter can be used to select the columns from the table and re-order them if necessary.
Parameter=maskfile (file required filetype=input)
The input mask image
The input mask image must be an interger data-type.
Parameter=outfile (file required filetype=output)
The output file name
The output file will be an image matching the maskfile image. The output values will be taken from the lookup table.
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
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.
Bugs
There are no known bugs for this tool.
See Also
- dm
- dmfiltering
- tools::core
- dmappend
- tools::image
- centroid_map, dmfilth, dmimg2jpg, dmimgadapt, dmimgblob, dmimgcalc, dmimgdist, dmimgfilt, dmimghist, dmimgpick, dmimgpm, dmimgproject, dmimgreproject, dmimgthresh, dmmaskbin, dmnautilus, dmradar, dmregrid, dmregrid2, energy_hue_map, evalpos, hexgrid, map2reg, merge_too_small, mkregmap, pathfinder, vtbin
- tools::region
- dmcontour, dmellipse, dmimghull, dmimglasso
- tools::response
- mean_energy_map, pileup_map
- tools::statistics
- dmstat, imgmoment, statmap