Python interface

    Basilisk also includes a high-level interface for the Python programming language.

    This example documents how to use this interface to setup the decaying two-dimensional turbulence simulation.

    First check that Basilisk is configured properly for use with Python.

    Basilisk python module

    The first step is to create a python module importing the necessary functions from Basilisk. For this example we just need to create a file called stream.c with the following lines

    i.e. we will use the streamfunction–vorticity Navier–Stokes solver with a multigrid discretisation.

    To create the corresponding python module, assuming that a Makefile has been setup properly, we can just do


    Python program

    The next step is to create the python program itself, let’s call it

    We first import matplotib, numpy and our Basilisk module.

    from __future__ import print_function
    import matplotlib.pyplot as plt
    import numpy as np
    import stream as bas

    We setup a numpy regular grid which will hold the values interpolated from the Basilisk field.

    N = 256
    x = np.linspace(0, 1, N)
    y = np.linspace(0, 1, N)
    X,Y = np.meshgrid(x,y)

    We define a function which sets initial conditions for the vorticity \omega: a white noise.

    def init(i,t): = bas.noise

    We define a function which uses matplotlib to generate a graph of the \omega field.

    def graph(i,t):
        print ("t=",t)
        Z =,Y)

    We setup Basilisk’s resolution to match that of our numpy grid.


    We register the initial condition (at t=0) and graph function (at t = 0,10,20,…,1000).

    bas.event(init, t = 0.)
    bas.event(graph, t = range(0,1000,10))

    We run the simulation.