Skip to main content

Constrained gravity inversion to recover the geometry of a density contrast.

Project description

Invert4geom

3D geometric gravity inversions

Documentation Link

Invert4geom is a Python library for performing 3D geometric gravity inversions, where the aim is to recover the geometry of a density contrast.

Typical use cases include modeling the topography of the Moho, the sediment-basement contact, or bathymetry. These density contrasts are represented by a layer of vertical right-rectangular prisms. Since we use vertical prisms, they don't take the curvature of the Earth into account. For large-scale applications, such as continental studies, it would be better to use tesseroids instead of prisms.

See the overview for further description of this package and what it can be used for.

Binder link

Latest version on PyPI Latest version on conda-forge Test coverage status

Compatible Python versions. Zenodo DOI Documentation Status

Disclaimer

🚨 **Ready for daily use but still changing.** 🚨

This means that we are still adding a lot of new features and sometimes we make changes to the ones we already have while we try to improve the software based on users' experience, test new ideas, make better design decisions, etc. Some of these changes could be backwards incompatible. Keep that in mind before you update Invert4Geom to a new major version (i.e. from v1.0.0 to v2.0.0) and always check the Changelog for BREAKING CHANGES and how to update your code appropriately.

I welcome any feedback, ideas, or contributions! Please contact us on the GitHub discussions page or submit an issue on GitHub for problems or feature ideas.

What Invert4Geom is for:

  • invert gravity data to recover the topography of a density contrast
  • use with gridded gravity data
  • discretization using vertical right-rectangular prisms
  • performing regional-residual separation
  • stochastic uncertainty analysis of inversion results
  • basic visualization tools

What Invert4Geom is NOT for:

  • performing parameter-estimation inversions (i.e. recovering density values) -> see SimPEG or pyGIMLi
  • a point-and-click GUI -> see Geosoft/Seequent Oasis Montaj or MiraGeoscience VPmg
  • a ready-to-use inversion with minimal user input
  • use with discrete (un-gridded) gravity data -> see Harmonica for gridding your data
  • for processing gravity data -> see Harmonica for gravity processing tools
  • for use with tesseroids, or non-regular grids (raise an issue request if you want this implemented!)
  • publication-quality visualization -> see PyGMT for plotting tools

How to contribute

I welcome all forms of contribution! If you have any questions, comments or suggestions, please open a discussion or issue (feature request)!

Also, please feel free to share how you're using Invert4Geom, I'd love to know.

Please, read our Contributor Guide to learn how you can contribute to the project.

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

invert4geom-0.11.1.tar.gz (102.5 kB view details)

Uploaded Source

Built Distribution

invert4geom-0.11.1-py3-none-any.whl (91.8 kB view details)

Uploaded Python 3

File details

Details for the file invert4geom-0.11.1.tar.gz.

File metadata

  • Download URL: invert4geom-0.11.1.tar.gz
  • Upload date:
  • Size: 102.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for invert4geom-0.11.1.tar.gz
Algorithm Hash digest
SHA256 c41f8c1ac2a03ba406941d80551926443b76dc3d59f8d4eca02256ca1a28ef3c
MD5 7b0767215a1500399a2c7d428bf705bd
BLAKE2b-256 bf16ce43f68d3d5a34c44441bb715c621b3daadcb7e8549bf75de6c298416f01

See more details on using hashes here.

Provenance

The following attestation bundles were made for invert4geom-0.11.1.tar.gz:

Publisher: pypi_release.yml on mdtanker/invert4geom

Attestations:

File details

Details for the file invert4geom-0.11.1-py3-none-any.whl.

File metadata

  • Download URL: invert4geom-0.11.1-py3-none-any.whl
  • Upload date:
  • Size: 91.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for invert4geom-0.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ce51c5a83d2a8f11e5704bbf578ae4014ccf431d1a02710e8bdf9a2d0fed936a
MD5 b1dda9d55ef38a4cd127971e23e23e6d
BLAKE2b-256 5c65ac23258aaa8b0691c6a45897fe9ef73d29ca1e73fdebea6db6217fb17613

See more details on using hashes here.

Provenance

The following attestation bundles were made for invert4geom-0.11.1-py3-none-any.whl:

Publisher: pypi_release.yml on mdtanker/invert4geom

Attestations:

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