Skip to content

Changelog

0.3.0

Released on 01.05.2026

Description

First release after user feedback

Development status as of release. Everything is tested and works.

There were some modifications for working in a cmd-line / script-based way as well as additions to the dashboard (GUI).

Added

  • Readme now includes information about potentially missing EOP data when installing and using gravitools for the first time
  • Dataset now offers extended statistics about uncertainty calculations (SEM, SD h, Threshold Allan value) and instrument sensitivity values of a measurement
  • These statistics are now also included in the parameters shown in the PDF report
  • Visualization of the protocol part of the dashboard can now be toggeld with shortcut "ctrl+j"
  • Datasets processed in dashboard can now save the processed gravity time series to csv-files (as well as netCDF)
  • Dashboard now offers the possibility to analyze and visualize collimator scan files
  • gravitools can now also be installed via conda-forge
  • changes in raw data of AQG-GUI >2.0 have been implemented, supporting both major GUI versions
  • dashboard offers to analyse tilt calibration and coriolis measurements
  • PDF reports for tilts and coriolis measurements
  • dashboard: modified protocol, comprising minimal information necessary, can now also be saved, loaded and saved as PDF

EOP data

There is now an easier way for users to download EOP data after first package installation. A entry_point (script) was added that has to be run in a commandline after installation: download_eop_data. The manual download and local storage, as also described in the documenation, still works as well.

Coriolis effect calcualtion

Before a new AQG gui verions (<2.0.0), Coriolis effect was included in the systematic bias value. Now it has its own (constant) data column in the raw data files. For most operators, the practice is that one gravity value per point is the result of 2 averaged North and South oriented measurements. If this is the case, Coriolis gets corrected by methodology and SHOULD NOT be corrected for via the data.

The standard now in gravitools is that this correcion is always accounted for if present in data (thus resolving potential confliects with older data structures). If it is NOT DESIRED, it has to be explicitly put in a config file, which is passed during data processing (see documentation for more information!)

Changed

  • Allan Deviation calculations now include uncertainty values based on stable32 calculations (also now by default included in adev-plots)
  • Some plots in the dashboard now plot with thicker lines
  • AQG STANDARD HEIGHT, meaning the height above the measurement point to which the final absolute gravity value is transferred (using the provided vertical gravity gradient) is changed from **1.25 m (FG-5X height) to 0.00 m (marker on point).

Documentation

After an announced major release of the underlying documenation build service, MKDocs, which introduced backward-incompatibility, the documentation engine was switched from mkdocs to zensical. See more information at: https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/ Relevant for gravitools are:

  • no more support for plugins
  • no more support for themes

This affects especially the use of jupyter notebooks and docstring-based API documentation.

The new engine zeniscal, developed by the group around Material for MKDocs, supports most of these features already (althought they are still in further development). The only preliminary decision was now to convert our jupyter notebooks prior to building the documentation. This was tested and approved.

The related modifications should be in line with requirements by ReadTheDocs-documentation building. Please note that the documentation-based requirements changed (as indicated in the readme and pyproject.toml files).

Removed

None

Bug fixes

  • Loading datasets now possible even if the tidal parameters are missing in the .info-file (Thanks to Thorben Döne)
  • Auto-reload for datasets processed via the dashboard (GUI) now works as would be expected

0.2.0

Released on 08.12.2024

Description

Initial release of gravitools

Development status as of release. Everything is tested and works. This presents a somewhat boiled down but re-worked and stable version, which is intended to work for most of the end-users. We consider this first release as beta and improvements will be made as well as features added before reaching 1.0.

Added

All relevant files for the first stable structure of the package.

Changed

None

Removed

None