Release v1.2.4 of DynAdjust
Overview
This release contains various code enhancements that address issue #24. Specifically, this release provides support for handling the WGS 84 ensemble and six specific WGS 84 realisations, including WGS 84 (Transit), WGS 84 (G730), WGS 84 (G873), WGS 84 (G1150), WGS 84 (G1674), WGS 84 (G1762), and WGS 84 (G2139).
The DynAdjust binaries attached to this release are for Windows 10 (x64) and have been built using Intel® oneAPI version 2022.1.3.
General
Several code changes and enhancements effecting multiple programs include:
- New epsg codes and datum labels for the WGS 84 ensemble and WGS 84 (xxxx), including:
wgs84
|wgs84 (transit)
|wgs84 (g730)
|wgs84 (g873)
|wgs84 (g1150)
|wgs84 (g1674)
|wgs84 (g1762)
|wgs84 (g2139)
wgs84
is taken to mean the WGS 84 ensemble, whereaswgs84 (xxxx)
is taken to mean any one of the specific WGS 84 realisations (e.g.wgs84 (g2139)
).wgs84
is synonymous withwgs 84
, and both are interpreted case-insensitively.- Exception handling updated to permit use of the WGS 84 ensemble and WGS 84 (xxxx).
Enhancements to import
- Permit the use of any one of the WGS 84 datum labels in input DNA and DynaML files, and for the default reference frame (via the command line option
--reference-frame
). - Provide a warning if
wgs84
(i.e. the WGS 84 ensemble) is supplied as the default reference frame. - Data may be supplied in either the WGS 84 ensemble or WGS 84 (xxxx) with or without an epoch.
Enhancements to reftran
- Added hard coded substitutions for WGS 84 (xxxx) to ITRFxxxx to facilitate transformation of WGS 84 data to other reference frames. All substitutions are performed prior to undertaking a reference frame transformation.
- Station coordinate and/or measurement data aligned to WGS 84 without an epoch will cause reftran to terminate prematurely. Data aligned to WGS 84 (xxxx) without an epoch, will cause the associated epoch to be set to the date at which the WGS 84 (xxxx) frame realisation was adopted.
- Any attempt to transform station coordinates and measurements to WGS 84 will cause reftran to terminate prematurely.
DynAdjust User's Guide
Several changes have been made to reflect the new behaviour, including:
- 3.3.1 Reference frame receives a general overhaul and a new section entitled "Handling data aligned to WGS 84"
- Chapter 4 sees various improvements throughout, including
- Revised epsg codes, and new epsg codes for WGS 84 (xxxx) and WGS 84 ensemble.
- Updated 4.6.2 Relationship between ITRF, IGS and WGS 84 reference frames.
- Updated 4.7.1 Progress reporting and import log.
Windows installation
DynAdjust v1.2.4 has been built using Intel® oneAPI version 2022.1.3. In order to successfully run DynAdjust v1.2.4 binaries, users will need to upgrade to the latest version of Intel® oneAPI (see https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit-download.html). The specific dll dependencies are:
- libiomp5md.dll
- mkl_avx2.2.dll
- mkl_core.2.dll
- mkl_def.2.dll
- mkl_intel_thread.2.dll
Acknowledgements
Special thanks to Joel Haasdyk for his help in shaping the preferred behaviour for handling WGS 84 data.