NAME:
  kboplan
 PURPOSE:
  KBO observing planning table generation
 DESCRIPTION:

 CATEGORY:
  Astronomy
 CALLING SEQUENCE:
  kboplan,objcode,obs,date
 INPUTS:
  objcode - String array of standard object codes (see ephem.pro), if the
              input is a single string with @ as the first character, then
              the rest of the string is interpreted as a file to read the
              object codes from.
  obs     - Integer Marsden code of the observatory
               688 - Lowell Observatory
               500 - Geocentric
               If you provide an invalid code, 688 is assumed.
  date    - UT date and time vector near midnight for night,
                 [year,month,day,hour]
     
 OPTIONAL INPUT PARAMETERS:

 KEYWORD INPUT PARAMETERS:
  FWHM    - Seeing to assume for the night, default=1.2 arcsec
  OUTPUT  - String, if supplied, indicates the name of a file to save the
               output to.  The default is to print the information on the
               terminal.
  AMLIMIT - Air mass limit for observations (default=2.5)
  DESCRIPTION - Optional string array with a descriptive label for each
                   object.  If supplied it should match the length of the
                   objcode input array.
  MINSEP  - Minimum motion desired between successive visits in arcsec.
              default=3
  OBSLIST - List of planned observations.  This is a string which contains
              the file name.  In the file, the first blank-delimited field
              is the name of the object.  This is the only thing read from
              the file.  The rest of the line can be anything you like and
              can be used to document the sequence.  If this is not supplied
              the observing sequence output is not generated.

 OUTPUTS:

 KEYWORD OUTPUT PARAMETERS:

 COMMON BLOCKS:

 SIDE EFFECTS:

 RESTRICTIONS:

 PROCEDURE:

 MODIFICATION HISTORY:
  Written by Marc W. Buie, Lowell Observatory, 1997/05/23
  2015/05/15, MWB, Massive overhaul and upgrade for more functionality
  2015/06/11, MWB, added FWHM keyword
  2024/07/06, MWB, rework for new obs tools