gempy

GemPy is an open-source, Python-based 3-D structural geological modeling software, which allows the implicit (i.e. automatic) creation of complex geological models from interface and orientation data. It also offers support for stochastic modeling to address parameter and model uncertainties.

https://github.com/gempy-project/gempy

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 9 DOI reference(s) in README
✓
Academic publication links
Links to: sciencedirect.com, springer.com, frontiersin.org, mdpi.com, zenodo.org
○
Academic email domains
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (16.5%) to scientific vocabulary

Keywords

bayesian complex-geological-models geological geology geoscience implicit interpolation modeling monte-carlo-simulation python torch uncertainties uncertainty-analysis uq

Last synced: 6 months ago · JSON representation ·

Repository

Basic Info

Host: GitHub
Owner: gempy-project
License: eupl-1.2
Language: Python
Default Branch: main
Homepage: https://gempy.org
Size: 453 MB

Statistics

Stars: 1,154
Watchers: 53
Forks: 257
Open Issues: 16
Releases: 28

Topics

bayesian complex-geological-models geological geology geoscience implicit interpolation modeling monte-carlo-simulation python torch uncertainties uncertainty-analysis uq

Created over 8 years ago · Last pushed 6 months ago

Metadata Files

Readme Contributing Funding License Code of conduct Citation Authors

README.md

What's New: GemPy 2024.1 (a.k.a GemPy v3) Release!

Welcome to the era of GemPy v3! We are thrilled to announce the release of the latest version, a product of meticulous planning, redesign, and rigorous testing. While the core essence remains intact, v3 brings significant enhancements and novelties that promise to revolutionize your geomodeling experience.

Delve into the exciting new features in the What's New in GemPy v3.

The journey from GemPy v2 to v3 has been transformative. To ensure that our users don't lose out on any previous functionalities, we've shifted v2 to a package named gempy_legacy. While the core team will not develop any new features for this version, we'll continue maintaining it based on community requests.

Overview

GemPy is a Python-based, open-source geomodeling library. It is capable of constructing complex 3D geological models of folded structures, fault networks and unconformities, based on the underlying powerful implicit representation approach.

Installation

We provide the latest release version of GemPy via PyPi package services. We highly recommend using PyPi,

$ pip install gempy[base]

Resources

After installation, you can either check the notebook tutorials or the video introduction to get started.

Go to the documentation site for further information and enjoy the tutorials and examples.

For questions and support, please use discussions.

If you find a bug or have a feature request, create an issue.

Follow these guidelines to contribute to GemPy.

Gallery

Geometries

Features

Case studies

Publications using GemPy

Marquetto, L., Jüstel, A., Troian, G.C., Reginato, P.A.R & Simões, J.C. (2024). Developing a 3D hydrostratigraphical model of the emerged part of the Pelotas Basin along the northern coast of Rio Grande do Sul state, Brazil. Environmental Earth Sciences, 83, 329.
Brisson, S., Wellmann, F., Chudalla, N., von Harten, J., & von Hagke, C. (2023). Estimating uncertainties in 3-D models of complex fold-and-thrust belts: A case study of the Eastern Alps triangle zone. Applied Computing and Geosciences, 18, 100115.
Liang, Z., de la Varga, M., & Wellmann, F. (2023). Kernel method for gravity forward simulation in implicit probabilistic geologic modeling. Geophysics, 88(3), G43-G55.
Kong, S., Oh, J., Yoon, D., Ryu, D. W., & Kwon, H. S. (2023). Integrating Deep Learning and Deterministic Inversion for Enhancing Fault Detection in Electrical Resistivity Surveys. Applied Sciences, 13(10), 6250.
Thomas, A. T., Micallef, A., Duan, S., & Zou, Z. (2023). Characteristics and controls of an offshore freshened groundwater system in the Shengsi region, East China Sea. Frontiers in Earth Science, 11, 1198215.
Haehnel, P., Freund, H., Greskowiak, J. & Massmann, G. (2023) Development of a three-dimensional hydrogeological model for the island of Norderney (Germany) using GemPy. Geoscience Data Journal, 00, 1–17.
Jüstel, A., de la Varga, M., Chudalla, N., Wagner, J. D., Back, S., & Wellmann, F. (2023). From Maps to Models-Tutorials for structural geological modeling using GemPy and GemGIS. Journal of Open Source Education, 6(66), 185.
Thomas, A. T., von Harten, J., Jusri, T., Reiche, S., Wellmann, F. (2022). An integrated modeling scheme for characterizing 3D hydrogeological heterogeneity of the New Jersey shelf. Marine Geophysical Research, 43, 11.
Sehsah, H., Eldosouky, A. M., & Pham, L. T. (2022). Incremental Emplacement of the Sierra Nevada Batholith Constrained by U-Pb Ages and Potential Field Data. The Journal of Geology, 130(5), 381-391.
von Harten, J., de la Varga, M., Hillier, M., Wellmann, F. (2021). Informed Local Smoothing in 3D Implicit Geological Modeling. Minerals 2021, 11, 1281.
Schaaf, A., de la Varga, M., Wellmann, F., & Bond, C. E. (2021). Constraining stochastic 3-D structural geological models with topology information using approximate Bayesian computation in GemPy 2.1. Geosci. Model Dev., 14(6), 3899-3913. doi:10.5194/gmd-14-3899-2021
Güdük, N., de la Varga, M. Kaukolinna, J. and Wellmann, F. (2021). Model-Based Probabilistic Inversion Using Magnetic Data: A Case Study on the Kevitsa Deposit, Geosciences, 11(4):150.
Wu, J., & Sun, B. (2021). Discontinuous mechanical analysis of manifold element strain of rock slope based on open source Gempy. In E3S Web of Conferences (Vol. 248, p. 03084). EDP Sciences.
Stamm, F. A., de la Varga, M., and Wellmann, F. (2019). Actors, actions, and uncertainties: optimizing decision-making based on 3-D structural geological models, Solid Earth, 10, 2015–2043.
Wellmann, F., Schaaf, A., de la Varga, M., & von Hagke, C. (2019). From Google Earth to 3D Geology Problem 2: Seeing Below the Surface of the Digital Earth. In Developments in Structural Geology and Tectonics (Vol. 5, pp. 189-204). Elsevier.

Please let us know if your publication is missing!

A continuously growing list of gempy-applications (e.g. listing real-world models) can be found here.

References

de la Varga, M., Schaaf, A., and Wellmann, F. (2019). GemPy 1.0: open-source stochastic geological modeling and inversion, Geosci. Model Dev., 12, 1-32.
Wellmann, F., & Caumon, G. (2018). 3-D Structural geological models: Concepts, methods, and uncertainties. In Advances in Geophysics (Vol. 59, pp. 1-121). Elsevier.
Calcagno, P., Chilès, J. P., Courrioux, G., & Guillen, A. (2008). Geological modelling from field data and geological knowledge: Part I. Modelling method coupling 3D potential-field interpolation and geological rules. Physics of the Earth and Planetary Interiors, 171(1-4), 147-157.
Lajaunie, C., Courrioux, G., & Manuel, L. (1997). Foliation fields and 3D cartography in geology: principles of a method based on potential interpolation. Mathematical Geology, 29(4), 571-584.

Owner

Name: GemPy
Login: gempy-project
Kind: organization
Email: info@terranigma-solutions.com
Location: Germany

Website: gempy.org
Repositories: 14
Profile: https://github.com/gempy-project

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use GemPy, please cite it as below."
authors:
  - family-names: "de la Varga"
    given-names: "Miguel"
    orcid: https://orcid.org/0000-0001-6941-2685
  - family-names: "Schaaf"
    given-names: "Alexander"
  - family-names: "Wellmann"
    given-names: "Florian"
    orcid: https://orcid.org/0000-0003-2552-1876
title: "GemPy 1.0: open-source stochastic geological modeling and inversion"
version: 1.0
doi: https://doi.org/10.5194/gmd-12-1-2019
date-released: 2019-01-02
url: "https://github.com/cgre-aachen/gempy"

GitHub Events

Total

Create event: 36
Release event: 2
Issues event: 53
Watch event: 170
Delete event: 11
Member event: 2
Issue comment event: 272
Push event: 154
Pull request review comment event: 1
Pull request review event: 8
Pull request event: 71
Fork event: 23

Last Year

Create event: 36
Release event: 2
Issues event: 53
Watch event: 170
Delete event: 11
Member event: 2
Issue comment event: 272
Push event: 154
Pull request review comment event: 1
Pull request review event: 8
Pull request event: 71
Fork event: 23

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 197
Total pull requests: 137
Average time to close issues: almost 2 years
Average time to close pull requests: 2 months
Total issue authors: 80
Total pull request authors: 19
Average comments per issue: 2.38
Average comments per pull request: 1.72
Merged pull requests: 101
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 39
Pull requests: 85
Average time to close issues: 30 days
Average time to close pull requests: 7 days
Issue authors: 29
Pull request authors: 3
Average comments per issue: 1.62
Average comments per pull request: 2.09
Merged pull requests: 68
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

Leguark (47)
AlexanderJuestel (12)
alex-schaaf (11)
flohorovicic (5)
domist07 (5)
Varun019140 (4)
cfandel (4)
agzimmerman (4)
gasiva (4)
xiaohua00921 (4)
Sebadita (4)
TobiasGlaubach (3)
AndrewAnnex (3)
javoha (3)
KodalAnwesha (3)

Pull Request Authors

Leguark (59)
flohorovicic (23)
javoha (16)
fastamo (12)
alex-schaaf (5)
funveen (3)
youtlh (2)
AlexanderJuestel (2)
artygo8 (2)
AndrewAnnex (2)
yangjiandendi (2)
elimh (2)
florian-wagner (1)
GeorgeLiang3 (1)
cfandel (1)

Top Labels

Issue Labels

enhancement (41) new features (13) visualization (12) documentation (10) bug (9) help wanted (8) easy (8) user experience (7) question (7) Epic (7) master thesis (6) faults (5) gempy 3 (4) gravity (3) meshing (3) optimization (3) topology (2) gempy engine (2) model computation (1) assert (1) inference (1) gempy lite (1) dependency (1) bug? (1)

Pull Request Labels

gempy 3 (41) enhancement (4) model computation (4) Blocked (3) visualization (1) anisotropic range (1) gempy engine (1)

Packages

Total packages: 1
Total downloads: unknown

Total dependent packages: 0
Total dependent repositories: 1
Total versions: 11

conda-forge.org: gempy

Homepage: https://github.com/gempy-project/gempy
License: EUPL-1.2
Latest release: 2.2.12
published over 3 years ago

Versions: 11
Dependent Packages: 0
Dependent Repositories: 1

Rankings

Forks count: 12.3%

Stargazers count: 14.8%

Dependent repos count: 24.1%

Average: 25.7%

Dependent packages count: 51.5%

Last synced: 6 months ago

Dependencies

dev-requirements.txt pypi

emg3d ==0.11.0 development
ipywidgets * development
pooch * development
requests * development
sphinx ==3.5.4 development
sphinx_gallery * development
welly * development

.github/workflows/pytest.yml actions

actions/checkout v2 composite
styfle/cancel-workflow-action 3d86a7cc43670094ac248017207be0295edbc31d composite

optional-requirements.txt pypi

arviz ==0.10.0
mplstereonet *
pymc3 ==3.8
pyqrcode *
pyvistaqt *
qgrid ==1.3.0
sklearn *
subsurface *
welly *

setup.py pypi

Theano >=1.0.4
iPython *
matplotlib *
networkx *
numpy ==1.21.6
pandas ==1.3.4
pyqt5 *
pytest *
pyvista >=0.25
pyvistaqt *
scikit-image >=0.17
scikit-learn *
seaborn >=0.9
xarray ==2022.3.0

docs_requirements.txt pypi

shpinx-gallery *
sphinx *

requirements.txt pypi

gempy_engine *