geoid-toolkit

Python tools for obtaining and working with static gravity field coefficients and calculating geoid heights

• GFZ International Centre for Global Earth Models (ICGEM)

About

Version:
Citation:
Tests:
License:

For more information: see the documentation at geoid-toolkit.readthedocs.io

Installation

From PyPI:

python3 -m pip install geoid-toolkit

To include all optional dependencies:

python3 -m pip install geoid-toolkit[all]

Using conda or mamba from conda-forge:

conda install -c conda-forge geoid-toolkit

mamba install -c conda-forge geoid-toolkit

Development version from GitHub:

python3 -m pip install git+https://github.com/polargeodesy/geoid-toolkit.git

Running with Pixi

Alternatively, you can use Pixi for a streamlined workspace environment:

1. Install Pixi following the installation instructions
2. Clone the project repository:

git clone https://github.com/polargeodesy/geoid-toolkit.git

3. Move into the geoid-toolkit directory

cd geoid-toolkit

4. Install dependencies and start JupyterLab:

pixi run start

This will automatically create the environment, install all dependencies, and launch JupyterLab in the notebooks directory.

Resources

• NASA GRACE mission site
• NASA GRACE-FO mission site
• JPL GRACE Tellus site
• JPL GRACE-FO site
• UTCSR GRACE site
• GRACE at the NASA Physical Oceanography Distributed Active Archive Center (PO.DAAC)
• GRACE at the GFZ Information System and Data Center

Dependencies

• lxml: processing XML and HTML in Python
• numpy: Scientific Computing Tools For Python
• platformdirs: Python module for determining platform-specific directories
• python-dateutil: powerful extensions to datetime

Download

The program homepage is:
https://github.com/polargeodesy/geoid-toolkit

A zip archive of the latest version is available directly at:
https://github.com/polargeodesy/geoid-toolkit/archive/main.zip

Disclaimer

This package includes software developed at the University of California at Irvine (UCI), the NASA Jet Propulsion Laboratory (JPL), NASA Goddard Space Flight Center (GSFC) and the University of Washington Applied Physics Laboratory (UW-APL). This program is not sponsored or maintained by the Universities Space Research Association (USRA), the Center for Space Research at the University of Texas (UTCSR), the Jet Propulsion Laboratory (JPL), the German Research Centre for Geosciences (GeoForschungsZentrum, GFZ) or NASA. The software is provided here for your convenience but with no guarantees whatsoever.

Contributing

This project contains work and contributions from the scientific community. If you would like to contribute to the project, please have a look at the contribution guidelines, open issues and discussions board.

References

Drewes, Kuglitsch, Adám and Rózsa "The Geodesist's Handbook 2016", Journal of Geodesy, 90, 907-1205 (2016). doi: 10.1007/s00190-016-0948-z

Hofmann-Wellenhof and Moritz, "Physical Geodesy" (2005). doi: 10.1007/978-3-211-33545-1

Holmes and Featherstone, "A Unified Approach to the Clenshaw Summation and the Recursive Computation of Very High Degree and Order Normalised Associated Legendre Functions", Journal of Geodesy (2002). doi: 10.1007/s00190-002-0216-2

Ince, Barthelmes, Reißland, Elger, Förste, Flechtner, and Schuh, "ICGEM -- 15 years of successful collection and distribution of global gravitational models, associated services, and future plans" Earth System Science Data, 11, 647--674 (2019). doi: 10.5194/essd-11-647-2019

Jekeli, "Alternative Methods to Smooth the Earth's Gravity Field", (1981).

Moazezi and Zomorrodian, "GGMCalc a software for calculation of the geoid undulation and the height anomaly using the iteration method, and classical gravity anomaly", Earth Science Informatics (2012). doi: 10.1007/s12145-012-0102-2

Tscherning and Poder, "Some Geodetic Applications of Clenshaw Summation", Bollettino di Geodesia e Scienze, (1982).

Wahr, Molenaar and Frank, "Time variability of the Earth's gravity field: Hydrological and oceanic effects and their possible detection using GRACE", Journal of Geophysical Research: Solid Earth, 103(B12), 30205-30229, (1998). doi: 10.1029/98JB02844

License

The content of this project is licensed under the Creative Commons Attribution 4.0 Attribution license and the source code is licensed under the MIT license.