Components

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

Hillslope geomorphology

• LinearDiffuser: Model soil creep using “linear diffusion” transport law (no depth dependence)
• PerronNLDiffuse: Model soil creep using implicit solution to nonlinear diffusion law
• DepthDependentDiffuser: depth dependent diffusion after Johnstone and Hilley (2014)
• TransportLengthHillslopeDiffuser: Hillslope diffusion component in the style of Carretier et al. (2016), and Davy and Lague (2009)
• TaylorNonLinearDiffuser: Model non-linear soil creep after Ganti et al. (2013)
• DepthDependentTaylorDiffuser: Model depth dependent non-linear soil creep after Ganti et al. (2012) and Johnstone and Hilley (2014)

Fluvial geomorphology

• FastscapeEroder: Compute fluvial erosion using stream power theory (“fastscape” algorithm)
• StreamPower: Compute fluvial erosion using stream power theory (also uses “fastscape” algorithm but provides slightly different formulation and options)
• SedDepEroder: Compute fluvial erosion using using “tools and cover” theory
• StreamPowerSmoothThresholdEroder: Compute fluvial erosion using stream power theory with a numerically smoothed threshold
• DetachmentLtdErosion: Solve stream power equations, but without stability checks
• ErosionDeposition: Fluvial erosion in the style of Davy and Lague (2009)
• Stream Power with Alluvium Conservation and Entrainment
  • Space: Stream Power with Alluvium Conservation and Entrainment
  • SpaceLargeScaleEroder: SPACE large-scale eroder
• NetworkSedimentTransporter: Lagrangian sediment transport in a river network

Flow routing

• The Landlab FlowDirectors: Components for Flow Direction
  • FlowDirectorSteepest
  • FlowDirectorD8
  • FlowDirectorMFD
  • FlowDirectorDinf
• FlowAccumulator: Component to do FlowAccumulation with the FlowDirectors
• LossyFlowAccumulator: Component to accumulate flow with the FlowDirectors, while water is lost or gained downstream
• Functions to support flow accumulation
  • Route-to-one methods
  • Route-to-multiple methods
• DepressionFinderAndRouter: Handle depressions in terrain by calculating extent and drainage of “lakes”
• LakeMapperBarnes: Component to temporarily fill depressions and reroute flow across them
• PriorityFloodFlowRouter: Accumulate flow and calculate drainage area using RICHDEM
• SinkFiller: Permanently fill pits in a topography

Shallow water hydrodynamics

• OverlandFlow: Model shallow water flow over topography using the numerical approximation of de Almeida
• OverlandFlowBates: Model shallow water flow over topography using the numerical approximation of Bates
• KinematicWaveRengers
• KinwaveImplicitOverlandFlow
• KinwaveOverlandFlowModel
• LinearDiffusionOverlandFlowRouter
• TidalFlowCalculator: Calculate cycle-averaged tidal flow velocity using method of Mariotti (2018)

Land surface hydrology

• Radiation: Calculate solar radiation on topography given latitude, date, and time
• PotentialEvapotranspiration: Compute potential evapotranspiration
• SoilMoisture: Compute the decay of soil moisture saturation at storm-interstorm time period
• SoilInfiltrationGreenAmpt: Model infiltration of surface water according to the Green-Ampt equation

Groundwater hydrology

• GroundwaterDupuitPercolator: model flow in a shallow unconfined aquifer using the Dupuit-Forcheimer approximation

Landslides

• BedrockLandslider: Location and magnitude of episodic bedrock landsliding
• Landslides: Compute probability of failure for shallow landslides
• DimensionlessDischarge: Testing thresholds of debris flows in stream segments following Tang et al.

Vegetation

• Vegetation: Model plant dynamics using multiple representative plant species
• VegCA: Simulate plant competition with cellular automaton model for grass, shrubs, and trees

Biota

• Species Evolution
  • SpeciesEvolver: Component to evolve life in a landscape
  • ZoneController: Control zones and populates them with taxa
  • ZoneTaxon: A zone-based taxon

Precipitation

• PrecipitationDistribution: Generate random sequence of precipitation events
• SpatialPrecipitationDistribution: Generate random sequence of spatially-resolved precipitation events

Weathering

• ExponentialWeatherer: exponential soil production function in the style of Ahnert (1976)
• ExponentialWeathererIntegrated: exponential soil production function in the style of Ahnert (1976) integrated in dt

Subaqueous / Submarine Processes

• CarbonateProducer: Grow carbonate strata using growth function of Bosscher and Schlager (1992)
• SimpleSubmarineDiffuser: Calculate underwater sediment transport using water-depth-dependent diffusion

Terrain Analysis

• SteepnessFinder: Calcuate steepness and concavity indices from gridded topography
• ChiFinder: Perform chi-index analysis for gridded topography
• DrainageDensity: Calculate drainage density from topography
• Profiler: Create and plot profiles
• ChannelProfiler: Create and plot channel profiles
• TrickleDownProfiler: Create and plot trickle down profiles
• HackCalculator: Calculate Hack’s law coefficients
• HeightAboveDrainageCalculator: Calculate height above nearest drainage

Tectonics

• Flexure: Calculate elastic lithosphere flexure under given loads (assumes uniform flexural rigidity)
• Functions used to calculate lithospheric deflection
• gFlex: Compute elastic lithosphere flexure with variable rigidity
• NormalFault: Vertical uplift of grid nodes based on a user-specified uplift time series
• ListricKinematicExtender: Simulate Extensional Tectonic Motion on a Listric Fault Plane

Fire

• FireGenerator: Generate random sequence of fire events

Fracture Generation

• FractureGridGenerator: Generate random fracture patterns on a regular raster grid

Lithology

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.

• Lithology: Create a 3D representation of variable lithology

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

• LithoLayers: Create a layered lithology

Alphabetical Listing of Modules

• ChannelProfiler: Create and plot channel profiles
• ChiFinder: Perform chi-index analysis for gridded topography
• DepthDependentDiffuser: depth dependent diffusion after Johnstone and Hilley (2014)
• DepthDependentTaylorDiffuser: Model depth dependent non-linear soil creep after Ganti et al. (2012) and Johnstone and Hilley (2014)
• DetachmentLtdErosion: Solve stream power equations, but without stability checks
• LinearDiffuser: Model soil creep using “linear diffusion” transport law (no depth dependence)
• DimensionlessDischarge: Testing thresholds of debris flows in stream segments following Tang et al.
• DrainageDensity: Calculate drainage density from topography
• ErosionDeposition: Fluvial erosion in the style of Davy and Lague (2009)
• FireGenerator: Generate random sequence of fire events
• Flexure: Calculate elastic lithosphere flexure under given loads (assumes uniform flexural rigidity)
• Functions used to calculate lithospheric deflection
• FlowAccumulator: Component to do FlowAccumulation with the FlowDirectors
• LossyFlowAccumulator: Component to accumulate flow with the FlowDirectors, while water is lost or gained downstream
• Functions to support flow accumulation
  • Route-to-one methods
  • Route-to-multiple methods
• The Landlab FlowDirectors: Components for Flow Direction
  • FlowDirectorSteepest
  • FlowDirectorD8
  • FlowDirectorMFD
  • FlowDirectorDinf
• DepressionFinderAndRouter: Handle depressions in terrain by calculating extent and drainage of “lakes”
• FractureGridGenerator: Generate random fracture patterns on a regular raster grid
• gFlex: Compute elastic lithosphere flexure with variable rigidity
• GroundwaterDupuitPercolator: model flow in a shallow unconfined aquifer using the Dupuit-Forcheimer approximation
• HackCalculator: Calculate Hack’s law coefficients
• HeightAboveDrainageCalculator: Calculate height above nearest drainage
• LakeMapperBarnes: Component to temporarily fill depressions and reroute flow across them
• Landslides: Compute probability of failure for shallow landslides
• landlab.components.lateral_erosion package
  • Submodules
  • landlab.components.lateral_erosion.lateral_erosion module
  • landlab.components.lateral_erosion.node_finder module
  • Module contents
• Lithology: Create a 3D representation of variable lithology
• PerronNLDiffuse: Model soil creep using implicit solution to nonlinear diffusion law
• NormalFault: Vertical uplift of grid nodes based on a user-specified uplift time series
• OverlandFlow: Model shallow water flow over topography using the numerical approximation of de Almeida
• OverlandFlowBates: Model shallow water flow over topography using the numerical approximation of Bates
• KinematicWaveRengers
• KinwaveImplicitOverlandFlow
• KinwaveOverlandFlowModel
• LinearDiffusionOverlandFlowRouter
• PotentialEvapotranspiration: Compute potential evapotranspiration
• VegCA: Simulate plant competition with cellular automaton model for grass, shrubs, and trees
• PotentialityFlowRouter: Find flow directions and accumulation using potential-field theory
• Radiation: Calculate solar radiation on topography given latitude, date, and time
• SinkFiller: Permanently fill pits in a topography
• SoilMoisture: Compute the decay of soil moisture saturation at storm-interstorm time period
• Stream Power with Alluvium Conservation and Entrainment
  • Space: Stream Power with Alluvium Conservation and Entrainment
  • SpaceLargeScaleEroder: SPACE large-scale eroder
• SpatialPrecipitationDistribution: Generate random sequence of spatially-resolved precipitation events
• Species Evolution
  • SpeciesEvolver: Component to evolve life in a landscape
  • ZoneController: Control zones and populates them with taxa
  • ZoneTaxon: A zone-based taxon
• SteepnessFinder: Calcuate steepness and concavity indices from gridded topography
• FastscapeEroder: Compute fluvial erosion using stream power theory (“fastscape” algorithm)
• StreamPower: Compute fluvial erosion using stream power theory (also uses “fastscape” algorithm but provides slightly different formulation and options)
• SedDepEroder: Compute fluvial erosion using using “tools and cover” theory
• StreamPowerSmoothThresholdEroder: Compute fluvial erosion using stream power theory with a numerically smoothed threshold
• TaylorNonLinearDiffuser: Model non-linear soil creep after Ganti et al. (2013)
• TransportLengthHillslopeDiffuser: Hillslope diffusion component in the style of Carretier et al. (2016), and Davy and Lague (2009)
• PrecipitationDistribution: Generate random sequence of precipitation events
• Vegetation: Model plant dynamics using multiple representative plant species
• ExponentialWeatherer: exponential soil production function in the style of Ahnert (1976)
• ExponentialWeathererIntegrated: exponential soil production function in the style of Ahnert (1976) integrated in dt