Metadata-Version: 2.4
Name: grav-toolbox
Version: 0.3.7
Summary: Gravity survey utility tools
Home-page: https://github.com/ahellers/GravTools
Author: Andreas Hellerschmied
Author-email: andreas.hellerschmied@bev.gv.at
License: GNU GPLv3
Keywords: gravity,gravimeter,least squares adjustment,geodesy,geophysics
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt5
Requires-Dist: pandas
Requires-Dist: pyqtgraph
Requires-Dist: scipy
Requires-Dist: scikit-learn
Provides-Extra: gis
Requires-Dist: geopandas; extra == "gis"
Dynamic: license-file

# 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.

# License and copyright

Copyright (C) 2021  Andreas Hellerschmied (<andreas.hellerschmied@bev.gv.at>)

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/>.


