WCSTools programs

SCAT CGI-BIN Arguments

Telescope Data Center

(also for sgsc, sty2, stmc, sgsca, sua1, sua2, susa1, susa2, ssao, sppm, and siras)

As of version 2.8.6, scat can access another instance of itself across the World Wide Web.
ra=right ascension
Right ascension of center for search in hours:minutes:seconds or fractional degrees. Galactic or ecliptic longitude is expected to be in fractional degrees.

dec=declination
Declination of center for search in degrees:minutes:seconds or fractional degrees. Galactic or ecliptic latitude is expected to be in fractional degrees. system may be J2000, FK5, B1950, FK4, ecliptic, or galactic. The year for an alternate equinox may be included with the system, so J1985 would be FK5 coordinates at the equinox of 1985.0. Fractions of years are allowed. To indicate the epoch of the coordinates, which increases accuracy of coordinate conversion between J2000 and B1950, use the -y command.

sys=system
system may be J2000, FK5, B1950, FK4, ecliptic, or galactic. The year for an alternate equinox may be included with the system, so J1985 would be FK5 coordinates at the equinox of 1985.0. Fractions of years are allowed. To indicate the epoch of the coordinates, which increases accuracy of coordinate conversion between J2000 and B1950, use the -y command.

num=number or range
A list of numbers of specific catalog numbers to list may be separated by spaces or commas. Ranges of the format first-last[xstep] may be among those numbers. If last is omitted, but the - is included, ten stars, starting with first are listed. If step is omitted, it is assumed to be one. (ranges added in version 2.6)
closest=y
List single closest catalog source to command line position

outsys=system
Output catalog positions in B1950 (FK4), J2000 (FK5), ecliptic, or galactic coordinates no matter what system the catalog is in.

catalog=catalog name
Name of catalog to search ( ua1, ua2, gsc, usa1, usa2, ujc, ppm, sao, iras, or local file name). Local catalogs may be in StarBase tab table, simple ASCII, TDC binary format Directories are specified in the source code which reads each catalog or with environment variables. Instead of using this argument, the program may be invoked, through a link or by renaming it, as sua1, sua2, sgsc, susa1, susa2, sujc, sppm, ssao, or siras.

degrees=yes
Output RA,Dec positions in fractional degrees instead of sexigesimal.

mag=faint magnitude limit
Only stars brighter than faint magnitude limit are listed. The default is to list all stars.

min=faint magnitude limit
Only stars brighter than faint magnitude limit are listed. The default is to list all stars.

max=bright magnitude limit
Only stars fainter than bright magnitude limit are listed. The default is to list all stars.

nstar=number
Print up to this number of brightest (or closest if closest is yes) catalog stars. If the internal default of 100 is exceeded by the search, set this number high enough to include all of the stars which are found.

equinox=date
Use this date as the equinox of the output coordinates

radius=arcseconds or dd:mm:ss.sss
Half-width of square to search in arcseconds (default is 10). If negated, search circle of this radius instead of a box. The radius may be given in degrees as dd:mm:ss.ss instead of arcseconds.

dra=arcseconds or hh:mm:ss.sss
Half-width of rectangle to search in arcseconds (default is 10). It may be given in hours as hh:mm:ss.ss instead of arcseconds.

ddec=arcseconds or dd:mm:ss.sss
Half-height of rectangle to search in arcseconds (default is 10). It may be given in degrees as dd:mm:ss.ss instead of arcseconds.

sort=magnitude (or mn) or ra or dec or dist
Sort output list by magnitude (or specified magnitude), right ascension, declination, or distance from search center. The default is to sort by the first magnitude, brightest to faintest.

class=class
List only Guide Stars with this class (-1=all, 0=stars, 3=nonstars). (scat and sgsc only)

epoch=date
Use this date as the epoch of the output coordinates. If you expect B1950 and J2000 conversions to be reversible to better than 0.1 arcsecond, this must be included. To indicate a specific equinox, include the date as a fractional year in the coordinate system.

[scat] [sgsc] [sua1] [sua2] [susa1] [susa2]

[sact] [sujc] [sppm] [ssao] [siras]


Telescope Data Center

Last updated 30 May 2001 by
Doug Mink dmink@cfa.harvard.edu