Skip to main content

Spatial data processing for geomodeling

Project description

Spatial data and information processing for geomodeling and subsurface data

PyPI PyPI Conda GitHub Binder Read the Docs DOI DOI DOI Project Status: Active – The project has reached a stable, usable state and is being actively developed. PyPI - Python Version

Overview

We attempt to simplify the access to open-source spatial data processing for geological modeling and for subsurface data (wells, seismic, etc.) with the development of GemGIS, a Python-based open-source library.

GemGIS wraps and extends the functionality of packages known to the geo-community such as GeoPandas, rasterio, OWSLib, Shapely, PyVista, Pandas, NumPy and the geomodeling package GemPy.

The aim of GemGIS, as indicated by the name, is to become a bridge between conventional geoinformation systems (GIS) such as ArcGIS and QGIS, and geomodeling tools such as GemPy, allowing simpler and more automated workflows from one environment to the other. This also includes making it simpler to visualize the results obtained from GemGIS and GemPy with PyVista or Blender. Further, subsurface data processing workflows are implemented for integrated data analyses.

Resources

Find the documentation of GemGIS here. It includes introductions to the main libraries used and to introductory topics like "What is vector data?" or "What is raster data?".

In addition, tutorial notebooks provide an overview of the different features of GemGIS. The notebooks can also be downloaded directly from here. Furthermore, many example models showcase a variety of geological structures that can be modeled with GemGIS and GemPy. The API Reference provides an overview of the implemented functions in GemGIS and how to use them.

Installation

It is recommended to use GemGIS with python">=3.10" in a separated environment. The main packages and its dependencies can be installed via the conda-forge channel. GemGIS is then available through PyPi or Conda.

  1. conda install -c conda-forge geopandas">=0.13.2" rasterio">=1.3.8"
  2. conda install -c conda-forge pyvista">=0.42.1"
  3. pip install gemgis / conda install -c conda-forge gemgis

Check out the Installation Page for more detailed instructions.

If you are an open-source software developer, please install GemGIS and its dependencies, also for building the documentation, using the development YML file.

Contribution Guidelines

The Contribution Guidelines for GemGIS can be found here: Contribution Guidelines

We welcome issue reports, questions, ideas for new features and pull-requests to fix issues or even add new features to the software. Once a pull-request is opened, we will guide through the review process.

References

  • Jüstel et al., (2023). From Maps to Models - Tutorials for structural geological modeling using GemPy and GemGIS. Journal of Open Source Education, 6(66), 185, https://doi.org/10.21105/jose.00185
  • Jüstel et al., (2022). GemGIS - Spatial Data Processing for Geomodeling. Journal of Open Source Software, 7(73), 3709, https://doi.org/10.21105/joss.03709
  • Jüstel, A., Endlein Correira, A., Wellmann, F. and Pischke, M.: GemGIS – GemPy Geographic: Open-Source Spatial Data Processing for Geological Modeling. EGU General Assembly 2021, https://doi.org/10.5194/egusphere-egu21-4613, 2021
  • Jüstel, A.: 3D Probabilistic Modeling and Data Analysis of the Aachen-Weisweiler Area: Implications for Deep Geothermal Energy Exploration, unpublished Master Thesis at RWTH Aachen University, 2020
  • de la Varga, M., Schaaf, A., and Wellmann, F.: GemPy 1.0: open-source stochastic geological modeling and inversion, Geosci. Model Dev., 12, 1-32, https://doi.org/10.5194/gmd-12-1-2019, 2019
  • Powell, D.: Interpretation of Geological Structures Through Maps: An Introductory Practical Manual, Longman, pp. 192, 1992
  • Bennison, G.M.: An Introduction to Geological Structures and Maps, Hodder Education Publication, pp. 78, 1990

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

GemGIS-1.1.8.tar.gz (159.3 kB view details)

Uploaded Source

Built Distribution

GemGIS-1.1.8-py3-none-any.whl (152.9 kB view details)

Uploaded Python 3

File details

Details for the file GemGIS-1.1.8.tar.gz.

File metadata

  • Download URL: GemGIS-1.1.8.tar.gz
  • Upload date:
  • Size: 159.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.1

File hashes

Hashes for GemGIS-1.1.8.tar.gz
Algorithm Hash digest
SHA256 4b993443655fe2c676239f002ff1cbc19b47e0c0d3a241adcfe08c965c876c7d
MD5 ccadfb3b368c328489ad90b1ad7e3a00
BLAKE2b-256 46970a8383fb548c06637491584203fc46fddbd87032d0b2e83cbacfc4f01c01

See more details on using hashes here.

File details

Details for the file GemGIS-1.1.8-py3-none-any.whl.

File metadata

  • Download URL: GemGIS-1.1.8-py3-none-any.whl
  • Upload date:
  • Size: 152.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.1

File hashes

Hashes for GemGIS-1.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 426ab49fcb1b52c6c1c8244e44d835b4e4be5e99ec9c3a5deb7a77846fe56185
MD5 29047ba5bedbb68ec7fa94bccfc9a26f
BLAKE2b-256 98fad85d6a85304fab73e3867d47d09cd76e91f88d465083d036e7b75b30fb6c

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