grav-toolbox 0.3.8

Gravity survey utility tools

GravTools

GravTools is an open source software toolbox for the analysis of relative gravity surveys. GravTools is developed at Austria's Federal Office of Metrology and Surveying (BEV).

• The source code is hosted on github.com: https://github.com/ahellers/GravTools
• The python package is published on pypi.org: https://pypi.org/project/grav-toolbox/

Installation

The python 3 package is available on the Python package index website (pypi.org) and can be easily installed using pip.

Install python package with pip:

pip install grav-toolbox

Optional dependency for GIS data export

GravTools allows users to export adjustment results to shapefiles for data visualization in external GIS programs (e.g. QGIS). To enable these features the optional package "geopandas" needs to be installed by executing: pip install grav-toolbox[gis]

Release notes

More details are provided along with version tags on github.

0.3.3 (2025-01-08)

• New dialog for drift determination based on the reduced observations as shown in the observations plot. One drift polynomial is fitted per station. This feature is useful for calculating the drift correction coefficient for Scintrex CG5 and CG6 meters based on stationary observations.

0.3.4 (2025-02-07)

• Fixed bug in the data export dialog.

0.3.5 (2025-09-24)

• Fixed bug: The survey name was recognized as instrument S/N when loading CG6 solo observation files.

0.3.6 (2026-01-02)

• Loading a new json gravimeter file now triggers the calculation of updated gravity reductions.
• Future pandas warning concerning timezone aware datetime64 types fixed.
• Bugfix: Problem when loading stations with integer-type statio names from CSV files fixed (resulted in duplicated entries in the station list).
• Handling of station filters in the GUI (stations tab) improved.

0.3.7 (2026-03-27)

• Fixed syntaxWarning that was caused by regex expressions in the CG5 observation file loading method.
• The setup IDs are now created based on the observation reference time and the survey name (combined hash). This allows multiple observations at the same time in different surveys within one campaign. Now it is possible to analyze campaigns with two ore more gravimeters being used in parallel.
• Fixed a bug that caused an error when reading negative dhf values from the instrument height column in LynxLG CG6 observation files.

0.3.8 (2026-05-20)

• Fixed compatibility with pandas >= 3.0: replaced in-place .values[:] = 0 writes with direct Series assignment to comply with Copy-on-Write semantics (survey.py); fixed ValueError: assignment destination is read-only in Longman (1959) tidal correction caused by .values returning a read-only array from a pandas Index (longman1959.py).
• Fixed compatibility with NumPy >= 2.0: replaced deprecated np.NAN with np.nan (mlr_bev_legacy.py) and replaced broken .values.astype(np.int64) / 10**9 datetime conversion with a resolution-independent to_unix_seconds() helper (survey.py, correction_time_series.py).
• Packaging migrated from setup.cfg to pyproject.toml (PEP 621); explicit minimum version requirements added for all dependencies.
• Code quality refactoring: file renames, unused imports/variables removed, bare except clauses narrowed, optional geopandas import centralised, f-string modernisation, context managers for file I/O.
• Added an API reference, changelog and a landing page for documentation build with mkdocs (html). The documentation is accessible via the about menu in the GUI.

License and copyright

Copyright (C) 2021 Andreas Hellerschmied ([e-mail])

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.