Skip to main content

Python package for Earth data models management

Project description

license:

MIT

url:

https://github.com/avalentino/geomodels

Travis-CI status page Latest Version Supported Python versions License

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:

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geomodels-1.0.0b4.tar.gz (2.6 MB view details)

Uploaded Source

Built Distributions

geomodels-1.0.0b4-cp38-cp38-manylinux2010_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64

geomodels-1.0.0b4-cp37-cp37m-manylinux2010_x86_64.whl (3.2 MB view details)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

geomodels-1.0.0b4-cp36-cp36m-manylinux2010_x86_64.whl (3.3 MB view details)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

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

Hashes for geomodels-1.0.0b4.tar.gz
Algorithm Hash digest
SHA256 9f15635b3c58d33584843f004aa48cdd813f8eb25b2f6e69c17b735140fbeb3c
MD5 932bdb6b54684bfe04b10b19aac520c9
BLAKE2b-256 0f26fa60ac5b760af6870f5ac52eebf870420bae50b9f1f5d7a1f560fdd04c0c

See more details on using hashes here.

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

Hashes for geomodels-1.0.0b4-cp38-cp38-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 345812f2c9b3cf071bcf0c2cad578ebe2559707e4ff9473fd3635e20e7ab775d
MD5 2ead806dc031024283db8dca812380d4
BLAKE2b-256 813ec6acd3b3f161b35671892c4a8121096f98cd195c4a872c9c2c530a0ca551

See more details on using hashes here.

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

Hashes for geomodels-1.0.0b4-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 0592066922fa8e81a32a9044e53c0fdb213e6d68df86ef92b0b35bc3f9617348
MD5 3e4b328672d9418d3f056f7d76ed8440
BLAKE2b-256 a8969926d9f783adc22a25ada8b119b4616343f68c38a75049e8b1e368054088

See more details on using hashes here.

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

Hashes for geomodels-1.0.0b4-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 05f449b92a7c333bc9c3a12160cfdb467a214ea197e03406e1ba2cb80327697e
MD5 492bf004b50a103484f2509821f7e37d
BLAKE2b-256 fd67b050a0436d032b70c6dff02b120b07870fb0cdf288872dd087384a7305b0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page