Getting UHDAS and CODAS from repositories

This is the way of the future. This will provide you with a recent tested CODAS installation that works with most datasets produced by UHDAS, VmDAS, or DAS2.48 for the following RDI ADCPs:

• OS150, OS75, OS38
• NB150
• WH300
• BB75

Bug fixes and improvements will make their way into the the Mercurial distribution after testing; see hg-update.

Our source code and most documentation are now in Mercurial repositories to allow version control, documentation of changes, and access over the web There are a still a few zip files to download to complete the CODAS suite. Using Mercurial facilitates updates, but you will need to compile the code yourself. This can be done easily on all the common operating systems–Linux, Windows, and OSX–but is easiest on Linux. (instructions below)

New installation

1. Install Python 2.5, or 2.6 (not 3.x).
2. Install Matlab (up through R2007b); we have not tried R2008 or later.
3. Download CODAS programs
4. Get supporting tools and compile (compiler and build tool)
5. Set up your paths:
   • unix
   • windows
6. optional: install additional python functionality (codas python extension code, numpy+matplotlib)

Updating

If you used Mercurial and “hg clone” to populate your adcp_programs directory, you should be able to update the contents of those directories and recompile, without having to upgrade all the underlaying tools (python, scons, compiler, ...)

1. Update the documentation and demos

   There is no upgrade path for adcp_doc and q_demos. These must be deleted and replaced from the zip archives located here.

   • documentation (this has bugfixes, so changes occasionally)

     • adcp_doc.zip : documentation, including CODAS, ADCP processing,

       reading LTA or single-ping data with matlab, downloads and setup...

   • practice data (these change only rarely)

     • qdemo_pingdata.zip : the original demo
     • qdemo_vmdas.zip : RDI’s VmDAS averaged (LTA) and single-ping (ENX) data
     • qdemo_uhdas.zip : Univ Hawaii acquisition and processing
     • qdemo_hdss .zip: Revelle’s HDSS sonar

2. Update CODAS programs

   Change directories to your adcp_programs directory and update the repositores as follows:

   cd adcp_templates
   hg pull -u   http://currents.soest.hawaii.edu/hg/hgwebdir.cgi/adcp_templates
   cd ..
   
   cd codas3
   hg pull -u   http://currents.soest.hawaii.edu/hg/hgwebdir.cgi/codas3
   cd ..
   
   cd matlab
   hg pull -u   http://currents.soest.hawaii.edu/hg/hgwebdir.cgi/matlab
   cd ..
   
   cd pycurrents
   hg pull -u    http://currents.soest.hawaii.edu/hg/hgwebdir.cgi/pycurrents
   cd ..

3. recompile codas3

   read “INSTALL.txt” in the codas3 directory. From that directory, for example:

   • linux, 32-bit:

     scons platform=lnx

   • OSX intel, 32-bit:

     scons platform=osxintel

   • Windows, 32-bit:

     scons platform=win32

4. recompile pycurrents

   Change directories to pycurrents. Read the comments in “runsetup”, then:

   python runsetup.py

That’s it.