WigglyRivers is a Python package for characterizing the multiscale nature of river transects and identifying individual meandering features using wavelet-based methods. The package provides both supervised and unsupervised meander identification tools.
Key Features
- Wavelet-based analysis of river transects
- Support for both synthetic and natural river analysis
- Integration with High-Resolution National Hydrography Dataset (NHDPlus HR)
- Interactive supervised river identification with satellite imagery support
- Multiscale characterization of meandering features
- Support for Kinoshita-type curves and meanderpy integration
Requirements
- Python ≥3.10
- Core dependencies: geopandas, h5py, statsmodels, plotly, anytree
- Optional: meanderpy (for synthetic river examples)
Installation
bash
pip install WigglyRivers
For optimal installation, we recommend using conda to install geopandas first:
bash
conda install -c conda-forge geopandas
conda install -c conda-forge h5py
pip install WigglyRivers
Documentation
- Examples and tutorials are available at: https://github.com/gomezvelezlab/WigglyRivers
- NHD capability tutorial: https://drive.google.com/file/d/1LxUsNX8w74yv7fj-zl2lByl01Wuytxvm/view?usp=sharing
Citation
If you use this package, please cite:
Gonzalez-Duque, D., & Gomez-Velez, J. D. (2025). WigglyRivers: A tool to characterize the multiscale nature of meandering channels. Environmental Modelling & Software, 106423. <https://doi.org/10.1016/j.envsoft.2025.106423>
Authors
- Daniel Gonzalez-Duque (gonzalezduque.1osu.edu)
- Jesus Gomez-Velez (gomezvelezjdornl.gov)
License