RGSC Command Line Options

hh:mm:ss.sss dd:mm:ss.ss [J2000 or B1950]

Center the search on this position in right ascension and declination. Both positions must be present if one is, but the equinox, J2000 or B1950, may be ommitted to use one explicitly set on the command line or already set.

region_number.source_number

Print the position of the source with this number.

@filename

If the first character in the file is a number, print the positions of the stars listed, one per line, in the file. If the first character is a alphabetic character, perform a batch search of all of the sources or positions in an ASCII input file with the format described in catalogs(5). The basic format, with input coordinates in B1950, is:

one-word catalog name/[optional format switches]
one-line catalog description
number hh.mmsss dd.mmss Magnitude Optional name
number hh.mmsss dd.mmss Magnitude Optional name
number hh.mmsss dd.mmss Magnitude Optional name
. . .

-fit filename
-imh filename

Make search region match the image position and area as derived from FITS or IRAF world coordinate system information found in the header of filename. If the first character of filename is an @, the rest of filename is the name of a file containing a list of filenames to be used, one at a time. (IMAGELIST) (Added in version 3.1)

-cra num

Set center right ascension for search in hours, minutes, and seconds, formatted as hh.mmssss. (CRA)

-cdec num

Set center declination in degrees, minutes, and seconds, formatted as dd.mmssss. (CDEC)

-box

Sets search box half-width in degrees, minutes, and seconds, formatted as dd.mmssss; RA half-width will be box/cos(dec). If greater than zero, this value overrides -dra and -ddec. (DBOX)

-dra

Set right ascension half-width for search in hours, minutes, and seconds, formatted as hh.mmssss. (DRA)

-ddec

Sets declination half-width in degrees, minutes, and seconds, formatted as dd.mmssss. (DDEC)

-m1

Set bright magnitude limit. Version 1.0 of the GSC doesn't have anything brighter than 7. (MAG1)

-m2

Set faint magnitude limit. Version 1.0 of the GSC doesn't have anything brighter than 7. (MAG2)

-star (-nstar) (-all)

Keep only stars, only nonstellar objects, or everything. (CLASS=0,3,-1)

-o

Set output filename. If "-", no file is written. (OUTFILE)

-print (-nprint)

Display stars to standard output as well as (or instead of) writing them to a file. (PRINT=t,f)

-log

Set logging interval during search through GSC. If zero, progress of the search is not logged. If -print is set, progress is not logged. (NLOG)

-b (-j)

Input and output coordinates in B1950 or J2000 coordinates. (INCOOR=B1950,J2000) (MAPCOOR=B1950,J2000)

-bi (-ji)

Input search coordinates in B1950 or J2000 coordinates. (INCOOR=B1950,J2000)

-bo (-jo -gal -equ)

Output source positions in B1950, J2000, galactic, or equatorial coordinates. (MAPCOOR=B1950,J2000,GALACTIC,ECLIPTIC)

-new (-app)

Start new or append to most recent output file. (APPEND=f,t)

-save (-nsav)

Save all plate positions with plate ID or average multiple plate positions and magnitudes for a single source (error-weighted means). Magnitude errors may be introduced when B and V plates are averaged together. (SAVEALL=t,f)

-hms (-tab) (-col) (-deg)

Output source positions as h.mmss,d.mmss, hh mm ss.sss dd mm ss.ss, hh:mm:ss.sss dd:mm:ss.ss, or fractional degrees. Galactic coordinates are always ouput as degrees instead of hours. The GSC uses fractional degrees internally. (OUTFORM=HMS,TABULATE,COLON,DEGREES)

-plate (-nplate)

Output GSSS plate ID(s) for each star. (PPLATE=t,f)

-pdist (-npdist)

Output distance from search center in arcsec for each star. (PDIST=t,f)

-bp (-nbp)

Output plate bandpass(es) for each star. (PBAND=t,f)

-band number

Select plates with this bandpass code only (GSCBAND).

-1: all                        10: IIa-D/GG495(ESO-GPO-V)
 0: IIIa-J/GG395(SERC-J)       11: 103a-O/GG400(BlackBirch-B)
 1: IIa-D/W12(Palomar-V1)      16: IIIa-J/GG495(Palomar-V5)
 6: IIa-D/GG495(Palomar-V4)    18: IIIa-J/GG385(Palomar-J)
 8: 103a-E/Red(Palomar-E)

-v (-nv)

Turn verbose mode on or off. Command line parameter changes will be echoed if this is on, as well as additional progress logging. This is useful if the program is apparently misbehaving. (VERBOSE=t,f)

-stop

Stop processing of command line and exit from program without performing Guide Star Catalog search.

Last updated 5 January 1996