Last modified: December 2022

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/dmimgdist.html
Jump to: Description · Example · Parameters · Bugs · See Also


AHELP for CIAO 4.16

dmimgdist

Context: Tools::Image

Synopsis

Computes the distance transform of image

Syntax

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

Description

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


Example

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.


Parameters

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.


Bugs

There are no known bugs for this tool.

See Also

concept
subspace
dm
dmfiltering, dmmasks, dmregions
tools::aspect
dither_region
tools::core
dmappend
tools::detect
get_src_region
tools::gratings
tg_create_mask
tools::image
centroid_map, dmfilth, dmimg2jpg, dmimgadapt, dmimgblob, dmimgcalc, dmimgfilt, dmimghist, dmimgpick, dmimgpm, dmimgproject, dmimgreproject, dmimgthresh, dmmaskbin, dmmaskfill, dmnautilus, dmradar, dmregrid, dmregrid2, energy_hue_map, evalpos, hexgrid, map2reg, merge_too_small, mkregmap, pathfinder, vtbin
tools::region
bkg_fixed_counts, convert_ds9_region_to_ciao_stack, dmcontour, dmellipse, dmgroupreg, dmimghull, dmimglasso, dmmakereg, psf_contour, rank_roi, regphystocel, roi, splitroi
tools::response
mean_energy_map, pileup_map
tools::statistics
dmstat, imgmoment, statmap