GIMLi BasicsΒΆ

This is the first tutorial where we demonstrate the general use of GIMLi in Python, i.e., pyGIMLi.

The modelling as well as the inversion part of GIMLi often requires a spatial discretization for the domain of interest, the so called GIMLI::Mesh. This tutorial shows some basic aspects of handling a mesh.

First, the library needs to be imported. To avoid name clashes with other libraries we suggest to import pygimli and alias it to the simple abbreviation pg: CR

import pygimli as pg

Every part of the c++ namespace GIMLI is bound to python and can be used with the leading pg.

For instance get the current version for GIMLi with:




This yields:

Now we know the name space GIMLI and can create a first mesh. A mesh is represented by a collection of nodes, cells and boundaries, i.e., geometrical entities.


A regularly spaced mesh consisting of rectangles or hexahedrons is usually called grid. However, a grid is just a special variant of a mesh so GIMLi treat it the same. The only difference is how they are created.

GIMLi provides a collection of tools for mesh import, export and generation. A simple grid generation is built-in but we also provide wrappers for unstructured mesh generations, e.g., Triangle, Tetgen and Gmsh. To create a 2d grid you need to give two arrays/lists for the sampling points in x and y direction, respectively, or just numbers.

grid = pg.createGrid(x=[-1.0, 0.0, 1.0, 4.0], y=(-1.0, 0.0, 1.0, 4.0))

The returned object grid is an instance of GIMLI::Mesh and provides various methods for modification and io-operations. General informations can be simply printed.



Mesh: Nodes: 16 Cells: 9 Boundaries: 24


Or you can access them manually:

print('Mesh: Nodes:', grid.nodeCount(),
      'Cells:', grid.cellCount(),
      'Boundaries:', grid.boundaryCount())


Mesh: Nodes: 16 Cells: 9 Boundaries: 24

You can iterate through all cells of the general type GIMLI::Cell that also provides a lot of methods:

for cell in grid.cells():
    print("Cell-Nr:",, 'Type:', type(cell),
          'Nodes per Cell', cell.nodeCount())


Cell-Nr: 0 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 1 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 2 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 3 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 4 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 5 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 6 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 7 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4
Cell-Nr: 8 Type: <class 'pygimli.core._pygimli_.Quadrangle'> Nodes per Cell 4

To find the grid generation input arrays x and y, you can use the build-in GIMLI::Vector (pre-defined with value type double as pg.RVector), standard python lists or numpy arrays, which are widely compatible with GIMLi vectors.

import numpy as np

grid = pg.createGrid(x=np.linspace(-1.0, 1.0, 10),
                     y=1.0 - np.logspace(np.log10(1.0), np.log10(2.0), 10))

We can find that this new grid contains




rectangles of type GIMLI::Quadrangle being derived from the base type GIMLI::Cell,




edges of type GIMLI::Edge, which are boundaries of the general type GIMLI::Boundary.

The mesh can be saved and loaded in our binary mesh format .bms. Or exported into .vtk format for 2D or 3D visualization using Paraview.

However, we recommend visualizing 2-dimensional content using python scripts that provides better exports to graphics files (e.g., png, pdf, svg). In pygimli we provide some basic post-processing routines using the matplotlib visualization framework. The main visualization call is which is sufficient for the most meshs, fields, models and streamline views.

For more control you can also use the appropriate draw methods pygimli.mplviewer.drawMesh.


Total running time of the script: ( 0 minutes 0.579 seconds)

Generated by Sphinx-Gallery

News (Aug 2017):
pyGIMLi Paper out now! Download PDF here.

© 2017 - GIMLi Development Team
Created using Bootstrap and Sphinx. Last updated on Aug 15, 2017.