[The following information is not intended to be understandable without referring to the corresponding source files.]
Version 8a is more powerful than version 7b (e.g. beam coordinates are now supported). However, apart from the bug fixes, it is not expected that any of the modifications changes the final velocity profiles significantly.
| p.debug | (default.m) Set to values > 0 to add debug stops to processing. Defaults to 0. |
| p.cruise_id | (default.m) cruise id. Not used, only stored. Defaults to unknown. |
| p.getdepth | (laproc.m) get depth from LADCP data either using the old getdpth.m or the new getdpthi.m; in V7b only the new getdpthi.m is available. Defaults to new version. |
| p.navtime_av | (getdpthi.m, various CTD and nav load routines) navigation-time averaging interval. Defaults to 2 minutes. |
| p.bottomdist | (laproc.m) Defaults to 0. When set to 1, bottom-distances in raw data are ignored and re-calculated from sea-bed echo (related to RDI firmware bug). |
| p.ctdmaxlag | (loadctd.m) Defaults to 100. Max allowed lag for merging CTD with LADCP data. |
| p.pg_save | (loadrdi.m) Defaults to 3. When set to 0, %-good are not saved. |
| p.savemat | (savearch.m) Defaults to 0. When set to 1, archiving output is written to *.ladcp.mat. |
| p.savecdf | (savearch.m) Defaults to 1. When set to 0, netCDF files are not written. Needs Matlab netCDF library. |
| p.saveplot | (resolve.m) Defaults to 1. Save processing plots as PostScript files. V7b automatically saved ProcFig. 1 and nothing else. |
| ps.velerr | (getinv.m) Super-ensemble velocity error used for weighting the inversion. The default is calculated from real data. |
| att.* | (cruise.m) Data attributes; used for batch processing (netCDF output). |
| p.guessbottom | (getdpthi.m) Defaults to NaN. Setting this to a finite value helps finding the seabed in difficult situations. |
| p.zbottom | (getdpthi.m) Defaults to NaN. This can be set to the known bottom depth, in which case the bottom-depth is not estimated. |
| ps.dragfac | (getinv.m) default changed from 0 to tanh(p.maxdepth/2000)*0.2). |
| pk.zrange | (getkzprof.m) default changed from 1000 to 500m. In V7b, this parameter was set, but a hard-coded value of 1000m was used. |
| p.name | (loadrdi.m) new default is "unknown". |
| f.ladcpup | (loadrdi.m) new default is " ". |
| p.drot | (loadrdi.m) default changed from 0 to NaN. |
Files that probably have to be adjusted for each cruise (e.g. loadctd.m) were moved from the main m into the mlocal directory.
[Actually the following files were not really deleted, but moved from the main m to the m/misc directory.]
| gettilt.m | calculate tilt offset; not used in either version. |
| plotcomp.m | plot compass comparison btw. up- and downlooker; not used in either version. |
| clearallbut.m | auxilary routine; called from mlocal/batchprocess/ladcpbatch.m, i.e. only used with Visbeck's batch processing. |
| cruise.m | used for netCDF/html generation. |
| getbtrack.m | calculate post-processed bottom-track velocities; called from laproc.m. (NB: in this version, BT-related code is still found all over the place; see description of changes between versions 8a and 8b for more details.) |
| getfile.m | heuristic to find raw LADCP data files; only used in batch processing. |
| getserial.m | get ADCP head serial number; called from laproc.m. |
| htmltable.m | build html table; only used for Visbeck batch processing and in cruise.m. |
| localmax2.m | fit parabola to data and find max; used in getbtrack.m and loadrdi.m. |
| num3str.m | number to string conversion with formatting; used fairly extensively; COULD BE REPLACED BY sprintf()!!! |
| openwindows.m | open all windows, filling screen; called from laproc.m. |
| IGRF00.m | international geomagnetic reference field; cosmetic change. |
| IGRF95.m | old international geomagnetic reference field; not used; cosmetic change. |
| bestlag.m | find temporal offset btw. 2 time series; used in loadrdi.m and various loadctd routines; small change. |
| default.m | set some parameter defaults, comments regarding some more; version number change; many comments regarding parameters (these may or may not be correct reflections of changes elsewhere!); some parameter changes (see above). |
| getdpth.m | old depth-from-ADCP-data routine; start-time calculation change; plotting changes; NaN-related(?) bug fix. |
| getdpthi.m | new depth-from-ADCP-data routine; extensive re-write, with several new parameters. |
| getinv.m | main inversion solver; small change to drag model; some changes which I don't understand, related to array sizes; changes to SADCP weighing; change in GPS weighing when LADCP profile has gaps. |
| getkz.m | diffusivity estimation; called from getkzprof.m; one small change related to N2 estimation (median instead of mean); change related to velocity correction with comment saying that the change is untested. |
| getkprof.m | diffusivity estimation; cosmetic changes. |
| ladcp2cdf.m | create netCDF files; added attributes. |
| lanarrow.m | remove least consistent 1% of data for 2nd pass of processing; called from presolve.m; bug fix. |
| laproc.m | main processing routine; open all windows at start; added debug stops; changed comments; changed order of loading auxiliary data; add workaround for RDI firmware bug involving bad BT ranges; allow selection of depth-from-LADCP data method using p.getdepth. |
| loadrdi.m | load raw ADCP data files; added support for p.pg_save; added support for beam coordinates; changes in BT code (use parabolic fit to get bottom distance); several cosmeic changes (no more broken beans :-). |
| outlier.m | remove outliers; used in loadrdi.m, prepinv.m; added code for removing BT outliers. |
| plotinv.m | create ProcFig. 1; cosmetic changes. |
| plotraw.m | create ProcFig. 2; fairly extensive changes, related to 3-beam solutions and broken & weak beams. |
| prepinv.m | calculate super-ensembles; a few minor bug fixes and added fields. |
| presolve.m | main processing between laproc.m and resolve.m; made SADCP loading optional. |
| rditype.m | return ADCP header data; bugfixes due to data types (signed vs. unsigned, &c). |
| readme.m | "active" documentation callable from matlab; cosmetic changes. |
| resolve.m | final processing; made diffusivity profile calculation optional (dependent on existence of pk structure); added support for multiple figures. |
| savearch.m | save data after processing; significant re-write, mainly cosmetic. |
| saveres.m | save standard .mat & .lad files; cosmetic chages; add error to .lad files. |
| whoami.m | wrapper for UNIX whoami; called from default.m; adapted to system() routine. |
| © 2005 A.M. Thurnherr (e-mail) | created: Tue Aug 16 11:55:59 2005 | modified: Wed Aug 17 15:05:10 2005 |