; $Id: albatross.pro,v 1.11 2003/06/05 23:14:28 mankoff Exp $
; 
; $Author: mankoff $
; $Revision: 1.11 $
; $Date: 2003/06/05 23:14:28 $
;
;
;+
; NAME:
;	ALBATROSS
;
; HELP: http://lasp.colorado.edu/albatross/
;
; PURPOSE:
;	This procedure allows the user to view Mariner Mars 1971 UVS
;	footprints and reflectance (as a function of wavelength) on a
;	background of either MOLA, MDIM, GEO, TES data, or just a map grid.
;
; CATEGORY:
;	Mars, Mariner, Visualization
;
; CALLING SEQUENCE:
;	ABATROSS, location=location | DAS=das
;             Use one and only one of the location or DAS keywords
;
; INPUTS:
;   LOCATION: A 2 element vector, containing the center of the image
;       in latitude and longitude (0 to 360 West) respectively
;
;   DAS: A DAS time. The image will be centered on location of the UVS
;       footprint nearest to this time.
;
;   NOTE that one and only one of LOCATION and DAS must be set to
;   specify the center of the image. 
;
; KEYWORD PARAMETERS:
;   SIZE: The area (in degrees latitude) for the image to
;       cover. Default is 20x20 degrees 
; 
;   REV: An orbit (revolution) number. If set, only UVS footprints
;       taken during this rev will be shown
;
;   DRANGE: A 2 element range of DAS times. Only UVS spectra taken
;       after DRANGE[0] and before DRANGE[1] will be shown.
;
;   BACKGROUND: A string specifying the background to use for the
;       Martian surface. Default is 'MOLA'. Valid backgrounds are:
;       'GEO', 'MDIM', 'MOLA', 'TES', and 'NONE'
;
;   NO_MOTION: Set this keyword to only display footprints when the
;       instrument platform was stationary. 
;
;   MAPPING_ONLY: Set this keyword to only display footprints that
;       were taken during the mapping sequences of each orbit. See
;       the "JPL Technical Memorandum 33-585 Volume II, Mariner Mars
;       1971 Television Picture Catalog, Sequence Design and Picture
;       Coverage" document (available at http://lasp.colorado.edu/albatross/)
;       for more information.
;
;   RANDOM: Set this keyword to run a randomized Albatross session,
;       where the location, size, and background are all randomly
;       generated unless specified by the user.
;
;   NOTE: It is recommended to have /MAPPING_ONLY and /NO_MOTION set
;   most of the time, as they clean the data quite well.
;
; OPTIONAL OUTPUTS:
;   REFLECTANCE: Set this keyword to a variable that will contain an
;       array of structures of UVS reflectance. Each structure
;       represents one footprint, and contains the reflectance and
;       orbital parameters of the footprint.
;
;   WAVELENGTH: Set this keyword to a variable that will contain the
;       array of wavelengths (units: Angstroms) that the reflectance
;       should be plotted against.
;
;   ARRAYDB: Set this keyword to a variable that will contain an array
;       of the data on the screen. The array will be a FLOAT array of
;       366 by the number of footprints shown. Indices 0 through 316
;       will be the reflectance, and the rest of the array (318
;       through 365) will be bookkeepping and orbital paramaters. See
;       the website (or the procedure ALBATROSS_STRUCT2ARRAY) for more
;       information on this variable.
;
; KEYBOARD INPUTS:
;   b: blink the nearest (or "active") footprint
;   l: List all TV images in the image (and allow viewing)
;   p: Pause/unPause Albatross. Albatross will not interact with the
;      mouse when paused, and will not grab the window for plotting.
;   q: Quit the program
;   r: Switch between 
;      * Plotting reflectance of the nearest footprint [ DEFAULT mode ]
;      * Plotting the reflectance ratio. The denominator is set to the
;        spectra of the nearest footprint (at the time of the
;        keypress). The numerator is set to the nearest footprint as
;        the mouse moves around the screen.
;   t: Display the TV image associated with the nearest footprint
;
; SIDE EFFECTS:
;   * Modifies the current color table.
;
; RESTRICTIONS:
;   * Color problems exist when displaying TV images in conjuction
;     with the footprint viewer on some displays.
;
; BUGS: 
;   They exist. Please email mankoff@lasp.colorado.edu and report them
;
; PROCEDURE:
;   * See README file(s)
;   * See code.
;   * See "JPL Technical Memorandum 33-585, Mariner Mars 1971
;     Television Picture Catalog, Sequence Design and Picture
;     Coverage"
;   * see http://lasp.colorado.edu/albatross/
;
; EXAMPLE:
;   SEE http://lasp.colorado.edu/albatross/ for a tutorial.
;
;   NOTE: you should usually have /NO_MOTION and /MAPPING_ONLY set.
;   NOTE: Use keyboard. See "KEYBOARD INPUTS" above for documentation
;
; MODIFICATION HISTORY:
;   Written by: Ken Mankoff, 2002-06-07, LASP (mankoff@lasp.colorado.edu)
;   2002-07-04; KDM; Added wavelength and arrayDB keyword outputs,
;                    Modified so only one window is present at a time. 
;   2002-07-06; KDM; Added mouse info widget. Improved code cleanliness
;   2002-07-27; KDM; Added XYOUTS to plot (duplicates mouse info widget)
;   2002-08-16; KDM; changed mouse-click to Pause/unPause. Moved mouse
;                    info widget+xyouts to permanent corner display.
;   2002-08-18; KDM; Added /RANDOM keyword. Ratio now has a usable
;                    fixed yrange based upon the current denominator.
;-