======================================================================
H I S T O R Y
doc: Mon Oct 12 16:09:24 2015
dlm: Tue Dec 6 12:46:47 2022
(c) 2015 A.M. Thurnherr
uE-Info: 458 5 NIL 0 0 72 3 2 4 NIL ofnI
======================================================================
----------------------------------------------------------------------
V1.0:
- First Released Version (howto does not cover VKE parameterization)
----------------------------------------------------------------------
Oct 12, 2015: - finalized HowTo V1.0 (antsLibVer V6.2, ADCP_tools V1.3)
- uploaded to Mercurial server
----------------------------------------------------------------------
V1.1:
- First Version with Full HowTo (including VKE parameterization)
----------------------------------------------------------------------
Oct 12, 2015: - V1.1beta1
- added [version.pl]
- adapted to version.pl: [LADCP_w_ocean] [LADCP_w_CTD]
[LADCP_VKE] [LADCP_w_postproc]
- modified [LADCP_w_CTD] to allow processing ASCII CNV files with
wrong number of scans in header
Nov 25-27, 2015:
- minor mods to [LADCP_w_ocean] to try to get it to work on
Windows (R. Robertson)
Dec 22, 2015: - removed Plots/ Documentation/ Dec_17_2010/ Dec_24_2010/
Dec_30_2010/ Oct_11_2011/ Jul_04_2011/ from repo
- moved PostProces.sh to Utilities/ and modified README
Jan 4, 2016: - decreased default vertical resolution to 20m [defaults.pl] [LADCP_w_ocean]
- removed beta from version [version.pl] [.hg/hgrc]
----------------------------------------------------------------------
V1.2:
- First Widely Released Version (many significant improvements)
----------------------------------------------------------------------
Jan 5, 2016: - V1.2beta
- updated [version.pl]
- added support for [ADCP_tools_lib.pl]: [version.pl] [LADCP_w_ocean]
Jan 24, 2016: - added QC for mean residuals
- added QC for dual-head wprofs
- added automatic editing of bad time lagged data
Jan 25 -- Mar 8:
- many bug fixes and small improvements
Mar 8, 2016: - added updated howto pdf
- updated [version.pl] with new ANTSlib prerequisite version
- published as V1.2beta
Mar 9, 2016: - V1.2beta2
- added hab field to .wprof output [LADCP_w_ocean]
Mar 10, 2016: - published
Mar 13, 2016: - V1.2beta3
- updated [version.pl] [.hg/hgrc]
- added simple ASCII CTD format [LADCP_w_CTD]
- added auto directory creation to [defaults.pl]
- updated howto
- published V1.2beta3
- updated [version.pl] [.hg/hgrc] to V1.2beta4
- added ADCP-file checks in [LADCP_w_ocean]
- updated howto
Mar 16, 2016: - V1.2beta4
- published on server
- updated [version.pl] to beta5 (gmt5)
- adapted to GMT5
Mar 17, 2016: - V1.2beta5
- updated [.hg/hgrc]
- various plot improvements
- updated howto
- published
- V1.2beta6 [version.pl] [.hg/hgrc]
- changed surface-wave stat in [LADCP_w_ocean]
Mar 18-29, 2016: V1.2beta6
- [LADCP_VKE]:
- added -k to supply external eps
- re-designed QC checks (slope estimates)
- several other minor improvements
- [LADCP_wspec]:
- added median # of samples to output
- [LADCP_w_CTD]:
- added support for $ENV{VERB}
- [LADCP_w_ocean]
- added -r)ms residual filter with 4cm/s default cutoff
- fixed a couple of minor bugs (Sv correction had been disabled)
- replaced CTD w with CTD acceleration in wprof plots
Mar 29, 2016: - V1.2beta6
- update antsMinLib to 6.6, perl-tools to 1.5 [version.pl]
- updated howto
- exported [default_paths.pl] from [defaults.pl]
Mar 30, 2016: - V1.2beta7
- updated [version.pl] [.hg/hgrc]
- [LADCP_w_CTD]: added station as optional 3rd header field in
ASCII format
Mar 31, 2016: - improved version %PARAMs in all utilities
- [LADCP_VKE]
- added averaging of spectra (inc. setting PARAMs)
- improved %PARAMs (also in [LADCP_wspec])
- fixed slight bug in [LADCP_wspec]
- removed code to generate different output names on -d/-u
- added -q
Apr 3, 2016: - reduced low-p0 cutoff from 1e-7 to 5e-8 in [LADCP_VKE]
- similarly reduced equatorial band from 5 to 3 degrees
Apr 6, 2016: - fixed GMT-5 related bug in [LADCP_w_ocean]
- increased calibration constant by 20% in [LADCP_VKE]
- updated howto
- published V1.2beta7
Apr 14, 2016: - V1.2beta8
- [LADCP_w_postproc] improved warning messages
Apr 16, 2016: - [LADCP_VKE] allow for nans in LADCP_wspec output
- updated [version.pl]
May 12, 2016: - updated version to 1.2
- updated HowTo
- published
----------------------------------------------------------------------
V1.3:
- Adding Corrections For Beam-Pointing Errors
----------------------------------------------------------------------
May 12, 2016: - updated [version.pl]
- [LADCP_w_ocean] added fields to wsamp output
May 17, 2015:
May 18, 2015: - [LADCP_w_ocean] added fields to wsamp output
- modified _wprof fig (mean instead of rms tilts)
- minor mods elsewhere (e.g. version info in all plots)
- added new plots [defaults.pl] requiring mods to [LADCP_w_ocean]:
- [plot_acceleration_residuals.pl]
- [plot_attitude_biases_w.pl]
- [plot_attitude_residuals.pl]
- [plot_residual_profs.pl]
- removed assumption of 1500m/s ADCP soundspeed setting (various files)
- added correct w12, w34 for Earth velocity data
May 19, 2016: - updated to ADCP_tools V1.6 (coord trans interface change)
May 24: 2016: - implemented bin-depth caching
- improved LADCP_w_postproc plot
- improved various plots (esp. for partial-depth casts)
May 25, 2016: - updated version to V1.3beta1 [version.pl] [.hg/hgrc]
- published
May 26, 2016: - V1.3beta2
- updated version to V1.3beta2 [version.pl] [.hg/hgrc]
- udated ANTS_tools lib to V1.7 (beam interpolation)
- adapted [LADCP_w_ocean] to beam interpolation
- minor improvement to [LADCP_w_postproc]
- improved [plot_wprof.pl]
Jun 1, 2016: - improvements to [LADCP_w_ocean]
- added [default_output.pl]
- added [plot_residuals12.pl] [plot_residuals34.pl]
Jun 2, 2016: - minor improvement and bug fix in [LADCP_w_ocean]
Jun 3, 2016: - minor bug fix in [LADCP_w_ocean]
Jun 6, 2016: - minor improvement in [LADCP_w_ocean] [defaults.pl] [edit_data.pl]
Jun 8, 2016: - removed plot_attitude_biases_w.pl
- slight improvement to [plot_attitude_residuals.pl]
Jun 11, 2016: - began debugging w12 & w34 for Earth-coord data [LADCP_w_ocean]
Jul 7, 2016: - major BUG in [LADCP_w_ocean] (beam-pair velocities for Earth
coord data)
Jul 12, 2016: - docu in [defaults.pl]
Jul 29, 2016: - minor plotting bug in [LADCP_w_CTD]
Jul 31, 2016: - minor bug in [LADCP_w_ocean] [defaults.pl]
Aug 5, 2016: - committed version found on whoosher after repair
- manually uploaded from ECOGIG cruise laptop:
- [LADCP_w_ocean] changes since Jun 11, 2016
- [defaults.pl] changes since Jun 2, 2016
- [LADCP_w_CTD] changes since May 26, 2016
- updated [version.pl] to require ANTSlib V6.7
- updated HISTORY
Aug 16, 2016: - [LADCP_VKE] increased -l default 1.2e-7 based on UK2.5 SR1
repeat section
Dec 22, 2016: - [LADCP_w_ocean] moved $opt_p to [defaults.pl]
Dec 23, 2016: - [LADCP_w_ocean] minor bug
Sep 1, 2016: - [LADCP_VKE] changed -l to mean epsilon, and increased value to 1e-10
Mar 6, 2017: - [LADCP_w_ocean] minor bug
- [time_lag.pl] minor bug
Mar 7, 2017: - added time lines to [plot_time_lags.pl]
Mar 9, 2017: - tightened timelag editing condition in [time_lag.pl]
- updated [HISTORY]
Mar 12, 2017: - adapted to antslib V6.8 [version.pl]
- adapted ADCP_tools to V1.9
- increased -o default from 20 to 40m
- updated to V1.3
Mar 15, 2017: - added [loadANTS.pl] for V1.3
- updated howto
Mar 16, 2017: - published
----------------------------------------------------------------------
V 1.4
----------------------------------------------------------------------
Oct 3, 2017: - added -q option to LADCP_w_CTD for reprocessing as 1Hz files
Oct 12, 2017: - re-wrote code in [LADCP_w_ocean] to deal with Earth coordinates
(MAJOR BUG FIX)
Oct 13, 2017: - bugfix in [edit_data.pl]
Oct 17, 2017: - improvements and bugfix in [LADCP_VKE]
Nov 26, 2017: - significant bug fixes in [LADCP_w_ocean] related to
- ping-coherent residual removal
- bad beam
Nov 27, 2017: - improved gap heuristics in [time_series.pl]
- added @valid_ensmeble_range [defaults.pl]
Nov 28, 2017: - increased version to V1.4 [version.pl] [.hg/hgrc]
- worked on updating howto
- improvements to [LADCP_w_ocean]
- removed wcorr plot from [LADCP_w_postproc]
Nov 29, 2017: - replaced opt_i by initial_time_lag in [defaults.pl]
Dec 9, 2017: - removed common options from [LADCP_w_ocean] [LADCP_w_postproc]
[LADCP_wspec] [LADCP_w_CTD] [LADCP_VKE]
Dec 14, 2017: - improvements to [LADCP_wspec]
Dec 17, 2017: - added dependencies to [LADCP_w_ocean] [LADCP_w_CTD]
Mar 8, 2018: - improvements to [LADCP_w_CTD]
Mar 9, 2018: - improvements to [LADCP_w_CTD]
Mar 20, 2018: - added blue background color for in-ice profiles in [plot_wprof.pl]
- fixed acceleration unit error in [plot_wprof.pl]
Mar 22, 2018: - adapted howto
- massively improved time-lagging heuristic [time_lag.pl]
- improved [plot_time_lags.pl]
Mar 27, 2018: - bugfix to new time lagging heuristic in [time_lag.pl]
Apr 24, 2018: - improvements to [LADCP_w_ocean] [LADCP_VKE] [defaults.pl]
Apr 25, 2018: - improvement to [LADCP_VKE]
May 1, 2018: - added reflr_u filter in [LADCP_w_ocean] [edit_data.pl] [time_series.pl]
- added ambiguity velocity check in [LADCP_w_ocean]
May 2, 2018: - bug fixes in [LADCP_w_ocean], related to
- reflr threshold
- PPI
- adapted [defaults.pl] to reflr_u filter
May 13, 2018: - fixed bug in [LADCP_wspec]
May 16, 2018: - improvement to [LADCP_wspec]
May 22, 2018: - improvement to [LADCP_w_CTD]
Jul 24, 2018: - improvement to [LADCP_w_CTD]
Sep 13, 2018: - added '.' to library path in [version.pl]
Oct 4, 2018: - improvements to [LADCP_w_CTD]
Oct 5, 2018: - improvements and bugfix in [LADCP_w_CTD]
Oct 31, 2018: - improvements to [LADCP_w_postproc]
Nov 1, 2018: - improvements to [LADCP_w_postproc]
Nov 2, 2018: - 2-beam residuals bug fix in [LADCP_w_ocean]
Nov 17, 2018: - updated [HISTORY]
- updated prerequisites in [version.pl]
- updated [LADCP_w_howto.pdf]
- updated [.hg/hgrc]
- published V1.4
----------------------------------------------------------------------
V2.0
- lots of bug fixes
- major new features:
- dropped CTD scans handled correctly (no more apparent clock drifts)
- support for data files collected with Nortek Signature instruments
- much improved data editing
- significant changes:
- no minimum limit for eps_VKE
- updated for GMT6
- much better data quality information in summary plots
----------------------------------------------------------------------
Mar 25, 2019: - [LADCP_w_CTD] changed error message to allow creating 1Hz from 4Hz file (SBE19)
- [LADCP_w_CTD] BUG: ITS was not set. How is this possible?????
Apr 12, 2019: - [LADCP_w_ocean] added logfile error message for non-existing file
Apr 18, 2019: - [LADCP_w_ocean] added addtional RDI coordinate transformation %PARAMs
Apr 21, 2019: - [LADCP_w_CTD] modified code to allow production of 24Hz files (previous code required
min 2 samples per bin, allowing for max 12Hz sampling rate)
- [LADCP_w_ocean] BUG: removed duplicate warning about lacking water-depth info
Aug 27, 2019: - [LADCP_w_CTD] began adding correction for dropped CTD scans
Aug 28, 2019: - [LADCP_w_CTD] made it work
- [LADCP_w_CTD] added -g
Aug 30, 2019: - [LADCP_w_CTD] renamed -g to -m)odulo error correction (not)
- [LADCP_w_CTD] added -f)ill missing data
Sep 10, 2019: - [LADCP_w_ocean] BUG: -i was erroneously listed as the initial CTD time offset
Sep 12, 2019: - [LADCP_VKE] disabled default -l cut-off (used to be 5e-11 W/kg)
- [LADCP_w_ocean] modified .prof output layout to be consistent with [LADCP_w_postproc]
Oct 29, 2019: - [plot_*.pl] updated psscale -B to gmt5 syntax
May 15, 2020: - [LADCP_w_ocean] BUG: re-binning on -r did not work for v12 and v34
- [LADCP_w_ocean] BUG: before re-binning, upcast v12 and v34 were actuall from DC data
- [LADCP_w_ocean] BUG: all beam-pair velocity stats were contaminated by missing values
- [LADCP_w_ocean] made bin residuals per beam pair
- [default_output.pl] removed a couple of time-depth plots from level 1
- [default_output.pl] changed semmantics so that pushing to plot adds,
instead of overwwriting
- [default_output.pl] BUG: one of the plots did not repect plotting level
- [plot_mean_residuals.pl] adapted to bin-residuals separate per beam pair
- [plot_mean_residuals.pl] added orange range
- [plot_mean_residuals.pl] slightly relaxed green range
May 16, 2020: - [LADCP_w_ocean] BUG: write_residual_profs() clobbered layout
- [plot_wprof.pl] added residual profile data to background
May 23, 2020: - [plot_wprof.pl] BUG: windows without samples made program bomb
May 25, 2020: - added [write_residual_profs.pl]
Jun 22, 2020: - [LADCP_w_ocean] sscorr_w renamed to remove conflict with [RDI_Coords.pl]
Jun 26, 2020: - [LADCP_w_CTD] added salinity -b)ias correction
Jun 29, 2020: - [svel_corrections.pl] renamed sscorr_w to remove conflict with RDI_Coords.pl
Mar 17, 2021: - [LADCP_w_ocean] turned multi-ping error into warning (for Nortek files)
Mar 23, 3021: - [LADCP_w_ocean] adapted to ADCP_tools V2.4 (Nortek PD0 files)
- [plot_wprof.pl] BUG: instrument frequency was rounded to 100kHz
Apr 29, 2021: - [LADCP_w_CTD] improved warning message
Jun 29, 2021: - [LADCP_w_CTD] improved plot labelling
Jun 30, 2021: - [LADCP_w_CTD] improved plot labelling
- [LADCP_w_ocean]
- BUG: rms instead of mean tilt was reported in fig
- added pitch/roll/tilt to output profile
- [default_output.pl] renamed plot_mean_residuals to plot_bin_residuals
- [plot_bin_residuals.pl] renamed from plot_mean_residuals.pl
- [plot_wprof.pl] improved quality semaphore
Jul 1, 2021: - [LADCP_w_ocean] made %PARAMs more standard
- [LADCP_w_ocean] added %dc_w.mu, %uc_w.mu
- [plot_bin_residuals.pl] adapted to more standard %PARAMs
- [plot_wprof.pl] replaced bin setup by <w> in legend
- [LADCP_VKE] made %PARAMs more standard
- [LADCP_w_postproc] made %PARAMs more standard
- [LADCP_w_postproc] added -z to remove biases
- [LADCP_w_postproc] added %?c_w_diff.rms to output
- [LADCP_w_postproc] BUG: dc_corr returned strange rms
- [acoustic_backscatter.pl] [bottom_tracking.pl]
[find_seabed.pl] [plot_backscatter.pl]
[plot_correlation.pl] [plot_residuals12.pl]
[plot_residuals34.pl] [plot_wsamp.pl] [time_lag.pl] made %PARAMs more standard
Jul 6, 2021: - [LADCP_w_ocean] BUG: %uc_w.mu was off by factor 2
Jul 7, 2021: - [plot_wprof.pl] added colored background to <w>
- [LADCP_w_postproc] reversed logic of -z (enables bias correction by default)
- [LADCP_w_postproc] BUG: plot had label in wrong location for single-head profiles
Jul 9, 2021: - [LADCP_w_ocean] added LR_RMS_BP_RESIDUAL, dc_lr_bp_res.rms, uc_lr_bp_res.rms
- [LADCP_w_ocean] added residuals profile filter
- [defaults.pl] - added $layer_residuals_rms_max
- [plot_wprof.pl] adapted to new residual editing (calculation in LADCP_w_ocean)
- [LADCP_w_postproc] added window correlation stats
- [LADCP_w_postproc] updated %PARAM names
- [edit_data.pl] added editHighResidualLayers()
Jul 11, 2021: - [LADCP_w_ocean] added %dc_w.var, %uc_w.var
- [LADCP_w_ocean] reduced warning associated with residuals profile filter
- [LADCP_w_ocean] disable time-lag filtering for transmission-error corrected CTD files
Jul 13, 2021: - [LADCP_w_ocean] set dc_w.mu, dc_w.var to nan on insufficient data
- [LADCP_w_ocean] BUG: residuals profile filter bombed when no data were removed
- [LADCP_w_ocean] BUG: rms BT discrepancy was broken (residuals profile filter)
- [LADCP_w_ocean] BUG: *_w.var did not respect -k
- [LADCP_w_CTD] improved gaps PARAMs
- [LADCP_w_CTD] added clock/transmission warnings
- [LADCP_w_postproc] BUG: dc_sig, dc_rms confusion
Jul 23, 2021: - [LADCP_w_ocean] added %ADCP_type
- [LADCP_VKE] returned to published empirical calibration constant (20% difference is not significant)
- [LADCP_VKE] added calibration constant to output metadata
- [LADCP_VKE] changed opt_a default from nan to 0 (ambient mixing)
- [LADCP_VKE] BUG: -z default was only 1, which means that -k20 from LADCP_w_ocean applies; in
practice I found with A20 that there are the effective value is >60; which means
that this bug did not matter much in practice
- [LADCP_VKE] changed calibration constant back, because it makes sense, and because it is now
recorded in the meta-data
- [LADCP_w_postproc] added summary info to plot
- [LADCP_w_postproc] added seabed to plot
- [LADCP_w_postproc] added annotations to plot
Jul 24, 2021: - [HISTORY] updated
- V2.0 released
...
Dec 6, 2022: - V2.2 released