STScI Logo


.help sub1 Apr 2004WCSTools
sub1 -- Find USNO-B1.0 Catalog stars in a square or circle on the sky
sua2 [options] ra dec system
.ls -a
list single closest catalog source
.ls -b
Output B1950 (FK4) coordinates
.ls -d
Sort by distance from center instead of flux
.ls -e
Output ecliptic coordinates
.ls -f
Output search center for other programs
.ls -g
Output galactic coordinates
.ls -h
Print heading, else do not 
.ls -i
Print catalog object name, not catalog number (=ua2_region_number)
.ls -j
Output J2000 (FK5) coordinates
.ls -l
Print center and closest star on one line
.ls -m [<bright magnitude>] <faint magnitude>
Limiting catalog magnitude(s) (default none, bright -2 if only faint is given)
.ls -n <num>
Number of brightest stars to print 
.ls -o <name>
Object name used to name output file
.ls -p
Sort by distance from search center instead of brightness
.ls -q <years>
Equinox of output positions in years
.ls -r <radius>
Search box half-width in arcsec or dd:mm:ss
If negative, this is a radius; if two numbers, first is in right ascension,
second is in declination. (default is 10, that is a 20x20 arcsec box)
.ls -s
Sort by right ascension instead of flux 
.ls -t
Tab table output
.ls -u <num>
Print X Y instead of number in front of non-tab entry
.ls -v
Verbose listing of processing intermediate results
.ls -w
Write tab table output file imagename.uac
.ls -y
Epoch of output positions in years
.ls minid=number
If the object is found on fewer than this many plates, where the range
is 2-5, it is left off the list. All Tycho-2 stars, where the catalog
value of this number is set to zero, are included unless number is
negated. The default value set in the file libwcs/ubcread.c is 0. For
the most accurate positions, use minid=4.
.ls minpmqual=number
If the proper motion quality flag is less than this number, proper
motion is never added to the catalog position. The range is 1-9 from
the catalog, or 10 if the proper motion is from the Tycho-2 Catalog.
Setting this to 11 will never add proper motion. The default value set
in the file libwcs/ubcread.c is 3. For the best proper motions, use
.I sub1
finds all of the U.S. Naval Observatory B1.0 Catalog objects in a specified
region of the sky and lists their sky positions and magnitudes in order of
brightness. Output is to standard out, unless the -w flag is set, in which
case it goes to objectname.uac or search.uac. It is a link to scat.
scat, imcat, imub1
Doug Mink, SAO (

Source Code · Search Form · STSDAS