Skip to content
/ geodezyx Public

geodezyx (aka The GeodeZYX Toolbox) aims to provide simple but useful Python functions for Geodesy and Geophysics. ๐Ÿ›ฐ๏ธ ๐ŸŒ ๐Ÿ

License

Notifications You must be signed in to change notification settings

IPGP/geodezyx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

geodezyx (aka The GeodeZYX Toolbox)

Version 4.4.3 / 2024-05-20, README Revision: 2024-05-20

Authors: Pierre Sakic (IPGP, Paris, France) & Gustavo Mansur (GFZ, Potsdam, Germany)

Documentation: https://ipgp.github.io/geodezyx

GitHub repository: https://github.com/IPGP/geodezyx

PyPi project: https://pypi.org/project/geodezyx

Contact e-mail: sakic@ipgp.fr

Citation: Sakic, Pierre; Mansur, Gustavo; Chaiyaporn, Kitpracha; Ballu, Valรฉrie (2019): The geodeZYX toolbox: a versatile Python 3 toolbox for geodetic-oriented purposes. V. 4.0. GFZ Data Services. http://doi.org/10.5880/GFZ.1.1.2019.002

Licence: GNU LGPL v3 (see below)

Contributors:

  • Kitpracha "Na" Chaiyaporn (GFZ, Potsdam, Germany)
  • Valรฉrie Ballu (CNRS/La Rochelle University, France)

Introduction

The purpose of geodezyx (pronounced geode-zeecks), also known as the GeodeZYX toolbox, is to provide all the functions which can be useful for Geodesy and Geophysics.

It includes low-level functions, file management functions, time and space-coordinates conversion functions, data (especially GNSS observations and orbits) retrieve functions, plots and visual selection functions ...

It is designed for Python 3 on a LINUX Ubuntu-like system. Also tested with Anaconda

Documentation

See the following link: https://ipgp.github.io/geodezyx/

Installation

See the following link: https://ipgp.github.io/geodezyx/getting_started.html#installation

Installation (detailed legacy instructions)

with PyPI and pip

We recommend using pip to do a proper installation.
To get the latest working version, you can install directly the GitHub-hosted version (recommended):

pip install git+https://github.com/IPGP/geodezyx

You can also install the version hosted on PyPI (but you will not get the latest changes)

pip install geodezyx

clone and manually install from GitHub

You can manually fork and/or clone the GitHub repository (https://github.com/IPGP/geodezyx/) using your favorite flavor:

  • SSH: git clone git@github.com:IPGP/geodezyx.git
  • https: git clone https://github.com/IPGP/geodezyx.git

and install the Toolbox you downloaded with python setup.py install

Alternatively, you can also add the geodezyx folder in your PYTHONPATH (for experimented users)

Changelog

v4.4.3, 2024-05-20

  • Speed execution optimization for orbit/clock-related functions
  • Misc routine improvements

v4.4.2, 2024-04-17

v4.4.1, 2024-02-08

  • The GitHub repository has now been moved under the IPGP organization.
  • The version numbering goes without a starting zero from now on.
    Initially, this first zero was kept as a "perpetual beta" marker,
    but The GeodeZYX toolbox is a grown-up project now!
  • Bugs corrected for read_rnx2_obs and OrbDF manipulation functions.

v0.4.4.0, 2023-11-24

  • The toolbox turns to the GNU Lesser General Public License version 3
  • Module docstring has been updated
  • Angle conversion functions have been refactored
  • sp3/clk DataFrame column names are renamed to better fit the data content:
    • sat > prn, const > sys, sv > prni, AC > ac

v0.4.3.6, 2023-06-30

  • a routine version update (bug corrections...)
  • colors in the logger
  • NB: v0.4.3.5, v0.4.3.4 & v0.4.3.3 are cancelled releases

v0.4.3.2, 2023-03-08

  • 1000th commit on GitHub ๐Ÿฅณ
  • GitHub repository is renamed for simplification
  • beta for GROOPS automatized run functions
  • Dropbox download function
  • UTM coordinates conversion function (IGN algorithm)
  • implementation of UTM coordinates in the TimeSeries class
  • logger improvement (shorter timestamps & message ranks)

v0.4.3.1, 2022-12-09

  • Routine update: multiple new features/functions and bug corrections

v0.4.3.0, 2022-02-10

  • enhanced logger replaces basic prints.
  • GeodeZYX is now "virtualenv-ready", i.e. stand-alone based on the setup.py required modules.
  • a full version is set, for advanced installation.

Licence

GNU Lesser General Public License, Version 3, 29 June 2007

Copyright ยฉ 2019 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences, Potsdam, Germany (Pierre Sakic, Gustavo Mansur, and Kitpracha "Na" Chaiyaporn, Valรฉrie Ballu)

The geodeZYX toolbox is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The geodeZYX toolbox 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 Lesser General Public License for more details.

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

       _____                _      ________     ____   __  _______          _ _
      / ____|              | |    |___  /\ \   / /\ \ / / |__   __|        | | |
     | |  __  ___  ___   __| | ___   / /  \ \_/ /  \ V /     | | ___   ___ | | |__   _____  __
     | | |_ |/ _ \/ _ \ / _` |/ _ \ / /    \   /    > <      | |/ _ \ / _ \| | '_ \ / _ \ \/ /
     | |__| |  __/ (_) | (_| |  __// /__    | |    / . \     | | (_) | (_) | | |_) | (_) >  <
      \_____|\___|\___/ \__,_|\___/_____|   |_|   /_/ \_\    |_|\___/ \___/|_|_.__/ \___/_/\_\

I'd rather be burned alive than to program in Perl again.
G. Mansur, 28th IUGG General Assembly, Berlin, Germany, 2023

About

geodezyx (aka The GeodeZYX Toolbox) aims to provide simple but useful Python functions for Geodesy and Geophysics. ๐Ÿ›ฐ๏ธ ๐ŸŒ ๐Ÿ

Resources

License

Stars

Watchers

Forks

Packages

No packages published