Last modified: December 2022

AHELP for CIAO 4.15


Context: Tools::Image


Computes the distance transform of image


dmimgdist  infile outfile [tolerance] [clobber] [verbose]


`dmimgdist' finds how far away each pixel is away from the border; where 'the border' is determined from the actual image boundary, any NULL/NaN values , or values less-than or equalto the tolerance value.


dmimgdist img.fits dist.fits tol=0

computes the distance from the edge of the image, any null/nan pixels, and pixels below or equal to 0.


name type ftype def min max reqd
infile file input       yes
outfile file output       yes
tolerance real          
clobber boolean   no      
verbose integer   0 0 5  

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input)

Input image

Parameter=outfile (file required filetype=output)

Output image

The image represents the distance to the edge

Parameter=tolerance (real)

Value below which to consider background

the distance to pixels above this tolerance are computed

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

dmfiltering, dmmasks, dmregions
convert_ds9_region_to_ciao_stack, dither_region, dmappend, dmcontour, dmellipse, dmfilth, dmgroupreg, dmimg2jpg, dmimgadapt, dmimgblob, dmimgcalc, dmimgdist, dmimgfilt, dmimghist, dmimghull, dmimglasso, dmimgpick, dmimgpm, dmimgproject, dmimgreproject, dmimgthresh, dmmakereg, dmmaskbin, dmmaskfill, dmnautilus, dmregrid, dmregrid2, dmstat, evalpos, get_src_region, imgmoment, mean_energy_map, mkbgreg, mksubbgreg, pileup_map, roi, splitroi, tg_create_mask