Python compatibility note

Every effort is made for

  • to be internally consistent
  • to prompt the user if something is missing
  • to have decent defaults for most common circumstances

If you run the command --help, the processing options should look like this:

To see commands for various data types, use --commands as follows.
--------------------------------------   ------------------------------ --commands  postproc     :   UHDAS post-processing --commands  uhdaspy      :   UHDAS processing --commands  ltapy        :   LTA or STA files (averaged) (**) --commands  enrpy        :   ENR files (beam coords) --commands  pingdata     :   original pingdata demo
======================================   ==============================

(**) LTA and STA processing can now be processed more quickly using Try typing --help for more information

If the command --help produces any references to matlab processing, then your programs are old and this version of the documentation will have limited use. You should have your own copy of the documentation in the directory where you put the CODAS software. That is the appropriate resource, because it should be consistent with your own code. This would be an excellent time to install a new Virtual Computer so you are running up-to-date code.

Postprocessing an older cruise

When runs, it caches (stores) some commandline options in a file called dbinfo.txt. This file is used to look up values that do not have defaults, which were specified during the original run, so you do not have to type them again each time. There are some cases in which these values might change: expects a specific format and values in the file, so do not edit this file by hand.


If you are post-processing a UHDAS dataset that was processed at sea by an earlier version of the software (eg. using Matlab), then there is no dbinfo.txt file. This file caches processing information for to use, so you do not have to retype the same information every time you run it. If that file does not exist, you must supply the information so can generate the file properly.

The best bet is to do something benign like get the calibrations, and let prompt you (complain) as each variable is discovered missing: go ahead and specify the missing information as needed. Once has enough information, it will write the values out to dbinfo.txt and proceed. You will probably have to provide values for variables such as yearbase, --cruisename, --sonar, --beamangle. This step is a small but unfortunate requirement for compatibility of newer software with older processing directories.

Run --steps2rerun calib --auto

At each error, include the information in the command line until it runs.

ERROR solution: add to commands
ERROR – must select datatype “–datatype uhdas”
ERROR – must set “sonar” “–sonar os38nb”
ERROR – must set “beamangle” “–beamangle 30” (see NOTE #1)
ERROR – must set “yearbase” “–yearbase 2010”
ERROR – must set “ens_len “ “–ens_len 300” (see NOTE #2)
ERROR – must set “cruisename” “–cruisename km1001c”

NOTE #1: The variable ens_len (seconds per averaging enseble) must match the averaging length in seconds that was used when originally processing the data.

NOTE #2: Beam angles are usually (but not always) as follows:

instrument beam angle (degrees)
os38, os75, os150 30
wh300, wh600, wh1200 20
bb75, bb150, bb300, bb600 usually 30
nb150, nb300 usually 30

Example: --steps2rerun calib --datatype uhdas --cruisename km1001c --yearbase 2010 --sonar os38nb --beamangle 30 --auto