WCSTools Publications WCSTools: Putting Image World Coordinate Systems to Use, Douglas J. Mink (1996), presented at the Sixth Annual Conference on Astronomical Data Analysis Software and Systems (ADASS 96) in Charlottesvile, Virginia in September 1996, published in Astronomical Data Analysis Software and Systems VI, A.S.P. Conference Series, Vol. 125, 1997, Gareth Hunt and H. E. Payne, eds., p. 249. [WCSTools]

WCSTools: Putting Image World Coordinate Systems to Use

Douglas J. Mink
Harvard-Smithsonian Center for Astrophysics

WCSTools is a set of programs and a library of utility subroutines, written in portable C, for setting and using the world coordinate system (WCS) of a FITS or IRAF image. The WCS is the relationship between sky coordinates, such as right ascension and declination, and image pixels, and can be described using standard keywords in an image header. A single subroutine library is currently used by the image display and browsing programs SAOimage, SAOtng, and Skycat to translate between image pixels and sky coordinates. Some subroutines have been improved and new ones have been added to read and write all legal FITS image data types and to deal with IRAF .imh (OIF) files as easily as FITS files.

The central program, IMWCS, is based on earlier work presented by Elwood Downey and Robert Mutel of the University of Iowa at the 1995 ADASS Conference. It has been written to automatically find stars in an image, match them to a reference catalog, and fit a WCS to the image. Many of these individual functions are available separately: IMSTAR lists the stars in an image, with sky coordinates if a WCS exists in the image header; IMGSC lists stars from the HST Guide Star Catalog CDROMs which are found in the area defined by an image WCS; and IMUJC lists stars from the USNO J Catalog found in such an image-defined area. XY2SKY and its inverse, SKY2XY, convert pixel coordinates to sky coordinates and sky coordinates to pixel coordinates for an image with a WCS defined in its header.

These programs can be used in combination. If a CCD image has too few Guide Stars in it for a good WCS fit, IMSIZE can output the area covered by the image in a format which can be read by the GETIMAGE program to extract a Digitized Sky Survey image. IMSTAR can be used to generate a catalog of stars in that image and their positions which can then be used by IMWCS as a reference catalog to set the world coordinate system of the image.

Source code and online documentation for this library are available at URL http://tdc-www.harvard.edu/software/wcstools.html.


[ADS Abstract] [Bibtex entry] [Full Text] Proceedings full text: [HTML Text] [PDF]