Invert4geom#

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 either vertical right-rectangular prisms or tesseroids (spherical 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

SPEC 0 โ€” Minimum Supported Dependencies

cover figure

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).

What Invert4Geom is for:#

  • invert gravity data to recover the topography of a density contrast

  • invert gravity data to recover the spatially-variable density of a layer of known geometry

  • use with gridded gravity data

  • discretization using vertical right-rectangular prisms or tesseroids

  • 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

    • while we have a simple density inversion implementation this is just for a simple single-layer model and not a mesh.

  • 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

  • publication-quality visualization -> see PyGMT for plotting tools

How to contribute

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

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.

Note

Many parts of this documentation was adapted from the Fatiando project.

Getting started?

New to Invert4geom? Start here!

Quickstart

Need help?

Start a discussion on GitHub!

Discussions

Reference documentation

A list of modules and functions

API Reference

Using Invert4geom for research?

Citations help support our work

Citing Invert4geom