Setting up
CODAS3 shipboard ADCP data processing software


Please let us know if you are downloading zip files and want to be informed if there are updates or bug fixes.



What you need from other sources:

What you need from us:

Optional but recommended:
Old examples or demos: (no longer supported, but probably work)

The corresponding *.lst files are just directory listings of the zip files, so you can see what is in each, including the directory structure.


download codas3 files




How to install:

Everything is archived using the "zip" utility from InfoZip, and should be installed using "unzip" or a Windows equivalent.  You almost certainly already have one of these, or, if using Linux, can add it from your distribution. If you don't, see the Info-ZIP website for current downloads. If you have access to ftp only, then go to ftp.uu.net/pub/archiving/zip and find the subdirectory for your particular system.

All zip files are intended to be unzipped in the SAME DIRECTORY (denoted PROGRAMS in various documentation). In our case, it is /home/noio/programs; unzipping then creates /home/noio/programs/codas3 and /home/noio/programs/matlab, with many subdirectories in each of these. Generally, these subdirectory trees and the files they contain should not be changed by users. For example, don't run the tutorial where it lands when you unzip it--see below for instructions.

On the assumption that anyone processing ADCP data will have a windowing system with a browser, there is a new and expanding collection of HTML documentation. A list of documentation files will land in PROGRAMS/index.html, which contains a link to the starting point for ADCP processing. This link is also accessible over the internet.


FOR UNIX:
In your .cshrc (or .profile, or wherever you keep your shell setup instructions) add to your path the location of the executables for your machine: this includes the binary executables, and the locations of csh and python scripts. We install everything under /home/noio/programs, so we add the following to our path: To use quick_adcp.py, you will need to add three locations to your  PYTHONPATH environment variable:
You should also add the location of the matlab directory which was extracted from cmat.zip (we would add /home/noio/programs/matlab to our MATLABPATH environment variable). Any time you run matlab programs you should type "adcppath; radcppath" to add the appropriate programs to your path.  Alternatively, you can put these commands in your ~/matlab/startup.m file.


To run a Python script: if it is on your path, you can simply type its name to execute it. The permission should already be set to executable, and the top line is "#!/usr/bin/python", which is correct for Linux systems.  If you are on another Unix-like system, you will need to change this top line to give the correct path to your python executable.

FOR WINDOWS

Suppose (for example) everything was extracted into c:\programs.  Then you would add these to your path
and set the following environment variable (for your case):
You should also go into your matlab path editor and add c:\programs\matlab to the path, and save it. Any time you run matlab programs you should type "adcppath; radcppath" to add the appropriate programs to your path. Alternatively, run the commands once, then go to "Set Path" and "Save".

Note that you must restart your machine after changing autoexect.bat or config.sys for the changes to become effective. (More explict instructions are contained here
HINT: The path to your PROGRAMS directory may be quite long. You can create a network share of the folder containing
PROGRAMS (recommend "read only", and then "map network drive") and assign the folder a drive letter (such as "N"). Then the above description would use "n:\programs" instead of "c:\programs".

Running python scripts is not as simple under Windows as under Unix; you can't simply invoke the python script by name.  Instead, we provide batch files with similar names to invoke the scripts, as described  here.



Documentation for processing data using CODAS software starts here.