Last modified: December 2022

AHELP for CIAO 4.15


Context: Tools::Image


Replaces mask values with those found in lookup table


dmmaskfill  infile maskfile outfile [clobber] [verbose]


`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').


dmmaskfill infile=stats.fits[cols mask,mean] maskfile=mask.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.


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.

Changes in CIAO 4.15


There are no known bugs for this tool.

See Also

dmappend, dmcontour, dmellipse, dmfilth, dmimg2jpg, dmimgadapt, dmimgblob, dmimgcalc, dmimgdist, dmimgfilt, dmimghist, dmimghull, dmimglasso, dmimgpick, dmimgpm, dmimgproject, dmimgreproject, dmimgthresh, dmmaskbin, dmmaskfill, dmnautilus, dmregrid, dmregrid2, dmstat, evalpos, imgmoment, mean_energy_map, pileup_map