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)
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 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)
- 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
- It must be transparent for your clones but updating them is recommended
- 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
- It must be transparent for your clones but updating them is recommended
- 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
andOrbDF
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
becomesgeodezyx-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