# Sen Hydro — Délimitation de Bassins Versants (Plugin QGIS)

**Auteur :** Adiouma FALL - Géo Sénégal 2026
**Basé sur :** l'API HTTP publique et gratuite [Global Watersheds](https://mghydro.com/watersheds/help.html#api) (mghydro.com), qui applique la méthode du package Python open-source [`delineator`](https://github.com/mheberger/delineator) (Matthew Heberger, licence MIT) sur les données MERIT-Hydro / HydroSHEDS.

## Fonctionnalité

Un clic sur la carte QGIS suffit pour délimiter automatiquement :
- le bassin versant en amont du point cliqué (l'exutoire),
- le réseau hydrographique associé,
- le point exutoire lui-même.

Les trois résultats sont chargés directement comme couches vectorielles dans le projet QGIS courant.

## Installation

1. Repérez votre dossier de plugins QGIS :
   - Windows : `C:\Users\<votre_nom>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\`
   - Linux/Mac : `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/`
2. Copiez-y le dossier `watershed_delineator` tel quel (ou utilisez QGIS > Extensions > Installer depuis un ZIP en pointant vers `watershed_delineator.zip`).
3. Dans QGIS : menu **Extensions > Gérer et installer les extensions > Installées**, cochez la case pour activer « Sen Hydro - Délimitation de Bassins Versants ».
4. L'icône apparaît dans la barre d'outils et dans le menu **Sen Hydro**.

Aucune dépendance Python supplémentaire n'est nécessaire (plus de `delineator`, `numpy`, `geopandas`, `rasterio`... à installer, ni de venv/environnement dédié) : le plugin appelle directement l'API Global Watersheds en HTTPS. **Une connexion internet est donc requise à chaque délimitation**, le calcul étant effectué côté serveur par mghydro.com plutôt que localement.

## Utilisation

1. Cliquez sur l'icône « Sen Hydro - Délimiter un bassin versant » dans la barre d'outils (ou activez-la depuis le menu **Sen Hydro**).
2. Cliquez n'importe où sur la carte : le point cliqué sera considéré comme l'exutoire.
3. Patientez pendant le calcul (généralement quelques secondes, selon la connexion et la taille du bassin).
4. Trois nouvelles couches apparaissent dans le projet : `Bassin versant`, `Réseau hydrographique`, `Exutoire`.

Si aucun bassin versant ne peut être calculé pour le point cliqué (par exemple un point situé en mer, ou hors du domaine de données MERIT-Hydro), un message l'indique clairement : essayez un point différent, de préférence sur ou près d'un cours d'eau.

## Licence

Ce plugin s'appuie sur l'API Global Watersheds (mghydro.com) et sur la méthode du package `delineator` (MIT License, Matthew Heberger) — citation : Heberger, M. *delineator.py: fast, accurate global watershed delineation using hybrid vector- and raster-based methods.* 2022. Le code du plugin lui-même est distribué librement par Adiouma FALL - Géo Sénégal 2026.
