NAME

ctrcoo - (re)fit center positions to objects in an image

USAGE

ctrcoo intab outab image [cntrbox] [redispl] [verbose]

PARAMETERS

intab = ""

Input coordinate file

outab = ""

Output coordinate file (may be equal to 'intab')

image = ""

Image containing the objects

cntrbox = 7

Size of the centering box in pixels

redispl = yes

(Re)display the image first?

verbose = yes

Print the recentered coordinates to the standard output?

(xcen) [real]

Parameter returning the refitted x-center coordinate (pixel)

(ycen) [real]

Parameter returning the refitted y-center coordinate (pixel)

DESCRIPTION

Wrapper around 'imexamine' to (re)fit/refine the center positions to objects in an image, given a list with initial estimates for those center positions. The first two columns of the input file should list estimates for the x- and y- center coordinates, and only these first two column are considered; any additional columns, containing information like fluxes or labels, are ignored. 'outab' and 'intab' may be identical, in which case the input file will be updated (overwritten).

Upon exit of this task, if only one set of input coordinates was given, task parameters 'xcen' and 'ycen' will define the refined center position; if more than one set of input coordinates was given, only the center coordinates for the last set is returned. If the 'verbose' switch is set, the result(s) are also printed to the standard output.

EXAMPLES

1. Return the center of an object that appears very close to the center of an 800x800 pixel image:

    rj> print ("400. 400.", > "NGC1311.coo")
    rj> ctrcoo ("NGC1311.coo", "NGC1311.coo", "NGC1311_F814W.fits",
		cntrbox=11, redispl+, verbose+)
    Guessed center coordinates:
    #1  xtry=400.000, ytry=400.000
    Recentered coordinates:
    #1  xcen=401.150, ycen=400.340

REVISIONS

CTRCOO v2.11, Jun 19 2000 [RAJ]; IRAF 2.11.3

CTRCOO v2.12, Aug 18 2003 [RAJ]

Clean-up code and wrote help-file for IRAF 2.12.1

BUGS

SEE ALSO

imexamine