pyBadlands workshop

Docker image

Docker image

$ docker pull brmather/pybadlands-workshop:18.04-ubuntu
$ docker images
REPOSITORY                            TAG                 IMAGE ID            CREATED             SIZE
brmather/pybadlands-workshop          18.04-ubuntu        0f196ceade6d        5 hours ago         3.17GB
brmather/pybadlands-workshop-base     18.04-ubuntu        17a94e4b836a        2 days ago          1.7GB
$ docker run --name pybadlands -p 8888:8888 brmather/pybadlands-workshop:18.04-ubuntu
$ docker ps
CONTAINER ID        IMAGE                                       COMMAND                  CREATED             STATUS              PORTS                              NAMES
d553869450dc        brmather/pybadlands-workshop:16.04-ubuntu   "/usr/local/bin/tiniā€¦"   5 hours ago         Up 5 hours          9999/tcp,>8888/tcp   pybadlands-workshop

Pull the docker image to your computer and run it within a container


Alternatively, load the workshop in the cloud with Binder

IMPORTANT: Binder does not save your work and will time-out after a period of inactivity.

If everything went well, you should see this...

navigate to examples

Example 1: basin

  1. Generate topographic grid
  2. Build sea level curve
  3. Run time series

badlands model - basin.xml

<?xml version="1.0" encoding="UTF-8"?>
<badlands xmlns:xsi="">

    <!-- Regular grid structure -->
        <!-- Digital elevation model file path -->
        <!-- Boundary type: flat, slope, fixed or wall -->
        <!-- Optional parameter (integer) used to decrease TIN resolution.
             The default value is set to 1. Increasing the factor
             value will multiply the digital elevation model resolution
             accordingly.  -->

    <!-- Simulation time structure -->
        <!-- Simulation start time [a] -->
        <!-- Simulation end time [a] -->
        <!-- Display interval [a] -->

    <!-- Simulation stratigraphic structure -->
        <!-- Stratal grid resolution [m] -->
        <!-- Stratal layer interval [a] -->

    <!-- Sea-level structure -->
        <!-- Relative sea-level position [m] -->
        <!-- Sea-level curve - (optional) -->
        <!-- Limit flow network computation based on
             water depth [m] -->

    <!-- Precipitation structure -->
        <!-- Number of precipitation events -->
        <!-- Precipitation definition -->
            <!-- Rain start time [a] -->
            <!-- Rain end time [a] -->
            <!-- Precipitation value [m/a] - (optional) -->

    <!-- Stream power law parameters:
         The stream power law is a simplified form of the usual expression of
         sediment transport by water flow, in which the transport rate is assumed
         to be equal to the local carrying capacity, which is itself a function of
         boundary shear stress. -->
        <!-- Make the distinction between purely erosive models (0) and erosion /
            deposition ones (1). Default value is 1 -->
        <!-- Critical slope used to force aerial deposition for alluvial plain,
             in [m/m] (optional). -->
        <!-- Maximum percentage of deposition at any given time interval from rivers
             sedimentary load in alluvial plain. Value ranges between [0,1] (optional). -->
        <!-- Planchon & Darboux filling thickness limit [m]. This parameter is used
              to defined maximum accumulation thickness in depression area per time
              step. Default value is set to 1. -->
        <!-- Values of m and n indicate how the incision rate scales
             with bed shear stress for constant value of sediment flux
             and sediment transport capacity.
             Generally, m and n are both positive, and their ratio
             (m/n) is considered to be close to 0.5 -->
         <!-- The erodibility coefficient is scale-dependent and its value depend
             on lithology and mean precipitation rate, channel width, flood
             frequency, channel hydraulics. In case where the erodibility
             structure is turned on, this coefficient is applied to the reworked
             sediments. -->
        <!-- Number of steps used to distribute marine deposit.
             Default value is 5 (integer). (optional)-->
        <!-- Proportion of marine sediment deposited on downstream nodes. It needs
             to be set between ]0,1[. Default value is 0.9 (optional). -->

    <!-- Linear slope diffusion parameters:
         Parameterisation of the sediment transport includes the simple creep transport
         law which states that transport rate depends linearly on topographic gradient. -->
        <!-- Surface diffusion coefficient [m2/a] -->
        <!-- Marine diffusion coefficient [m2/a] -->
        <!-- River transported sediment diffusion
             coefficient in marine realm [m2/a] -->

    <!-- Output folder path -->


Visualisation in Paraview


Analyse stratigraphic output

Example 2: rift

Explore the erosion and deposition effects associated with rifting.

Visualisation in Paraview

Shell Workshop

By Ben Mather

Shell Workshop

  • 65
Loading comments...

More from Ben Mather