Merge pull request #159 from GeoscienceAustralia/release-v4.0.0

Release v4.0.0

Author: seballgeyer

.github/workflows/build.yaml

@@ -3,6 +3,101 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
+# [4.0] 2025-12-16
+
+## Added
+
+A Qt-based Graphical User Interface (GUI) for Ginan
+
+Ginan and GUI binaries for Linux, MacOS and Windows
+
+Major improvement in handling state errors in pre-fit and post-fit outlier screening
+
+New TRACE file plotting script (plot_trace_res.py)
+
+RNX2 --> RNX3 phase signal mapping in config
+
+Check on difference between BRDC and Kalman clocks before alignment
+
+Additional info to TRACE files for monitoring (snr, azimuth, signal data availability)
+
+Postfit omega test and address its numerical instability
+
+Incorrect error count increments (For phase rejects, receiver error counts and satellite error counts)
+
+Option to reset filter at specific times (periodic_reset)
+
+## Changed
+
+VCPKG as the primary package manager for Ginan
+
+Started refactor of code to use OpenBLAS / LAPACK instead of Eigen - including RTS and core Kalman filter <br>
+(Improved efficiency with up to 30% faster on network runs)
+
+TRACE epoch from week / sec to generic datetime
+
+Use normal epoch instead of transmission time for satellite clock initialisation
+
+Improved SPP via Code bias correction
+
+Improved higher order ionospheric corrections in IF combination mode
+
+Improvements and restructure of Least squares estimation code
+
+EDA Updates:
+
+- Add ability to view differences for States and Measurements
+- Check data exists before plotting
+- Fix plotting of satellite / site availability
+- Add cycle detection info to database
+
+LEO drag and SRP coefficient estimation (Properly estimate and resolve conflict with EMP estimation)
+
+Update variance before detecting cycle slips
+
+Trop SNX file written for all stations now
+
+Pass LLI flags through to savedSlip
+
+Move from better_enum to magic_enum
+
+Rename Ginan LLI flags to "retrack"
+
+
+## Fixed
+
+Mutex compilation problem for OSX arm64
+
+noTime with Sp3Write when filtered states not available
+
+Day-bound no date issue and finite vs mincon inconsistency
+
+Elevation calculation in preprocessor (PEA can run in preprocessing-only mode)
+
+NaN biases in SSR bias map
+
+Limit tropospheric model to reasonable heights
+
+Correctly write out Antenna delta in RNX file (H/E/N)
+
+IERS mean pole function to use TT time
+
+Ensure commit hash is generated for every compilation (help with ID version)
+
+Errors in writing POS and GPX files when RTS is on
+
+Issues with Chunking (rewrite)
+
+RNX file reading (Correct field width)
+
+Cmake file so loading software can compile
+
+## Deprecated
+
+## Removed
+
+## Security
+
 # [3.1] 2024-09-02
 
 ### Added

CHANGELOG.md

@@ -1,22 +1,29 @@
 
-> **2 Sept 2024** - the Ginan team is pleased to release v3.1.0 of the toolkit.
+> **16 Dec 2025** - the Ginan team is pleased to release v4.0.0 of the toolkit.
 >
-> The improvements delivered by this version include:
+> **Main Highlights**:
+>
+> * Introduce Ginan binaries for Linux, MacOS and Windows
+>   * The binaries can be found on the GitHub website:
+>     * [Ginan Binaries](https://github.com/GeoscienceAustralia/ginan/releases/tag/v4.0.0)
+> * Introduce a Qt-based Graphical User Interface (GUI) for Ginan:
+>   * Simply open RNX file and choose from drop-downs
+>   * Download the GUI from GitHub release page
+>   * Works across Linux, MacOS and Windows
+>   * Built using PySide 6
+>   * A user manual for the GUI can be found here:
+>     * [Ginan GUI User Manual](https://github.com/GeoscienceAustralia/ginan/tree/main/scripts/GinanUI/docs/USER_GUIDE.md)
+>
+> ![GinanGUI Screenshot](images/GinanGUI-screenshot.png)
+> *A screenshot of the Ginan GUI in action.* 
+>
+> **Major Changes**:
+>
+> * Major refactor: use OpenBLAS / LAPACK instead of Eigen
+>   * Refactored RTS code
+>   * Refactored core Kalman filter code
+>   * Improved efficiency (up to 30% faster on network runs)
+> * Major improvement in handling state errors in pre-fit and post-fit outlier screening
+> * Move to vcpkg as the primary package manager for Ginan
+> * Add RNX2 --> RNX3 phase signal mapping in config
 >
-> * Boxwing model for the albedo
-> * Sisnet (SouthPan) message support
-> * SLR processing capability
-> * PBO Position (.pos) format file output support
-> * Apple silicon (M-chip) support
-> * VMF3 file download python script (get_vmf3.py)
-> * POS file visualisation python script (plot_pos.py)
-> * EDA improvements
-> * Improved documentation
-> * Use case examples updated
-> * Frequency dependent GLONASS receiver code bias estimation enabled
-> * Improved missing/bad data handling
-> * Bias rates from .BIA/BSX files parsed and used
-> * Measurment and State error handling sigma_limit thresholds separated
-> * Config file reorganisation (rec_reference_system: moved to receiver_options:)
-> * Clock code handling modified
-> * Many bug fixes.