.. ......................................
.. UHDAS/CODAS restructured text document
.. ......................................

Adcpsect -- extraction of velocity data from a codas database
=============================================================

You must at least have access to the executable file "adcpsect" for
your computer.


If you are at sea with a UHDAS installation, you can use the copy on
the ADCP computer, *currents*. Executables are compiled for most common 
architectures and operating systems, and are available on the shared 
"programs" directory in the programs/codas3/bin/[architecture] directory.
See `this link <mounting_disks.html>`_ for isntructions about network shares.

Or, if you choose to install the CODAS binaries, you can download the zip file
for your operating system `here <../../../zipped>`_.  Installation instructions
are `here <../../codas_setup/index.html>`_.  Look for the name binXXX.zip
for your computer.


Adcpsect requires a control file and is run as 

::

  adcpsect adcpsect.cnt

It will write files to the disk which can then be read by matlab.

Additional information:

    - adcpsect is available in the
      `postscript manual <../../local_doc/manual.ps>`_

    - `output data format <adcpsect_output.html>`_ for contour_uv.mat,
      contour_xy.mat and other output files

    - the generic "self-documenting" `adcpsect
      control file <txtfiles/adcpsect_cnt.txt>` (with all options listed)

    - an `example adcpsect.cnt file <adcpsect_example.html>`_
      to extract every profile

Procedure:

1 download example control file from web link
2 modify example control file (adcpsect_example.cnt)
3 run as

      adcpsect adcpsect_example.cnt