Python package for Earth data models management
Project description
- Copyright:
- 2019-2020 Antonio Valentino
- license:
MIT
- url:
About
GeoModels provides tools for the management of Earth models like geoids, gravity models, and magnetic field models.
It also provides some utility function to download and install support data to that are necessary for Earth models computation.
It is basically a Cython wrapper for part of the the GeographicLib C++ library.
Installation
The GeoModels requires Python >= 3.6. To use GeoModels depends on the following Python packages:
tqdm (optional)
argcomplete (optional)
The required Python packages are automatically installed installed by Pip and setuptools:
$ python3 -m pip install geomodels
Please refer to the Pip user manual for details about installation options and to the installation section in the documentation for details about installation form sources.
Model data installation
GeoModels uses external data to perform geoid, gravity and magnetic field computations.
If required data are not already available on the system than they can be downloaded and installed using the command line interface provided by the GeoModels package:
$ python -m geomodels install-data [-d DATADIR] recommended
The above command installs the recommended subset of data (about 20MB) into the specified DATAROOT`folder. If `DATAROOT is not explicitly specified using the -d (or –datadir) option then the default system path is used (e.g. /usr/local/share/GeographicLib).
In any case it is necessary to have write permission on the DATADIR folder, so to install into the default system path it will be probably necessary to use sudo or some equivalent method.
If data are not installed into the default system folder than it is necessary to set the GEOGRAPHICLIB_DATA environment variable to the data installation path to allow GeographicLib to find data. E.g., on systems using bash one can use the following command:
export GEOGRAPHICLIB_DATA=/path/to/data
Testing
Once the GeoModels package and necessary data have been installed, it is possible to run the test suite to be sure that all works correctly. The recommended way to test GeoModels with using PyTest:
$ env GEOGRAPHICLIB_DATA=/path/to/data \ python3 -m pytest --pyargs geomodels
Usage example
>>> from geomodels import GeoidModel >>> geoid = GeoidModel() >>> geoid.description() 'WGS84 EGM96, 5-minute grid' >>> geoid(lat=40.667, lon=16.6) # -> geoid height 45.914894760480024
License
GeoModels is released under the terms of the MIT/X11 License (see LICENSE file).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file geomodels-1.0.0b4.tar.gz
.
File metadata
- Download URL: geomodels-1.0.0b4.tar.gz
- Upload date:
- Size: 2.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.7.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9f15635b3c58d33584843f004aa48cdd813f8eb25b2f6e69c17b735140fbeb3c |
|
MD5 | 932bdb6b54684bfe04b10b19aac520c9 |
|
BLAKE2b-256 | 0f26fa60ac5b760af6870f5ac52eebf870420bae50b9f1f5d7a1f560fdd04c0c |
File details
Details for the file geomodels-1.0.0b4-cp38-cp38-manylinux2010_x86_64.whl
.
File metadata
- Download URL: geomodels-1.0.0b4-cp38-cp38-manylinux2010_x86_64.whl
- Upload date:
- Size: 3.4 MB
- Tags: CPython 3.8, manylinux: glibc 2.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.7.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 345812f2c9b3cf071bcf0c2cad578ebe2559707e4ff9473fd3635e20e7ab775d |
|
MD5 | 2ead806dc031024283db8dca812380d4 |
|
BLAKE2b-256 | 813ec6acd3b3f161b35671892c4a8121096f98cd195c4a872c9c2c530a0ca551 |
File details
Details for the file geomodels-1.0.0b4-cp37-cp37m-manylinux2010_x86_64.whl
.
File metadata
- Download URL: geomodels-1.0.0b4-cp37-cp37m-manylinux2010_x86_64.whl
- Upload date:
- Size: 3.2 MB
- Tags: CPython 3.7m, manylinux: glibc 2.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.7.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0592066922fa8e81a32a9044e53c0fdb213e6d68df86ef92b0b35bc3f9617348 |
|
MD5 | 3e4b328672d9418d3f056f7d76ed8440 |
|
BLAKE2b-256 | a8969926d9f783adc22a25ada8b119b4616343f68c38a75049e8b1e368054088 |
File details
Details for the file geomodels-1.0.0b4-cp36-cp36m-manylinux2010_x86_64.whl
.
File metadata
- Download URL: geomodels-1.0.0b4-cp36-cp36m-manylinux2010_x86_64.whl
- Upload date:
- Size: 3.3 MB
- Tags: CPython 3.6m, manylinux: glibc 2.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.7.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 05f449b92a7c333bc9c3a12160cfdb467a214ea197e03406e1ba2cb80327697e |
|
MD5 | 492bf004b50a103484f2509821f7e37d |
|
BLAKE2b-256 | fd67b050a0436d032b70c6dff02b120b07870fb0cdf288872dd087384a7305b0 |