=============================================================================
======================   Gplot user "documentation" =========================
======================      (such as it is)         =========================

This software might be very useful.  It was written but is
unsupported.  If you can make use of it, that is good.  



This program is best run from the root adcp processing directory (eg. 
/home/moli4/datasets/ron_brown/rb0202).  There are three types of plots
types available: vector, contour, and panel plots.  If you have Python 
installed, you can run a gui interface for adcpsect (top right button).

The usual use of gplot is to choose one of the plot types, choose "load data",
and then "continue".


When you are asked to "Select section with XYTZOOM ...", a window pops up 
     with the longitude, latitude, and decimal day plotted against each 
     other.  Zoom in to select the part of the cruise track you want.  
     STAY IN THE BLUE panel.  If you want to change to a different panel, 
     click on its button and zoom in that panel.   Click 'accept' when done.


Here are the plot type descriptions:

---------------------------------
Vector: 
(I) setup:
  Data: choose an adcpsect output file (*_xy.mat).  Quick_adcp.prl will
           create suitable adcpsect output in the vector directory,
           called "vect_uv.mat" and "vect_xy.mat".  These are 60-minute 
           profiles with 50m resolution.
  Default: ./vector/*_xy.mat

  Output Directory: choose a directory to save any configuration or plots
  Default: ./vector
(II) plotting:
  choose a section, choose plot properties, then click "Update & Preview"

---------------------------------
Contour:
(I) setup:
  Data: choose an adcpsect output file (*_xy.mat) Quick_adcp.prl will
           create suitable adcpsect output in the contour directory,
           called "cont_uv.mat" and "cont_xy.mat".  These are 15-minute 
           profiles with 10m resolution.
  Default: ./contour/*_xy.mat

  Output Directory: choose a directory to save any configuration or plots
  Default: ./contour
(II) plotting:
  choose a section, choose plot properties, then click "Update & Preview"

---------------------------------
Panel:
(I) setup:
    Data: choose a codas3 ADCP database by selecting the *dir.blk file.
    Default: adcpdb/*dir.blk
         
    Output Directory:  choose a directory to save any configuration or plots
    Default: ./edit
    
    Extraction: If you have an adcpsect output file (used above) for your
                entire cruise, select "yes" and choose that file.  (Life is 
                easier).  If you choose "no" then you have to enter the 
                information by hand.  Choosing the file is easier: choose one
                that covers the whole cruise time range.

(II) plotting:
  choose a section, choose plot properties, 
  click "Update" to fill in the time range; 
  check number of days and panels per day
  then click "Update & Preview"