WCSTools

imua2
Find USNO UCAC2 Stars in Image Region

 WCSTools programs
imucac2 is a link to the WCSTools imcat utility which finds all of the U.S. Naval Observatory UCAC2 Catalog objects in a FITS or IRAF image and lists their sky and image positions. World coordinate system (WCS) information must be present in the image header to describe, in a standard way, the relationship between sky coordinates and image pixels. This information is used by the program to find the region in the sky to search and to transform right ascension and declination sky coordinate pairs to image coordinate (X,Y) pairs. Output is sent to a file called filename.uac and to standard output if the -v flag is set.

The UCAC number is the zone number (South Polar Distance in degrees by 1/2's)*2 followed by the six-digit sequence number of the star within the RA-sorted zone. This number will change with each release of the UCAC catalog.

Before you can use this program, the path to the directory containing the region files must be set. The default is to use the value of the variable ucac2path in the source code file libwcs/ucacread.c, which is initially set to /data/astrocat/ucac2, which is where the catalog resides at the Center for Astrophysics. If you do not have access to the source code and need to change the path, you can set the environment variable UCAC2_PATH to the directory containing the region files, and that will override the file setting.

The minimum command line is imucac2 FITS or IRAF filename

The same effect can be obtained by running imcat -c ucac2 FITS or IRAF filename

Command Line Arguments

Examples

List the 10 brightest USNO UCAC2 Catalog stars in a FITS image from a CDROM
List the USNO UCAC2 Catalog stars in a FITS image to a file
Plot USNO UCAC2 Catalog stars onto a FITS image

Last updated 11 September 2003 by Doug Mink dmink@cfa.harvard.edu

Telescope Data Center