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

figview.py: view a collection of files, eg:

  • figview.py: view all PNG files in all subdirectories

    of current working directory

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

  • figview.py *.png : view all PNG files in the current directory

txyselect.py: select start/end sections for dday,lon,lat eg:

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

to_day:

  • 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
    

to_date:

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

    to_date 2015 137.354
    

Explore CODAS data

plotnav.py : plot lon, lat over topography, eg:

  • plotnav.py nav/aship.gps

quick_mplplots.py: update processing directory with png figures (NOTE: If the processing directory is old, additional information may be necessary.

  • quick_mplplots.py --yearbase YYYY --all

dataviewer.py : use in one of four modes

  • dataviewer.py : CODAS data viewer

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

  • dataviewer.py -e: edit a codas database
    • call from edit directory
    • same as gautoedit.py
  • dataviewer.py -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

plot_reflayer.py: compare phase and amplitude between 2 CODAS datasets

Overview of datasets

vmdas_info.py

  • print out some useful information about VmDAS files

uhdas_info.py

  • print out some useful information about a UHDAS dataset

UHDAS serial data

showlast.py

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

plot_rbins.py

  • 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_rnav.py

  • plot rbin positions over topography

plot_pashr.py:

  • plot $PASHR heading accuracy from a collection of rbins

plot_posmv.py:

  • plot $PASHR heading accuracy from a UHDAS dataset

plot_hbins.py:

  • plot all configured heading devices from a UHDAS directory

Raw ADCP data

plot_rawadcp.py

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

EA_estimator.py

  • 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

patch_hcorr.py

  • run from cal/rotate

  • patch_hcorr.py --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 patch_hcorr.py, click here

CODAS processing: make a web site

quick_web.py

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

Guidelies for choosing sections are here

CODAS processing setup (advanced)

link_uhdaslegs.py

  • link files from multiple legs (OSX,linux)

mk_rbin.py

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