Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
July 19, 2023 07:45
November 24, 2023 14:06
November 30, 2023 20:19
November 28, 2023 20:23
November 9, 2023 16:11
September 26, 2023 15:14
May 18, 2022 10:21
January 22, 2017 18:31
April 24, 2020 20:40
April 24, 2020 20:40
April 25, 2020 02:26
April 25, 2020 02:26

Build Status Anaconda-Server Badge release Github commits (since latest release) Slack

pyGIMLi is an open-source library for modelling and inversion and in geophysics. The object-oriented library provides management for structured and unstructured meshes in 2D and 3D, finite-element and finite-volume solvers, various geophysical forward operators, as well as Gauss-Newton based frameworks for constrained, joint and fully-coupled inversions with flexible regularization.

What is pyGIMLi suited for?

  • analyze, visualize and invert geophysical data in a reproducible manner
  • forward modelling of (geo)physical problems on complex 2D and 3D geometries
  • inversion with flexible controls on a-priori information and regularization
  • combination of different methods in constrained, joint and fully-coupled inversions
  • teaching applied geophysics (e.g. in combination with Jupyter notebooks)

What is pyGIMLi NOT suited for?

  • for people that expect a ready-made GUI for interpreting their data

Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge

On all platforms, we recommend to install pyGIMLi via the conda package manager contained in the Anaconda distribution. For details on how to install Anaconda, we refer to:

To avoid conflicts with other packages, we recommend to install pygimli in a separate environment. Here we call this environment pg, but you can give it any name. Note that this environment has to be created only once.

conda create -n pg -c gimli -c conda-forge pygimli=1.4.5

If you are using Windows or Mac, a new environment named “pg” should be visible in the Anaconda Navigator. If you want to use pygimli from the command line, you have to activate the environment. You can put this line in your ~/.bashrc file so that it is activated automatically if you open a terminal.

conda activate pg

See for more information.

Import convention
import pygimli as pg

Check for additional information, detailed installation instructions and many examples.

Citing pyGIMLi

More information can be found in this paper. If you use pyGIMLi for your work, please cite as:

Rücker, C., Günther, T., Wagner, F.M., 2017. pyGIMLi: An open-source library for modelling and inversion in geophysics, Computers and Geosciences, 109, 106-123, doi: 10.1016/j.cageo.2017.07.011.

BibTeX code:

  title = {{pyGIMLi}: An open-source library for modelling and inversion in geophysics},
  journal = {Computers and Geosciences},
  volume = {109},
  pages = {106--123},
  year = {2017},
  doi = {10.1016/j.cageo.2017.07.011},
  url = {},
  author = {R\"ucker, C. and G\"unther, T. and Wagner, F. M.}

pyGIMLi is distributed under the terms of the Apache 2.0 license. Details on the license agreement can be found here.


We use or link some third-party software (beside the usual tool stack: cmake, gcc, boost, python, numpy, scipy, matplotlib) and are grateful for all the work made by the authors of these awesome open-source tools: