1. From state to susceptibility¶
Given the soil state from Pillar 1 (saturation , water-table depth , effective stress, strength) and current forcing, the nowcast estimates the likelihood and severity of each hazard at the present time. “Susceptibility” here is a probability of failure, not a binary map — the quantity that downstream warning and the forecast build on. Two hazard tracks are in scope:
(a) Landslides — advanced; modeled with Landlab — full equations, pipeline, and limits on the Landslide Model page (§2).
(b) Liquefaction & ground failure — in development; overview in §3, full model on the Liquefaction Model page (§3).
2. Landslides¶
2.1 Three types, three physics¶
Following the Varnes classification update Hungr et al., 2014, we treat three distinct failure processes that share data but not governing physics — each will become its own subpage:
| Type | Failure surface | Dominant control | Burn severity input? | Hazard page |
|---|---|---|---|---|
| Shallow landslides | ~0.5–3 m (soil mantle) | storm infiltration → pore pressure → loss of suction | No | landslides |
| Deep-seated landslides | meters–tens of m | groundwater / hydraulic head on seasonal–multiyear scales | No | landslides |
| Post-fire debris flows | mobilized channel/colluvium | high-intensity rainfall on recently burned, fire-altered terrain | Yes | post-fire debris flows |
The core GAIA digital-twin landslide products — shallow and deep-seated susceptibility — are rainfall- and groundwater-driven and do not take burn severity as an input. Post-fire debris flows are a special, wildfire-conditioned case of landsliding: only that track adds a burn-severity layer and fire-reduced cohesion. The current modeling effort targets shallow-landslide probability; the same Landlab framework extends to the others by swapping the hydrology and stability closures (and, for post-fire debris flows, adding the fire terms).
2.2 Modeling with Landlab¶
Landlab is an open-source Python toolkit for building
two-dimensional numerical models of Earth-surface processes Hobley et al., 2017Barnhart et al., 2020. Its
defining feature — the one that matters most for us — is component-based model coupling
on a shared grid: a library of interoperable components (flow routing, snowpack,
ecohydrology, slope stability) that each read and write named fields (topographic__elevation,
soil__saturated_hydraulic_conductivity, …) on one common raster grid. This lets us chain a
full hillslope hydrology-to-stability pipeline instead of stitching together disconnected
models — the intermediate fields (e.g. soil moisture) are explicit, inspectable, and
validatable (§2.6).
The landslide engine is Landlab’s LandslideProbability component Strauch et al., 2018, a
probabilistic infinite-slope model driven by a topographically-controlled wetness index.
2.3 The physics (the equations we solve)¶
Infinite-slope factor of safety. On a planar failure surface at slope angle , the factor of safety is the ratio of resisting to driving stress. In the dimensionless form used by the Landlab component Strauch et al., 2018:
where is the combined root + soil cohesion normalized by the saturated soil weight, is soil depth, the internal friction angle, soil and water densities, and is the relative wetness (saturated fraction of the soil column). Failure is expected when .
Relative wetness (the topographic control). Following steady-state shallow subsurface flow Beven & Kirkby, 1979Montgomery & Dietrich, 1994, wetness rises with recharge and contributing area and falls with transmissivity and slope:
with recharge , soil transmissivity , specific contributing area (upslope area per unit contour width, from flow routing), and slope . This is the SHALSTAB/SINMAP family of models Montgomery & Dietrich, 1994Pack et al., 1998; the unsaturated extension via suction stress is given by Lu & Godt, 2008Iverson, 2000.
From factor of safety to probability. The inputs , , , are uncertain. The component draws them from distributions and runs a Monte Carlo ensemble, yielding a distribution of . The nowcast susceptibility is the probability of failure
i.e. the fraction of the ensemble that fails — a continuous 0–1 field, not a yes/no map.
2.4 Data clarity: raw vs. static vs. dynamic vs. derived vs. label¶
The most common source of confusion in this pipeline is conflating what is measured, what is computed, what is predicted, and what is used to check the prediction. They are different objects with different uncertainty and different roles:
RAW INPUTS ──► DERIVED / INTERMEDIATE FIELDS ──► PREDICTION ──► checked against ──► LABELS
(measured) (computed by the model) (P_f) (independent truth)Raw inputs are measured/observed and ingested via DataHub (Pillar 1).
Static inputs do not change over a run; dynamic inputs are time-varying forcing.
Derived / intermediate fields are computed by the model — they are not data, even though some (soil moisture, SWE) can be independently validated (your colleagues’ term: calibration).
Predictions are model outputs (the probability of failure).
Labels are independent observations of actual landslides, used only to score the prediction — never as model inputs.
| Field | Category | Source / how obtained | Confidence | Limitation & influence on susceptibility |
|---|---|---|---|---|
topographic__elevation (DEM) | raw, static | USGS 10 m 3DEP | High | Smooths <10 m gullies; sets slope and contributing area — dominant geometric control |
| Soil texture, depth, , cohesion, | raw, static | SOLUS100 / POLARIS (see Pillar 1) | Medium–low | Static, smoothed at 30–100 m; sets , , — strong, and the most uncertain priors |
| Burn severity (dNBR) | raw, static (per event) — post-fire debris flows only | MTBS/BAER | Medium | Not used for shallow/deep landslide susceptibility. For the post-fire case only: lowers cohesion / raises runoff |
| Land cover / vegetation | raw, static | NLCD | Medium | Sets root cohesion and ET; moderate influence |
| Precipitation, / | raw, dynamic | PRISM (staged by gaia-cli) | Medium | 800 m–4 km; the proximate trigger — drives recharge |
| Contributing area | derived, static | flow routing on the DEM | High (given DEM) | Inherits DEM error; controls |
| SWE, snowmelt | derived, dynamic | snow component (rain/snow partition) | Medium | Mispartition shifts the timing of in snow-affected terrain |
| PET, soil moisture | derived, dynamic | ecohydrology component | Medium | Calibratable against in-situ/Pillar-1 ground truth — the key intermediate check |
| Recharge , transmissivity | derived, dynamic | routed recharge | Low–medium | Direct inputs to ; large parameter uncertainty → propagated by Monte Carlo |
| Relative wetness | derived, dynamic | wetness index (§2.3) | — | The hydrologic state variable entering |
| Probability of failure | PREDICTION | LandslideProbability | — | The nowcast product |
| Landslide masks / inventories | LABEL | Sentinel SAR/InSAR & optical Mondini et al., 2021Handwerger et al., 2022; post-event DEM/lidar differencing Bernard et al., 2021 | Varies | Used only to score (§2.6) — not a model input |
Several of these layers (DEM, soil saturation, water table, precipitation) are shared with other hazards. The full layer-by-layer catalog is the single, cross-hazard Data Inventory, which carries hazard-purpose icons (⛰️ 🔥 🏚️ 🌊) marking which layer serves which hazard.
2.5 The prediction pipeline¶
Landslide probability is produced by
gaia-hazlab/landlab-debrisflow (the
“MMP” multi-model-probability workflow), which chains the Landlab components exactly along the
taxonomy above:
terrain (DEM, flow accumulation)
→ static_inputs (soil, vegetation, transmissivity, cohesion
[+ burn severity — post-fire debris flows only])
→ daily_forcing (PRISM ppt, tmin, tmax)
→ snow (rain/snow partition, SWE, melt)
→ ecohydrology (PET, soil moisture)
→ landslides (routed recharge → LandslideProbability → P_f)
→ exports (GeoTIFF / ASC)As currently configured for the Stehekin/Pioneer events, this is the post-fire debris-flow
workflow — hence the burn-severity layer and fire-reduced cohesion. The core shallow and
deep-seated landslide susceptibility runs the same stability engine and hydrology
without the burn-severity input. It uses the data prepared in Pillar 1
(fire-debrisflow-ml and the SOLUS/PRISM
staging). Today it still reads hardcoded local paths for those inputs; aligning it with the
DataHub Integration Guide is the integration task that connects
Pillars 1 and 2.
2.6 Calibration and validation¶
Two distinct checks, often conflated:
Calibration — verify the intermediate fields against observations: soil moisture and SWE against in-situ sensors and the Pillar-1 ground-truth networks. This tunes the hydrology before any landslide claim is made.
Validation — score the prediction against independent landslide labels: Sentinel-1 InSAR / SAR detections Mondini et al., 2021Handwerger et al., 2022 and, for the post-wildfire niche, post-event DEM/lidar differencing masks Bernard et al., 2021. These labels never enter the model.
Metrics (ROC/precision-recall and Brier score for , spatial IoU for mapped failures, alert lead time) are defined in HazEvalHub.
2.7 Repository naming (suggestions)¶
The current names obscure what the repos do and should be clarified (tracked in the DataHub Integration Guide):
landlab-debrisflowactually computes shallow-landslide probability (its internal package isdebris_landlab), not only debris flows → suggestgaia-model-landslide(the susceptibility model).fire-debrisflow-mlis data preparation → suggestgaia-dataprep-landslide.This makes the data-prep (Pillar 1) → model (Pillar 2) split explicit in the repo names.
3. Liquefaction & ground failure¶
Earthquake shaking can turn saturated, loose granular soils into a fluid-like state — liquefaction — driving settlement, lateral spreading, and ground failure (hazard page). Unlike landslides, the trigger is seismic, not meteorological; but the susceptibility is set by the same Pillar-1 state — saturation and water-table depth — coupled to the soil’s stiffness. GAIA builds a ground liquefaction model (GLM) digital twin on the geospatial-modeling line of Zhu et al., 2015Zhu et al., 2017 as advanced by Sanger, Geyin & Maurer Sanger et al., 2025Sanger & Maurer, 2026Sanger & Maurer, 2025.
Where hydrology and rigidity enter. Liquefaction is governed by the cyclic stress ratio (demand) versus the cyclic resistance ratio (capacity), Seed & Idriss, 1971Idriss & Boulanger, 2006. The water table sets effective stress (in both demand and capacity) and gates which soil is saturated enough to liquefy; shear-wave velocity raises capacity (CRR) and modulates demand through site amplification Andrus & Stokoe, 2000. Both are Pillar-1 state variables — the direct line by which the soil reanalysis, and sea-level rise / seasonal water-table change, modulate liquefaction.
Three framings. The GLM digital twin serves three questions — conditional (, the national surrogate), unconditional (integrated over the NSHM hazard curve for a return period), and event-based (a ShakeMap field for a specific rupture, e.g. Cascadia or Nisqually). A distinctive open question is whether a time-varying attenuation / site term (, ) — which the GAIA seismic networks can estimate and which varies seasonally Händel et al., 2025 — can be fed back into the fixed-site-term NSHM.
Even the static layers (, geology, water table) must be high-resolution: liquefaction is controlled by meter-scale contrasts, so coarse inputs smear hazard. On top of them GAIA adds the dynamic hydrological and mechanical effects. The full equations, the solved-vs-assumed breakdown, the framings in detail, attenuation, Earth2Studio integration, and evaluation are on the Liquefaction Model page; the layer-by-layer data inventory (with cross-hazard icons) is on the Data Inventory page.
4. Evaluation & metrics¶
See HazEvalHub: event-based detection (POD, FAR, CSI), spatial agreement (IoU/Dice), probabilistic calibration (Brier, reliability diagrams) for , and alert lead time.
5. Open questions & roadmap¶
Quantify how prior uncertainty in static soil layers propagates to (sensitivity study).
Close the Pillar 1 → Pillar 2 data loop by migrating
landlab-debrisflowonto DataHub.Liquefaction: integrate a time-varying site term (, ) into the NSHM hazard input for the unconditional product (see Liquefaction Model §5).
Liquefaction: stand up the proposed repositories and the groundwater coupling for sea-level-rise/seasonal effects (see Liquefaction Model §9).
References¶
- Hungr, O., Leroueil, S., & Picarelli, L. (2014). The Varnes classification of landslide types, an update. Landslides, 11(2), 167–194. 10.1007/s10346-013-0436-y
- Hobley, D. E. J., Adams, J. M., Nudurupati, S. S., Hutton, E. W. H., & others. (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(1), 21–46. 10.5194/esurf-5-21-2017
- Barnhart, K. R., Hutton, E. W. H., Tucker, G. E., Gasparini, N. M., & others. (2020). Short communication: Landlab v2.0: a software package for Earth surface dynamics. Earth Surface Dynamics, 8(2), 379–397. 10.5194/esurf-8-379-2020
- Strauch, R., Istanbulluoglu, E., Nudurupati, S. S., Bandaragoda, C., Gasparini, N. M., & Tucker, G. E. (2018). A hydroclimatological approach to predicting regional landslide probability using Landlab. Earth Surface Dynamics, 6, 49–75. 10.5194/esurf-6-49-2018
- Beven, K. J., & Kirkby, M. J. (1979). A physically based, variable contributing area model of basin hydrology. Hydrological Sciences Bulletin, 24(1), 43–69. 10.1080/02626667909491834
- Montgomery, D. R., & Dietrich, W. E. (1994). A physically based model for the topographic control on shallow landsliding. Water Resources Research, 30(4), 1153–1171. 10.1029/93WR02979
- Pack, R. T., Tarboton, D. G., & Goodwin, C. N. (1998). The SINMAP Approach to Terrain Stability Mapping. Proceedings of the 8th Congress of the International Association of Engineering Geology, Vancouver, BC, 1157–1166.
- Lu, N., & Godt, J. (2008). Infinite slope stability under steady unsaturated seepage conditions. Water Resources Research, 44(11), W11404. 10.1029/2008WR006976
- Iverson, R. M. (2000). Landslide triggering by rain infiltration. Water Resources Research, 36(7), 1897–1910. 10.1029/2000WR900090
- Mondini, A. C., Guzzetti, F., Chang, K.-T., Monserrat, O., Martha, T. R., & Manconi, A. (2021). Landslide failures detection and mapping using Synthetic Aperture Radar: Past, present and future. Earth-Science Reviews, 216, 103574. 10.1016/j.earscirev.2021.103574
- Handwerger, A. L., Huang, M.-H., Jones, S. Y., Amatya, P., Kerner, H. R., & Kirschbaum, D. B. (2022). Generating landslide density heatmaps for rapid detection using open-access satellite radar data in Google Earth Engine. Natural Hazards and Earth System Sciences, 22, 753–773. 10.5194/nhess-22-753-2022
- Bernard, T. G., Lague, D., & Steer, P. (2021). Beyond 2D landslide inventories and their rollover: synoptic 3D inventories and volume from repeat lidar data. Earth Surface Dynamics, 9, 1013–1044. 10.5194/esurf-9-1013-2021
- Zhu, J., Daley, D., Baise, L. G., Thompson, E. M., Wald, D. J., & Knudsen, K. L. (2015). A Geospatial Liquefaction Model for Rapid Response and Loss Estimation. Earthquake Spectra, 31(3), 1813–1837. 10.1193/121912EQS353M
- Zhu, J., Baise, L. G., & Thompson, E. M. (2017). An Updated Geospatial Liquefaction Model for Global Application. Bulletin of the Seismological Society of America, 107(3), 1365–1385. 10.1785/0120160198
- Sanger, M. D., Geyin, M., & Maurer, B. W. (2025). Mechanics-Informed Machine Learning for Geospatial Modeling of Soil Liquefaction: Global and National Surrogate Models for Simulation and Near-Real-Time Response. Journal of Geotechnical and Geoenvironmental Engineering, 151(11), 04025126. 10.1061/JGGEFK.GTENG-13737