unsatstab

Transient unsaturated infiltration and spatial slope-unit stability analysis.

unsatstab is a Python package for physics-based modelling of rainfall-induced slope instability. It couples a one-dimensional analytical solution for transient unsaturated infiltration with a storage-based water-table model and an infinite-slope factor-of-safety formulation. The same modelling framework can be applied to individual slope columns or extended to spatial analyses over geomorphological slope units.

Installation

Requirements

Python 3.12 or newer. NumPy, SciPy, pandas, Matplotlib, GeoPandas, and Joblib are among the dependencies installed with the package.

Install from GitHub

python -m pip install 'git+https://github.com/eamontoyaa/unsatstab.git'

Explore the documentation

Theory and foundations: model equations, assumptions, equation provenance, and references.
Inputs and outputs: column parameters, rainfall histories, slope-unit domains, results, and numerical controls.
Numerical verification: reference comparisons and the scope of the evidence.
Cerro Bravo study-site application: deterministic scenarios for the Cerro Bravo case study and the scope of the validation evidence.
API reference: Python functions and classes, organized by module.

Tutorials

Citing unsatstab

If you use unsatstab in a scientific publication or in a technical report, cite the associated methodological work:

Montoya-Araque, E. A., Ruiz, D. F., Castillo-Cardona, E., & Gamboa, M. (202X). unsatstab: a physics-based model for transient unsaturated infiltration and rainfall-induced slope stability at the slope-unit scale [journal paper under preparation].

Montoya-Araque, E. A., Ruiz, D. F., Castillo-Cardona, E., & Gamboa, M. (2026). Fragility Curves for the Probabilistic Analysis of Rainfall-Induced Landslides through Physics-Based Numerical Modeling. Manuscript prepared for the XIX Colombian Geotechnical Congress.

For reproducibility, also cite the exact unsatstab version or repository commit, along with parameter tables, rainfall-to-infiltration assumptions, and numerical controls.