WCSTools

stmx
2MASS Extended Source Catalog Search Program

WCSTools programs
stmx finds objects in the 2MASS Extended Source Catalog within a specified region of the sky and lists their sky positions or lists specific entries in that catalog. It is a symbolic link to scat, and is equivalent to running scat -c tmx ....

By default, only the brightest 100 objects (or closest 100, if the -s p option is used) are returned. Use the -n option to increase this number.

Output is to standard out, unless the -w flag is set, in which case it goes to objectname.tmx or search.tmx. For the All-Sky Data Release, the 2MASS_id number is the 2MASS declination zone, starting with 0 at the South Pole and moving north 0.1 degree at a time, followed by the sequence number of the star within the RA-sorted zone catalog.

Set the environment variable TMX_PATH to the directory containing the region files (or links to them). If the environment variable is not set, the default is to look in the directory defined by tmxpath near the start of the file libwcs/tmcread.c.

To search the area covered by a FITS image with a world coordinate system in its heder, use imtmx.

Command Line Arguments

CGI Queries and Parameters

As of version 2.9.4, stmx can be used remotely as a CGI executable.

Examples

Search with results to standard output
Search with results to a file
Find closest object
Find objects by number
Match objects in input catalog
Telescope Data Center

Last updated 11 July 2007 by Doug Mink