Updating CODAS from Mercurial repositoriesΒΆ


As of April 2013, this version of the documentation is no longer maintained; however, it is consistent with the last (now retired) version of CODAS processing that used Matlab. We no longer update or fix the Matlab processing code, but we will maintain the Matlab code that reads CODAS Matlab output. Although the notes refer to both Python and Matlab processing, none of the code here will be maintained. This (now retired) documentation and code will remain available for awhile longer.

Python processing code is actively maintained and developed, and CODAS Python processing is documented here.

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 or qpy_doc. These must be deleted and replaced from the zip archives located here.

    • documentation (this has bugfixes, so changes occasionally)

      • adcp_oldpymatdoc.zip : documentation, including CODAS, ADCP processing, reading LTA or single-ping data with matlab, downloads and setup...
    • practice data (these change only rarely)

      • qpydemos_oldpymatproc.zip : new pingdata demo
      • qpydemos_vmdasdata.zip : RDI VmDAS practice data
      • qpydemos_uhdasdata.zip : UHDAS practice data
  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_oldpymat/adcp_templates
    cd ..
    cd codas3
    hg pull -u   http://currents.soest.hawaii.edu/hg_oldpymat/codas3
    cd ..
    cd matlab
    hg pull -u   http://currents.soest.hawaii.edu/hg_oldpymat/matlab
    cd ..
    cd pycurrents
    hg pull -u    http://currents.soest.hawaii.edu/hg_oldpymat/pycurrents
    cd ..

These are a new addition, for Python processing. If you already have them, you can update them as follows. (Otherwise, see the mercurial cloning instructions:

cd onship
hg pull -u    http://currents.soest.hawaii.edu/hg_oldpymat/onship
cd ..

cd uhdas
hg pull -u    http://currents.soest.hawaii.edu/hg_oldpymat/uhdas
cd ..
  1. recompile codas3

    Compile codas3 first:

    Go to the codas3 directory compile as in these examples:

    linux, 32-bit:

    scons platform=lnx

    linux, 64-bit:

    scons platform=lnx64

    OSX intel:

    scons platform=osxintel


    scons platform=win32

  2. (full CODAS Python only): recompile pycurrents

    Change directories to pycurrents

    then type:

    python runsetup.py