WCSTools

imcat
Find Catalog Stars in Image Region

WCSTools programs
imcat is a utility for finding all of the objects from a specified catalog objects in a FITS or IRAF image and listing their sky and image positions. Supported catalogs include the Hubble Space Telescope Guide Star Catalog, U.S. Naval Observatory Catalogs, or user-developed catalogs.

World coordinate system (WCS) information must be present in the image header for the program to find the region in the sky to search and to transform right ascension and declination sky coordinate pairs from the catalog into image coordinate (X,Y) pairs. Output is sent to a file called filename.cat and to standard output if the -v flag is set.

Specific catalogs which can be searched include:
  • USNO-A2.0 Catalog using imua2
  • USNO-B1.0 Catalog using imub1
  • 2MASS Point Source Catalog using imtmc
  • GSC II Catalog using imgsc2
  • USNO-SA2.0 Catalog using imusa2
  • USNO UCAC2 Catalog using imucac2
  • USNO-A1.0 Catalog using imua1
  • USNO-SA1.0 Catalog using imusa1
  • USNO-J1.0 Catalog using imujc
  • HST Guide Star Catalog using imgsc
  • GSC-ACT Star Catalog using imgsca
  • Tycho 2 Catalog using imty2
  • SAO Catalog using imsao
  • PPM Catalog using imppm
  • IRAS Point Source Catalog using imiras
  • USNO ACT Catalog using imact
  • Command Line Arguments

    Some Examples

    List HST Guide Star Catalog Stars in an Image
    File USNO A-1.0 Catalog Stars in an Image
    List USNO J Catalog Stars in an Image
    Plot HST Guide Star Catalog Stars over an Image

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

    Telescope Data Center