NAME
allstar - empirically finds the best guide star
SYNOPSIS
allstar
DESCRIPTION
This procedure looks through the Hubble guide star and bright star catalogs
and selects the five best candidates for the RA, DEC, and EPOCH for the
target found in the environment. The selection is based by correcting the
visual or Hubble magnitudes by a theoretical vignetting function, then
sorting by brightness. The procedure then points the telescope to the target
coordinates. It then moves the stage to each star, takes a guider exposure
and prints out a file with the name $DATID.found which has the following
format.
Ra dec epoch hmag row col gmag
where the Ra, dec, and epoch are the coordinates of the guide star, hmag is
the Hubble magnitude (uncorrected for vignetting), the row and column where
the star was found. The last column contains the guider magnitude defined
using mconst=19 (see phot). Note: The file will contain only the stars
that were detected by `stars'; it may contain less than five entries
(possibly none). If photometry is not possible it will return the value
99.0.
BUGS
If multiple stars are found, only the brightest is reported. The star finder
is often confused by high
backgrounds.