NAME:
  getstars
 PURPOSE: (one line)
  Retrieve coordinates from the master star catalog
 DESCRIPTION:
 CATEGORY:
  Astronomy
 CALLING SEQUENCE:
  getstars,name,ra,dec,found,EPOCH=epoch,EQUINOX=equinox
 INPUTS:
     name   - Name of the star.
 OPTIONAL INPUT PARAMETERS:
 KEYWORD INPUT PARAMETERS:
     FILE    - Name of star catalog file.  Default is:
                 '/net/frakir/raid/buie/starcat/starcat.dat'

     EPOCH   - Decimal year of epoch to correct for proper motion to.
                 Default = catalog epoch.  (Scalar or vector).

     B1950   - Coordinates should be referred to equinox of B1950.

     J2000   - Coordinates should be referred to equinox of J2000 (default).

     OFDATE  - Coordinates should be referred to equinox of date.
                 If selected, EPOCH must be provided.

     NOBLANKS - Flag, if set, search for the name ignores all blanks.

     NOCASE  - Flag, if set, search for the name ignores case.

 OUTPUTS:
     ra     - Right Ascension in radians. J2000
     dec    - Declination in radians.     J2000
     found  - Flags, 1=star found, 0=star not found

 KEYWORD OUTPUT PARAMETERS:
     STDNAME - Actual standard name from file, resolves the aliases.

 COMMON BLOCKS:
     MWB_STARCAT
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
  96/11/21, Written by Marc W. Buie, Lowell Observatory
  2002/09/03, MWB, changed Str_sep call to strsplit
  2004/02/09, MWB, changed path to starcat.dat file.