Useful tools

These tools require the full Python CODAS installation. In all cases, you will need to type the name with --help to get more information about usage.

Some of these are pretty simple, some are more sophisticated.

General purpose view a collection of files, eg:

  • view all PNG files in all subdirectories

    of current working directory

  • dirname : view all PNG files in subdirectories of “dirname”

  • *.png : view all PNG files in the current directory select start/end sections for dday,lon,lat eg:

  • nav/dbname.gps
  • This program is used for section selection in (see below)
  • Guidelies for choosing sections are here


  • convert YYYY/MM/DD hh:mm:ss time to CODAS decimal day (relative to YEAEBASE), eg:

    to_day 1970    2015 5 18 8 30 00
    to_day 2015    2015 5 18 8 30 00


  • convert CODAS decimal day (relative to a yearbase) into YYYY/MM/DD hh:mm:ss:

    to_date 2015 137.354

Explore CODAS data : plot lon, lat over topography, eg:

  • nav/aship.gps update processing directory with png figures (NOTE: If the processing directory is old, additional information may be necessary.

  • --yearbase YYYY --all : use in one of four modes

  • : CODAS data viewer

  • -c : compare two CODAS databases (same cruise)

  • -e: edit a codas database
    • call from edit directory
    • same as
  • -p : view singleping data as well
    • call from edit directory
    • assumes processing directory is correctly configured for full Python Processing, including the existence of the raw data and rbin files compare phase and amplitude between 2 CODAS datasets

Overview of datasets

  • print out some useful information about VmDAS files

  • print out some useful information about a UHDAS dataset

UHDAS serial data

  • list recent raw, rbin, gbin files, or lines from raw files

  • plot 1-2 serial feeds (rbin files). If feeds have the same fields, plot the difference. Longitude and latitude diffs are plotted in meters

  • plot rbin positions over topography

  • plot $PASHR heading accuracy from a collection of rbins

  • plot $PASHR heading accuracy from a UHDAS dataset

  • plot all configured heading devices from a UHDAS directory

Raw ADCP data

  • plot 4 beams of raw adcp data: (velocity, amplitude or correlation)

  • estimate the transducer angle relative to the bow of the ship from beam-coordinates data (UHDAS *.raw or VmDAS *.ENR)

CODAS processing: account for horizontal GPS and ADCP separation

For more detail about ADCP Transducer-GPS offset (maneuvering), click here

CODAS processing: fixing holes in heading correction

  • run from cal/rotate

  • --help has extensive help

  • summary:
    • read ens_hcorr.asc
    • plot heading correction, stddev, number of pts
    • gives graphical access to filtering options
    • allows manual editing
    • interpolate through holes
    • write new (patched) file and make figures
    • print instructions to use the new file

For more detail about, click here

CODAS processing: make a web site

  • creates web pages like each of these (one for each ADCP)
  • manually select sections: --interactive
  • can also run with automated settings
  • uses for section selection

Guidelies for choosing sections are here

CODAS processing setup (advanced)

  • link files from multiple legs (OSX,linux)

  • remake rbins (gets most of them; do the rest manually with or (more information about rbin messages is here)