Metadata-Version: 2.5
Name: unsatstab
Version: 1.0.0
Summary: Spatially distributed unsaturated infiltration and infinite-slope stability modeling.
Project-URL: Homepage, https://github.com/eamontoyaa/unsatstab
Project-URL: Documentation, https://eamontoyaa.github.io/unsatstab/
Project-URL: Repository, https://github.com/eamontoyaa/unsatstab
Project-URL: Issues, https://github.com/eamontoyaa/unsatstab/issues
Project-URL: Exneyder A. Montoya-Araque, https://www.researchgate.net/profile/Exneyder-A-Montoya-Araque
Project-URL: Daniel F. Ruiz, https://www.researchgate.net/profile/Daniel-F-Ruiz-2
Project-URL: Emanuel Castillo-Cardona, https://www.researchgate.net/profile/Emanuel-Castillo-Cardona
Author: Exneyder A. Montoya-Araque, Daniel F. Ruiz, Emanuel Castillo-Cardona
License-Expression: MIT
License-File: LICENSE
Keywords: TRIGRS,geoscience,infiltration,landslides,slope stability,unsaturated flow
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.12
Requires-Dist: geopandas>=1.0
Requires-Dist: joblib>=1.4
Requires-Dist: matplotlib>=3.9
Requires-Dist: numpy>=2.1.3
Requires-Dist: pandas>=2.2
Requires-Dist: scipy>=1.15
Description-Content-Type: text/markdown

# unsatstab

<img src="https://raw.githubusercontent.com/eamontoyaa/unsatstab/main/docs/assets/unsatstab_logo.svg" alt="unsatstab logo: rainfall, an inclined soil column, a saturated zone, and basal drainage" align="right" width="110">

**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.

[Documentation](https://eamontoyaa.github.io/unsatstab/)

## Installation

Python 3.12 or newer is required. Install from the repository:

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

## 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.

## License

The Python implementation is distributed under the [MIT License](https://github.com/eamontoyaa/unsatstab/blob/main/LICENSE). Its scientific foundations are cited in the [documentation](https://eamontoyaa.github.io/unsatstab/fundamentals/#references).

## Authors

- [Exneyder A. Montoya-Araque](https://www.researchgate.net/profile/Exneyder-A-Montoya-Araque)
- [Daniel F. Ruiz](https://www.researchgate.net/profile/Daniel-F-Ruiz-2)
- [Emanuel Castillo-Cardona](https://www.researchgate.net/profile/Emanuel-Castillo-Cardona)

Copyright © 2026 Exneyder A. Montoya-Araque, Daniel F. Ruiz, Emanuel Castillo-Cardona, Universidad EAFIT.
