NAME:
  juploc
 PURPOSE:
  Find and extract Jupiter in images and create PDS FITS headers on output.
 DESCRIPTION:
 CATEGORY:
  CCD data processing
 CALLING SEQUENCE:
  juploc,root,imnum, $
       PATH=path, OUTPATH=outpath, PANG=in_pang, PSCALE=pscale
 INPUTS:
  root  - String, contains the date root of the file name to be read.
  imnum - Integer value or array of image number to process.
             File names are root+'m.'+imnum  (imnum converted to 3 digit string)
 OPTIONAL INPUT PARAMETERS:
 KEYWORD INPUT PARAMETERS:
  BORDER  - Border around Jupiter for extracted image (default=15).
  LATITUDE - String containing latitude for observatory, this value overrides
             the value expected in the header.  Format MUST exactly match this
             example:      '+37:20:36.0'
  LONGITUDE - String containing longitude for observatory, this value overrides
              the value expected in the header.  Format MUST exactly match this
              example:      'W 121:38:12.0'    (use E for East longitude)
  ALTITUDE  - String containing altitude for observatory, this value overrides
              the value expected in the header.  Format MUST exactly match this
              example:      '1290.0'    (in meters)
  PATH    - Directory in which to look for data (default = current directory)
  OUTPATH - Directory in which to write data (default = current directory)
  PANG    - Position angle of Jupiter's north pole on image, this is the
             standard astronomical position angle measured eastward from
             North but in this case, take the top of the image as "north"
             and image must have the proper handedness on input.
  PSCALE  - Plate scale of image in arcsec/pixel.  Default=0.5 but this
             default is fairly meaningless.  This needs to be the right
             value or cropped image will be the wrong size.
  AUTO    - Flag, if true suppresses request for mouse confirmation.
             Be careful with this, there is no clean way to interrupt
             things if something goes wrong.
 OUTPUTS:
 KEYWORD OUTPUT PARAMETERS:
 COMMON BLOCKS:
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
  96/07/14, Written by Marc W. Buie, Lowell Observatory
  96/08/12, MWB, added BORDER, LATITUDE, LONGITUDE, ALTITUDE  keywords.
  96/09/18, MWB, invert PCCD images, plus /AUTO keyword.