The pyGIMLi tutorial at Transform 21

Instructors: Florian Wagner ¹, Carsten Rücker ², Thomas Günther³, Andrea Balza¹

¹ RWTH Aachen University, Applied Geophysics and Geothermal Energy, Aachen, Germany ² Berlin University of Technology, Department of Applied Geophysics, Berlin, Germany ³ Leibniz Institute for Applied Geophysics, Hannover, Germany

pyGIMLi is an open-source library for modeling and inversion in geophysics. This tutorial is particularly suited for new users. We will start from scratch and:

• Create a subsurface geometry and explore the pyGIMLi meshtools
• Simulate the stationary 2D heat equation
• Simulate synthetic crosshole traveltime measurements
• Invert seismic traveltime and field ERT data
• Show how to build inversions with own forward operators (e.g., from other packages)

• Tutorial on geophysical modeling & inversion with pyGIMLi
  • About
  • Table of contents
  • BEFORE THE TUTORIAL
  • Setup instructions
    • Step 1: Prerequisites
    • Step 2: Download material for the tutorial
    • Step 3: Install the tutorial environment
    • Step 4: Start JupyterLab
  • Schedule

This tutorial was presented on April 19, 2021 at Transform, but you can still follow it on YouTube and ask questions. To do so please:

1. Sign up for the Software Underground Slack
2. Join the channel #pygimli channel to interact with other users and developers and ask questions with regard to the tutorial/software.
3. Install the pyGIMLi conda environment as described below.

Quick setup for experienced users

If you are working on Mac or Linux and have worked with conda and have git installed, you can copy & paste these lines separately. For all others, we recommend to carefully read the descriptions of individual steps below.

git clone https://github.com/gimli-org/transform2021
cd transform2021
conda env create
conda activate pg-transform
python -c "import pygimli; pygimli.test(show=False, onlydoctests=True)"
jupyter lab

To start the tutorial setup, please follow the next steps:

There are a few things you'll need to follow the tutorial:

1. A working Python installation (Anaconda or Miniconda). For details on how to install Anaconda, we refer to: https://docs.anaconda.com/anaconda/install/
2. A modern web browser that works with JupyterLab or Jupyter Notebook (Internet explorer will not work)
3. Intermediate experience in Python programming (Python, numpy, matplotlib, jupyter)
4. Background on geophysical modeling and inversion

• Windows: Download the course material and unzip it a folder of your choice.
• Mac/Linux: You can do the same as above, or alternatively open a terminal, navigate to a folder of your choice, and execute git clone https://github.com/gimli-org/transform2021.

1. Open a terminal (Linux & Mac) or the Anaconda Powershell Prompt (Windows). Navigate to the folder from step 2 (using the cd command) and type:

conda env create

2. Activate the environment in the terminal by typing:

conda activate pg-transform

3. To test if everything works correctly you can do the following:

python -c "import pygimli; pygimli.test(show=False, onlydoctests=True)"

If none of these commands gives an error, then your installation is working fine. If you get any errors, please let us know on Slack at #t21-mon-pygimli.

1. Windows users: Make sure you set a default browser that is not Internet Explorer.
2. Activate the conda environment: conda activate pg-transform
3. Start JupyterLab: jupyter lab
4. Jupyter should open in your default web browser. We'll start from here in the tutorial and create a new notebook together.

Note: Click on the notebook number to get to the respective notebook and the minutes to get to the respective position in the tutorial video.