NAME:
  finder
 PURPOSE:   (one line only)
  Interactive finder chart tool
 DESCRIPTION:
  This widget tool will allow you to load a FITS image with astrometric
    information (format generated by astinfo.pro).  From this starting
    point it will resample the image to the scale and orientation needed
    to match your telescope or instrument system.  It has modes to permit
    tracking an object as well as controlling orientation for equatorial
    or alt-az telescopes (with no de-rotator).

  In the main image display window a left click will place the marked at
    that position.  As you move around the window (without clicking) you
    see the coordinates under the cursor and the offset from the current
    marker position.

  Toolbar functions:
    File
      Open Image
        Browse and find a FITS image to be displayed.  Upon sucessfully
          loading an image with astrometric information the display is reset
          for the current scale and orientation but putting the image center
          and marker at the center of this image.  Observatory and time
          settings are not changed.
      Save as PNG
        Snapshot of screen image to a png format graphics file.  The name is
          automatically generated.  The first part of the file name is the
          observatory string as shown in the widget.  Next, the current date
          and time is appended.  These three fields are separated by "_" and
          file suffix is .png.
      Exit
        Quit program.  There is no auto-save of the configuration.

    Tools
      Set Position Angle
        You are prompted for a new position angle for the display.  If in
          equatorial mode this the position of north on the display measured
          clockwise from up.  Center and marker positions are not affected.
      Toggle Horizon Mode
        There are two modes, equatorial and local horizon modes.  In equatorial
          mode the normal display is north up.  in local horizon mode, the
          normal display is the zenith direction to be up.  Any position
          angle in effect is unchanged.
      Toggle Image Flip
        Change the handedness of the display.  The normal display is
        sky-normal (with no rotation and equatorial mode, north is up and
        east is to the left).  This is implemented as an inversion in the
        RA axis.  That means you cannot control the direction of north with
        this control.  Use the position angle control instead.
      Marker to Center
        Shift location of marker to match the current center of the image.
      Center On Marker
        Shift location of image center to match the current position of the
          marker.

    Config
      Load Configuration
        Load and use a configuration setup.  See discussion of CONFIG keyword
           provided below.
      Image Size
        Change image size. You will be asked to input two numbers, the x and
          y sizes of the image to change to.
      Image X Size
        Change image X size. You will be asked to input one number for the
          new x size of the image.
      Image Y Size
        Change image Y size. You will be asked to input one number for the
          new y size of the image.
      Image Scale
        Change the image scale to the provided number in arcsec/pixel.
      Last Config
        Not implemented.

 CATEGORY:
  Astronomy
 CALLING SEQUENCE:
  finder
 INPUTS:
 OPTIONAL INPUT PARAMETERS:
 KEYWORD INPUT PARAMETERS:
  CONFIG - Name of a configuration file to load on startup.  File suffix used
             for this is '.fdr'.  A configuration file saves the image
             display, orientation, scale information, and the observatory
             information.  At present, the only way to get such a file is to
             make it yourself by hand.  The format is as follows:

    Line 1 - ID line, must say FINDER v1.0 starting at column 1.
    Line 2 - observatory code or location enclosed in quotes.  An observatory
                code is a 3-character string as defined by the Minor Planet
                Center or a a manual position where you list the latitude
                and longitude of the observatory location.  You can provide
                this in either sexigesimal notation or decimal degrees
                (lat and lon are both in degrees in this case).  Direction
                from prime meridian and equator is denoted by a letter (not a
                sign) -- E for east, W for west, N for north and S for south.
    Line 3 - xsize of displayed image.  This is limited to be no bigger than
                80% of your overall screen size.
    Line 4 - ysize of displayed image.  This limited to be no bigger than 95%
                of your overall screen size.
    Line 5 - image scale for displayed image (arcsec/pixel)
    Line 6 - Image flip, 0=no, 1=yes
    Line 7 - Horizon mode, 0=equatorial, 1=local horizon
    Line 8 - position angle (degrees)
             
 OUTPUTS:
 KEYWORD OUTPUT PARAMETERS:
 COMMON BLOCKS:
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
 MODIFICATION HISTORY:
  2010/06/22, Written by Marc W. Buie, Southwest Research Institute
  2010/07/09, MWB, added numerous features
  2011/03/21, MWB, fixed some of the control logic related to the marker
                     tools and added a new "marker to center" tool.
  2016/06/02, MWB, converted to usage of astcvt tools, added support for
                     "standard" WCS supported by Astronomy Users Library
                     tools.  My astrometry information is searched for first,
                     if not found will try extast.
  2016/08/05, MWB, fixed a bug that caused the image to be displayed with the
                     wrong orientation when in the horizon-lock mode.  The
                     image was actually self-consistent with the labels but
                     was not the orientation requested.
  2019/11/01, MWB, added Reload configuration tool
  2021/01/04, MWB, changed saved png file name to eliminate ':', due to this
                     it is now recommended to use decimal degrees for lat/lon
                     when providing a manual location rather than sexigesimal.
  2022/05/28, MWB, added save of image to an unannotated FITS file with
                     wcs information included.