Find Landlab’s User Guide on the Landlab Wiki

Landlab Reference Manual and API Documentation

A guide to Landlab’s classes and code.


An extensive index to the Landlab grid and its methods is found on the following page. Below is a short hyperlinked summary.

Grid types

As of Landlab version 1.5.5, there are five types of Landlab grid:

The base class is ModelGrid with subclasses RasterModelGrid and VoronoiDelaunayGrid.

VoronoiDelaunayGrid has two further specialized subclasses: HexModelGrid and RadialModelGrid.

A final class is NetworkModelGrid.


The Landlab values submodule provides capabilities to generate synthetic values for model grid fields.


Landlab has the ability to add layers to the grid. Two types of layers are currently supported. First is EventLayers in which each event is preserved as an entry into the datastructure, even if no deposition occurs. If you are interested in chronostratigraphy, this is probably what you are interested in. Second is MaterialLayers, in which each layer must contain some material. If an entire layer is eroded in MaterialLayers, the layer is removed. MaterialLayers will likely use less memory than EventLayers.


This section contains documentation and API reference information for the following categories of components:


Two objects based on the EventLayers object exist to make it easier to deal with spatially variable lithology and associated properties. The Lithology components contain information about spatially variable lithology and connect with the Landlab model grid so that when rock is eroded or advected upward by rock uplift the values of rock propeties at the topographic surface are updated.

First is the Lithology component which is a generic object for variable lithology.

Second is LithoLayers which makes it easy to make layered rock.

Data Structure