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: [email protected]

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)

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

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

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

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

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

• SSH: git clone [email protected]: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)

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

• The GitHub repository, and the project in general, has been renamed as geodezyx (in lower case) to uniformize its multiple spellings and then avoid confusion.
  • It must be transparent for your clones but updating them is recommended
    https://docs.github.com/en/repositories/creating-and-managing-repositories/renaming-a-repository
• misc routine improvements
• Refactoring of the GNSS data/products dowmload functions

• The GitHub repository has now been moved under the IPGP organization.
  • It must be transparent for your clones but updating them is recommended
    https://docs.github.com/en/repositories/creating-and-managing-repositories/renaming-a-repository
• 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.

• 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

• 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

• 1000th commit on GitHub 🥳
• GitHub repository is renamed for simplification
  • GeodeZYX-Toolbox_v4 becomes geodezyx-toolbox (lowercase and without version)
  • It must be transparent for your clones but updating them is recommended
    https://docs.github.com/en/repositories/creating-and-managing-repositories/renaming-a-repository
• 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)

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

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

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