Model:Landlab

Landlab

This code has been community reviewed and published in the open access Journal of Open Source Software (JOSS)

Metadata

Also known as
Model type	Modular
Model part of larger framework	LandLab

Incorporated models or components:

Spatial dimensions	2D
Spatial extent	Landscape-Scale, Watershed-Scale, Reach-Scale, Patch-Scale
Model domain	Terrestrial, Hydrology, Coastal, Marine
One-line model description	Python software framework for writing, assembling, and running 2D numerical models
Extended model description	Landlab is a Python software package for creating, assembling, and/or running 2D numerical models. Landlab was created to facilitate modeling in earth-surface dynamics, but it is general enough to support a wide range of applications. Landlab provides three different capabilities: (1) A DEVELOPER'S TOOLKIT for efficiently building 2D models from scratch. The toolkit includes a powerful GRIDDING ENGINE for creating, managing, and iterative updating data on 2D structured or unstructured grids. The toolkit also includes helpful utilities to handle model input and output. (2) A set of pre-built COMPONENTS, each of which models a particular process. Components can be combined together to create coupled models. (3) A library of pre-built MODELS that have been created by combining components together. To learn more, please visit http://landlab.github.io

Keywords:

Name	Greg Tucker
Type of contact	Model developer
Institute / Organization	University of Colorado
Postal address 1	Campus Box 399
Postal address 2
Town / City	Boulder
Postal code	80309
State	Colorado
Country	United States
Email address	gtucker@cires.colorado.edu
Phone	+1 303 492 6985
Fax

Name	Nicole Gasparini
Type of contact	Model developer
Institute / Organization	Tulane University
Postal address 1
Postal address 2
Town / City	New Orleans
Postal code
State	Louisiana
Country	United States
Email address
Phone
Fax

Name	Erkan Istanbulluoglu
Type of contact	Model developer
Institute / Organization	University of Washington
Postal address 1
Postal address 2
Town / City	Seattle
Postal code
State	Washington
Country	United States
Email address
Phone
Fax

Name	Eric Hutton
Type of contact	Model developer
Institute / Organization	University of Colorado
Postal address 1	CSDMS
Postal address 2
Town / City	Boulder
Postal code	80309
State	Colorado
Country	United States
Email address
Phone
Fax

Supported platforms	Unix, Linux, Mac OS, Windows
Other platform
Programming language	Python
Other program language
Code optimized	Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development	2012
Does model development still take place?	Yes
If above answer is no, provide end year model development
Code development status	Active
When did you indicate the 'code development status'?	2020
Model availability	As code
Source code availability (Or provide future intension)	Through web repository
Source web address	https://github.com/landlab/landlab/
Source csdms web address
Program license type	Other
Program license type other	MIT License
Memory requirements	variable
Typical run time	variable

Describe input parameters	Because this is a toolkit for model building, there are no set input parameters. Rather, developers use the code to create their own models, with their own unique inputs. The ModelParameterDictionary tool provides formatted ASCII input for model parameters. The I/O component also handles input of digital elevation models (DEMs) in standard ArcInfo ASCII format.
Input format	ASCII
Other input format
Describe output parameters	Gridding component provides ASCII and/or netCDF output of grid geometry.
Output format	ASCII
Other output format
Pre-processing software needed?	No
Describe pre-processing software
Post-processing software needed?	No
Describe post-processing software
Visualization software needed?	Yes
If above answer is yes	Matlab
Other visualization software	Python, VisIt

Describe processes represented by the model	As of autumn 2013, the library of process components includes the following: - diffusion (for conductive heat transport, soil transport over terrain, or other applications of diffusion theory) - single-direction flow routing over topography - detachment-limited stream erosion - solar radiation input as a function of topography, latitude, and time - evapotranspiration - soil-moisture dynamics - stochastic storm generation - stochastic wildfire generation - impact cratering - overland flow / flood inundation
Describe key physical parameters and equations	See documentation at: http://landlab.readthedocs.org
Describe length scale and resolution constraints	Depends on application/process
Describe time scale and resolution constraints	Depends on application/process
Describe any numerical limitations and issues	Depends on application/process

Describe available calibration data sets	Varies among components and models
Upload calibration data sets if available:
Describe available test data sets	Varies among components and models. All components include internal consistency checks using the doctest package.
Upload test data sets if available:
Describe ideal data for testing	Varies among components and models

Do you have current or future plans for collaborating with other researchers?	Landlab was created for the scientific community to use and share. We encourage anyone interested to contribute new components and models.

Is there a manual available?	Yes
Upload manual if available:
Model website if any	Documentation online at http://landlab.github.io
Model forum / discussion board

Comments

This part will be filled out by CSDMS staff

OpenMI compliant	No but possible
BMI compliant	No but possible
WMT component	No but possible
PyMT component
Is this a data component

Can be coupled with:

Model info

Authors

Greg Tucker

Gasparini, Istanbulluoglu, Hutton

Source code

Go to external source code site

Model citations

Nr. of publications:	40
Total citations:	599
h-index:	15
m-quotient:	1.67

QR-code

Link to this page

Other models by author

Introduction

History

References

Nr. of publications:	40
Total citations:	599
h-index:	15
m-quotient:	1.67

Featured publication(s)	Year	Model described	Type of Reference	Citations
Hobley, Daniel E. J.; Adams, Jordan M.; Nudurupati, Sai Siddhartha; Hutton, Eric W. H.; Gasparini, Nicole M.; Istanbulluoglu, Erkan; Tucker, Gregory E.; 2017. Creative computing with Landlab: an open-source toolkit for building, coupling, and exploring two-dimensional numerical models of Earth-surface dynamics. Earth Surface Dynamics, 5, 21–46. 10.5194/esurf-5-21-2017 (View/edit entry)	2017	ChannelProfiler DepthDependentTaylorDiffuser Landlab LinearDiffuser	Model overview	124
Adams, Jordan M.; Gasparini, Nicole M.; Hobley, Daniel E. J.; Tucker, Gregory E.; Hutton, Eric W. H.; Nudurupati, Sai S.; Istanbulluoglu, Erkan; 2017. The Landlab v1.0 OverlandFlow component: a Python tool for computing shallow-water flow across watersheds. Geoscientific Model Development, 10, 1645–1663. 10.5194/gmd-10-1645-2017 (View/edit entry)	2017	Landlab OverlandFlow	Model overview	29
Shobe, Charles M.; Tucker, Gregory E.; Barnhart, Katherine R.; 2017. The SPACE 1.0 model: a Landlab component for 2-D calculation of sediment transport, bedrock erosion, and landscape evolution. Geoscientific Model Development, 10, 4577–4604. 10.5194/gmd-10-4577-2017 (View/edit entry)	2017	Landlab SPACE	Model overview	39
Wickert, A. D.; 2016. Open-source modular solutions for flexural isostasy: gFlex v1.0. Geoscientific Model Development, 9, 997–1017. 10.5194/gmd-9-997-2016 (View/edit entry)	2016	GFlex Landlab	Model overview	27
Tucker, Gregory E.; McCoy, Scott W.; Hobley, Daniel E. J.; 2018. A lattice grain model of hillslope evolution. Earth Surface Dynamics, 6, 563–582. 10.5194/esurf-6-563-2018 (View/edit entry)	2018	GrainHill Landlab	Model overview	5
Barnhart, Katherine R.; Glade, Rachel C.; Shobe, Charles M.; Tucker, Gregory E.; 2019. Terrainbento 1.0: a Python package for multi-model analysis in long-term drainage basin evolution. Geoscientific Model Development, 12, 1267–1297. 10.5194/gmd-12-1267-2019 (View/edit entry)	2019	Landlab Terrainbento	Model overview	15
Glade, Rachel C.; Shobe, Charles M.; Anderson, Robert S.; Tucker, Gregory E.; 2019. Canyon shape and erosion dynamics governed by channel-hillslope feedbacks. Geology, 47, 650–654. 10.1130/G46219.1 (View/edit entry)	2019	BlockLab Landlab	Model overview	19
Barnhart, Katherine; Hutton, Eric; Gasparini, Nicole; Tucker, Gregory; 2018. Lithology: A Landlab submodule for spatially variable rock properties. Journal of Open Source Software, 3, 979. 10.21105/joss.00979 (View/edit entry)	2018	Landlab Lithology	Model overview	6
Barnhart, Katherine R.; Hutton, Eric W. H.; Tucker, Gregory E.; Gasparini, Nicole M.; Istanbulluoglu, Erkan; Hobley, Daniel E. J.; Lyons, Nathan J.; Mouchene, Margaux; Nudurupati, Sai Siddhartha; Adams, Jordan M.; Bandaragoda, Christina; 2020. Short communication: Landlab v2.0: A software package for Earth surface dynamics. Earth Surface Dynamics, , 379-397. 10.5194/esurf-8-379-2020 (View/edit entry)	2020	Landlab	Model overview	19
See more publications of Landlab

Issues

Help

Input Files

Output Files