=====================================================================
              == Pinkel Sonar Hdss files ======

    Your Mileage May Vary: this is unsupported sofware (it was developed out
    of necessity, but is not actively being used or developed)

    (for example, no frills)

    (1) run
           adcptree.py vg0501 --datatype hdss

    (2) change directories to vg0501/ping and link the files into this
           directory with the python program "link_hdss.py"
           - this will create files that sort correctly in ascii order
           - remember to escape the wildcard, eg:
                   make a directory vg001/data
                   copy the data to that directory
                   cd vg0501/ping
                   run: "link_hdss.py ../data 50\*"

    (3) then "cd/load" and edit "hdss_params.m" for your dataset
              Look at load_hrdata.m: if anything needs to be edited,
              do so, and run this step by hand (otherwise quick_adcp.py
              will make a copy like this one and run it)
        In matlab, in the load directory, run "load_hrdata"
    (4) then "cd .." back to the processing directory
    (5) When you get to the 'scan' stage,  go to another window and 
             look at the output files *.tr and *.scn to make sure you have 
             the 'proc_yearbase' and 'yearbase' (logging yearbase)  right.
    (6) When you get to the 'load' stage, skip the 'make cmd and bin' stage
        Say 'yes' to 'load cmd and bin into codas database'
        Proceed with the remainder of the steps.
    (7)For example
       quick_adcp.py --cntfile q_py.cnt

    ### q_py.cnt is
    --proc_yearbase 2005            # for decimal day conversion
    --yearbase  2003                # if data were acquired relative to 2003
    --dbname a0501                  # database name; in adcpdb
    --instname hr50                 # instrument name (for matlab files)
    --datatype hdss                 # datafile type
    ### end of q_py.cnt


   quick_adcp.py --cntfile  q_pyrot.cnt

       Note: As of Jan 2008, all 4 beams are back for both instruments
       and various electronics have been updated.  Some variables names
       have been changed; read the documentation on the web for more info:
       http://currents.soest.hawaii.edu/docs/adcp_doc/hdss_doc/index.html

       This addition to quick_adcp.py is not as automatic as most others,
       so watch for instructions below.  Check the links in
       "adcp_processing.html" in the processing directory.

 NOTES: You are running unsupported software  You are brave.  You are stuck.
        Best of luck.  If you're serious about getting HDSS data into codas
        I may be able to help, but this is not a task for the faint of heart.

       Prequisites:
       (1) You should already know how to process pingdata or LTA data with 
           this suite (quick_adcp.py + CODAS), i.e. stages II and III.  You
           need to know how to recognize bad velocities.

       (2) You should know how to process ENX data and be familiar with the
           data in ENX files.  The HDSS code was hacked from the ENX code.
           See the on-line help (or adcp_processing.html, created when you 
           run adcptree.py).  See also single-ping documentation, starting 
           with this decription:

           "quick_adcp.py --commands singleping

       (3) Energy, hope, enthusiasm, dogged persistence.
           There are undoubtably bugs in the code, the HDSS data format 
           has its own bugs and may have changed since this version was 
           written, and it's not clear what the quality of the velocities 
           will be once you're done.  But the vertical shears should be 
           good.


    ========================================================================