Matlab Gui tool for editing shipboard CODAS3 data, "gautoedit":


(pronounced "gee! autoedit! ")


I. Introduction


The "autoedit" package is a collection of programs for extracting and displaying velocity and other ancillary data from a codas database in panel plots, and creating ascii files of flags for bad data. As with the original "waterfall" editing, the ascii files containing information about bad data are then applied to the database so that further data extraction will not include those flagged values.


A new perl program (quick_adcp.prl) can set up the gautoedit files and run through all the basic processing steps. It is useful for a quick look at a dataset and is sufficient for processing most shipboard ADCP datasets. It can handle data from DAS (pingdata files) or from VmDAS (LTA files), though the latter requires a separate load step. Advantages to using quick_adcp.prl include (1) standardized names (2) automatic setup of gautoedit files (3) consistency in parameters (4) steps are recorded in a log file (5) many parameters can be changed on the command line (6) it is relatively painless to delete a database and start over (7) runs under MS Windows. Read this document for more information.



Notes:

This html documentation is meant to give you an introduction to tthe autoedit package and provide some guidance as to its use. It is not a comprehensive editing tutorial, so some detail is lacking. Data come from two sources: (1) the same pingfiles that were used in the original "demo", and a much newer dataset that contains Ashtech headings in the user buffer and some good illustrative editing examples.




-------------------------------

Jules Hummon , 6/2002


II. Setting up gautoedit

Two text files exist describing the autoedit package and the gui tool (gautoedit) to use it: aREADME_basics.txt, which describes how to configure up the setup files, and aREADME_details.txt, which describes the editing parameters and what they control.
Please read them in conjunction with this document.

III. gautoedit: gui panel layout

The gui panel has four sections:
Gautoedit always plots a panel figure with ocean velocities (rendered absolute via navigation steps). By default it will also plot a vector plot of upper ocean velocities overlaid on topography. This can be turned off. You can choose to plot amplitude and velocity in the forward direction. You can also choose to plot error velocity and an experimental parameter called "bias parameter" (undocumented: indicator for underway bias in the presence of strong scattering layers).

IV. Editing ADCP data

(1) starting out

(2) a typical sequence of steps

(3) Other things to edit

(4) Interpretation: things to keep in mind

(5) finishing up

When you have gone through the whole dataset, you have a collection of ascii files. You need to update the following before you attempt to make any plots or assess whethere anything more needs to be done:

applying the flags to the database: (in any order)

badbin ../adcpdb/edemo abadbin.asc
badbin ../adcpdb/edemo badbin.asc
dbupdate ../adcpdb/eemo abadtimes.asc
dbupdate ../adcpdb/edemo abottom.asc
dbupdate ../adcpdb/edemo badprf.asc
dbupdate ../adcpdb/edemo badtimes.asc
dbupdate ../adcpdb/edemo bottom.asc
dbupdate ../adcpdb/edemo abadprf.asc

and then, in order:
set_lgb ../adcpdb/ademo
setflags setflags.tmp

and finally, (in order) update the navigation :
refsm (or adcpsect and refabs and smoothr)
putnav putnav.tmp


Remember, you will still have to run adcpsect, refabs, and smoothr before updating the reference layer plots or doing any watertrack calibrations.