Bien démarrer

Cette page rassemble le minimum nécessaire pour commencer rapidement avec floodsr. Pour plus de détails, consultez Guide d’utilisation. Pour les questions fréquentes, consultez FAQ. Pour une visite guidée interactive, consultez Tutoriel 1 : prise en main.

Qu’est-ce que floodsr ?

floodsr est un outil qui améliore la résolution des rasters de profondeur d’inondation. Autrement dit, un outil de super-résolution (SR), dans le langage des modèles. Il prend en entrée un raster de profondeur à basse résolution et reconstruit une sortie à plus haute résolution en utilisant le contexte du terrain (DEM).

Télécharger les données d’essai

Avant d’exécuter des commandes, il est pratique d’avoir quelques données sous la main. Si vous n’avez pas encore vos propres données, vous pouvez télécharger une tuile d’essai à partir du projet.

Pour un téléchargement manuel, ouvrez cette publication et téléchargez les fichiers dans votre répertoire de travail courant.

Sinon, les utilisateurs de bash avec curl peuvent exécuter :

curl -L -O https://github.com/cefect/floodsr/releases/download/v0.0.3/hires002_dem.tif -O https://github.com/cefect/floodsr/releases/download/v0.0.3/lowres032.tif

Utilisation

Voici une introduction rapide pour configurer un modèle et l’utiliser afin d’améliorer un raster d’inondation.

Installation

floodsr a été conçu comme un paquet Python d’abord pensé pour l’interface de ligne de commande (CLI), donc nous recommandons une installation avec pipx afin d’isoler l’environnement :

pipx install floodsr

Pour des instructions d’installation plus détaillées, consultez Installation. Après l’installation, voici une petite vérification rapide :

floodsr doctor

Configuration du modèle

floodsr expose actuellement à la fois un modèle d’apprentissage automatique téléchargé (ResUNet_16x_DEM) et un modèle intégré basé sur des règles (CostGrow_Terrain). Listez les versions de modèle disponibles avec :

floodsr models list

Pour le moteur d’apprentissage automatique, récupérez les poids une fois et réutilisez-les depuis le cache :

floodsr models fetch ResUNet_16x_DEM

CostGrow_Terrain ne nécessite pas de poids téléchargés, mais requiert l’installation étendue avec PCRaster. Consultez Installation si vous voulez utiliser ce modèle.

Vous êtes maintenant prêt à améliorer des rasters d’inondation!

Passer en haute résolution

L’outil principal de floodsr est la commande tohr, ou to high resolution, en anglais. Elle prend un raster d’aléa d’inondation à basse résolution et un DEM à haute résolution. Ce DEM haute résolution peut être spécifié comme fichier local ou récupéré depuis la source de données Mosaïque HRDEM (pour des lieux au Canada).

Pour passer en haute résolution en récupérant le DEM depuis la Mosaïque HRDEM, essayez :

floodsr tohr --in lowres032.tif --fetch-hrdem

Sinon, spécifiez votre propre fichier DEM local :

floodsr tohr --in lowres032.tif --dem hires002_dem.tif

Pour exécuter explicitement le modèle CostGrow intégré, utilisez la même commande avec une version de modèle :

floodsr tohr --in lowres032.tif --dem hires002_dem.tif --model-version CostGrow_Terrain

Pour plus de détails, consultez le Guide d’utilisation.