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

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

imgmoment

Context: tools

Synopsis

Computes image moments

Syntax

imgmoment  infile [x_mu] [y_mu] [m_x_y] [phi] [eccen] [x_sig] [y_mu]

Description

The "imgmoment" tool computes up to the second moment of an image. It computes the ellipticity and angle, then computes the '1sigma' radius along each axis. The calculated values are stored in the parameter file.

Example

imgmoment img.fits[sky=circle(100,100,10)]
pget imgmoment x_mu y_mu

Computes the moments of the image in 'img.fts' in the region defined by the specified circle. The centroid (x_mu,y_mu) is then retrieved using the pget utility.

Parameters

name type ftype reqd
infile file input yes
x_mu real output  
y_mu real output  
m_x_y real output  
phi real output  
eccen real output  
x_sig real output  
y_mu real output  

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input)

Input image file

Parameter=x_mu (real filetype=output)

X-centroid (physical coordinates)

Parameter=y_mu (real filetype=output)

Y-centroid (physical coordinates)

Parameter=m_x_y (real filetype=output)

The x-th and y-th order moment. m_0_0 is sum of pixel values. x and y go from 0 to 2.

Parameter=phi (real filetype=output)

Ellipse angle based on moments

Parameter=eccen (real filetype=output)

Ellipse eccentricity based on moments.

Parameter=x_sig (real filetype=output)

Rotated image by -phi; sigma along (rotated) x-axis.

Parameter=y_mu (real filetype=output)

Rotated image by -phi; sigma along (rotated) y-axis.

Changes in CIAO 4.4

  • imgmoment computes up to the second moment of an image.

Bugs

There are no known bugs for this tool.

See Also

dm
dmfiltering
tools
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, get_fov_limits, get_sky_limits, mean_energy_map, pileup_map

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.