Skip to content

Release v1.2.4 of DynAdjust

Compare
Choose a tag to compare
@rogerfraser rogerfraser released this 09 Mar 06:21
· 232 commits to master since this release
7443f0a

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, whereas wgs84 (xxxx) is taken to mean any one of the specific WGS 84 realisations (e.g. wgs84 (g2139)).
  • wgs84 is synonymous with wgs 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.