Chandra X-Ray Observatory (CXC)
Skip to the navigation links
Last modified: December 2011

URL: http://cxc.harvard.edu/ciao/dmimghull.html
AHELP for CIAO 4.4

dmimghull

Context: tools

Synopsis

Create convex hull around pixels in image

Syntax

dmimghull  infile outfile [tolerance] [clobber] [verbose]

Description

`dmimghull' computes the convex hull around pixels whose values are (strictly) greater than the tolerance value. The output is a FITS region file.

Example

dmimghull img.fits dist.fits tol=0

Computes the convex hull around the pixels in the image whose values are greater than 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 region file

The polygon that encloses the input pixels above threshold

Parameter=tolerance (real)

Value below which to consider background

Parameter=clobber (boolean default=no)

Remove output if it exists?

If clobber=yes and a file exists that has the same name as the name of the output file, then the existing file is overwritten.

Parameter=verbose (integer default=0 min=0 max=5)

Tool verbosity level

Verbose can be from 0 to 5, which determines the amount of screen output that is generated.

Changes in CIAO 4.4

  • dmimghull creates a convex hull around pixels in image.

Bugs

There are no known bugs for this tool.

See Also

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

Last modified: December 2011
CXC logo

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-2012. All rights reserved.