Les services de calcul de bassin versant
Sommaire
Service de traitement OGC:WPS Bassin Versant
Procédure 1 : Liste des configurations
Procédure 2 : Calcul de BV à partir de points et téléchargement des résultats
Procédure 3 : Calcul de BV à partir de points et récupération du WMS associé
Procédure 4 : Téléchargement de BV préalablement calculés
Service annexe d'affichage des données prétraitées
Couche du réseau hydrographique modélisé
Couche des bassins versants élémentaires
Pour votre information, une documentation plus complète est disponible sur ce repository GitHub, qui offre par ailleurs la possibilité de nous faire part d'éventuels problèmes ou souhaits d'évolutions (issues).
Avant toute chose, une petite vidéo illustrant l'utilisation de ces services depuis le client Web de démonstration, et surtout depuis QGIS (nécessite l'installation préalable du plugin QGIS WPS Client).
Service de traitement OGC:WPS Bassin Versant
http://reseau.eaufrance.fr/geotraitements/bassin-versant/services/wps/ows?
Les paragraphes suivants décrivent les différentes procédures mises en œuvre sur le calcul de bassins versants. Ces traitements spatiaux sont confectionnées sur la base d'un MNT (Modèle Numérique de Terrain) et éventuellement de données de référence fournissant le réseau hydrographique connu, le tout prétraité ; chaque prétraitement, associé à un choix de données d'entrée (MNT, réseau hydrographique) et d'algorithmie (types d'algorithmes et paramètres aux différentes étapes de prétraitement) donne une configuration distincte, sur la base de laquelle des calculs de bassins versants peuvent être demandés au service ici décrit.
Les procédures s’appuient sur les qualités sémantiques et géométriques des données d'entrée.
Procédure 1 : Liste des configurations (Identifier=sie:
getconfiglist
)
La procédure « sie:getconfiglist » (Voir le DescribeProcess) retourne la liste des configurations utilisables ensuite comme paramètre d'entrée pour la plupart des traitements. A appeler avant toute autre chose, à moins que l'on se satisfasse de la configuration par défaut.
Liste des paramètres d'exécution ( DataInputs
) :
Aucun
Liste des sorties disponibles ( RawDataOutput
) :
Identifiant | Définition |
result | Liste des configurations disponibles |
Procédure 2 : Calcul de BV à partir de points et téléchargement des résultats (Identifier=sie:pts2watershed
)
La procédure « sie:pts2watershed » (voir le DescribeProcess) lance le calcul d'un BV pour chaque point (exutoire) passé en entrée sur la base d'une configuration choisie (parmi celles renvoyées par la méthode getconfiglist), et retourne les résultats dans le format demandé (voir le DescribeProcess pour connaître les formats supportés). Derrière cette méthode, le point envoyé en entrée est ramené (snappé) sur le réseau hydrographique modélisé, en suivant la plus forte pente jusqu'à retrouver un tronçon.
Liste des paramètres d'exécution ( DataInputs
) :
Nom du paramètre | Nature | Définition |
compute_points | Obligatoire | Géométries des points à partir desquels calculer les BV. Ces géométries peuvent être exprimées dans plusieurs formats (listes des formats supportés dans le DescribeProcess de la méthode), certains pouvant embarquer le SRS, d'autre ne le pouvant pas |
input_EPSG | Facultatif | Code EPSG à attribuer aux géométries envoyées via le paramètre compute_point. A utiliser quasi exclusivement lorsque les géométries fournies ne stipulent pas par ailleurs leur SRS. Dans cette version du service, tout autre SRS que le 2154 (Lambert93) sera refusé et lèvera une erreur |
configuration_id | Obligatoire | Identifiant de la configuration à utiliser pour ce calcul (récupéré d'un appel préalable à getconfiglist) |
Liste des sorties disponibles ( RawDataOutput
) :
Identifiant | Définition |
result | Résultats de calcul au format demandé |
Liste des formats de sortie disponibles ( MimeType
) :
MimeType | Définition |
application/wfs-collection-1.0 |
Document XML - GML conforme au schéma WFS 1.0 |
application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 |
Document XML - GML conforme au schéma WFS 1.1 |
application/json |
Document GeoJSON |
application/zip |
Archive ZIP |
Procédure 3 : Calcul de BV à partir de points et récupération du WMS associé (Identifier=sie:pts2watershedtoken_and_wms
)
La procédure « sie:pts2watershedtoken_and_wms » (Voir le DescribeProcess) lance le calcul d'un BV pour chaque point (exutoire) passé en entrée sur la base d'une configuration choisie (parmi celles renvoyées par la méthode getconfiglist), mais ne retourne pas les résultats directement dans le flux de réponse. Retourne un jeton correspondant à ce calcul (pour réexploitation future) ainsi que les paramètres d'appel (URL et LayerName) d'un service WMS affichant ces résultats. Derrière cette méthode, le point envoyé en entrée est ramené (snappé) sur le réseau hydrographique modélisé, en suivant la plus forte pente jusqu'à retrouver un tronçon.
Liste des paramètres d'exécution ( DataInputs
) :
Nom du paramètre | Nature | Définition |
compute_points | Obligatoire | Géométries des points à partir desquels calculer les BV. Ces géométries peuvent être exprimées dans plusieurs formats (listes des formats supportés dans le DescribeProcess de la méthode), certains pouvant embarquer le SRS, d'autre ne le pouvant pas |
input_EPSG | Facultatif | Code EPSG à attribuer aux géométries envoyées via le paramètre compute_point. A utiliser quasi exclusivement lorsque les géométries fournies ne stipulent pas par ailleurs leur SRS. Dans cette version du service, tout autre SRS que le 2154 (Lambert93) sera refusé et lèvera une erreur |
configuration_id | Obligatoire | Identifiant de la configuration à utiliser pour ce calcul (récupéré d'un appel préalable à getconfiglist) |
Liste des sorties disponibles ( RawDataOutput
) :
Identifiant | Définition |
token | Identifiant du calcul / de la requête, à utiliser ensuite comme jeton pour appeler d'autres services par la suite (export...) |
wms_url | URL du serveur WMS/WFS à appeler par la suite pour afficher ou récupérer une représentation des BV calculés |
wms_layer | Nom de la couche du serveur WMS/WFS à appeler par la suite pour afficher ou récupérer une représentation des BV calculés |
A partir de ces 3 éléments, il est possible de composer par exemple une URL complète pour afficher les BV en question comme suit : <wms_url>?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap&LAYERS=<wms_layer>&TOKEN=<id>&...
Liste des formats de sortie disponibles ( MimeType
) :
MimeType | Définition |
application/wfs-collection-1.0 |
Document XML - GML conforme au schéma WFS 1.0 |
application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 |
Document XML - GML conforme au schéma WFS 1.1 |
application/json |
Document GeoJSON |
application/zip |
Archive ZIP |
Procédure 4 : Téléchargement de BV préalablement calculés (Identifier=sie:token2watershed
)
La procédure « sie:token2watershed » (Voir le DescribeProcess) permet de télécharger le résultat (ensemble de BV) d'une requête formulée précédemment en lui fournissant le jeton (obtenu lors de la requête initiale), et le format d'export choisi parmi ceux supportés (décrits dans le DescribeProcess).
Liste des paramètres d'exécution ( DataInputs
) :
Nom du paramètre | Nature | Définition |
token | Obligatoire | Identifiant d'un calcul / d'une requête exécutée précédemment, et dont on veut exporter les résultats |
Liste des sorties disponibles ( RawDataOutput
) :
Identifiant | Définition |
result | Résultats de la requête en question, au format demandé |
Liste des formats de sortie disponibles ( MimeType
) :
MimeType | Définition |
application/wfs-collection-1.0 |
Document XML - GML conforme au schéma WFS 1.0 |
application/wfs-collection-1.1 ou text/xml; subtype=wfs-collection/1.1 |
Document XML - GML conforme au schéma WFS 1.1 |
application/json |
Document GeoJSON |
application/zip |
Archive ZIP |
Service annexe d'affichage des données prétraitées
Ce service (OGC:WMS) permet d'afficher les données prétraitées servant de bases au calcul de bassins versants. Il est donc dépendant de la configuration (d'où le recours à un WMS paramétré).
Couche du réseau hydrographique modélisé
Cette couche permet d'afficher, pour une configuration donnée, le réseau hydrographique modélisé (flux d'accumulation), obtenu par prétraitement principalement du MNT pris en entrée.
- URL de base : http://mapsref.brgm.fr/wxs/rhf/simulation?
- Nom de la couche : reseau
- Paramètre configuration : CONFIG_ID (non standard OGC:WMS)
- Exemple d'appel GetMap : http://mapsref.brgm.fr/wxs/rhf/simulation?LAYERS=reseau&TRANSPARENT=true...
Couche des bassins versants élémentaires
Cette couche permet d'afficher, pour une configuration donnée, l'ensemble des bassins versants élémentaires précalculés.
- URL de base : http://mapsref.brgm.fr/wxs/rhf/bvelementaires?
- Nom de la couche : bv_elementaires
- Paramètre configuration : CONFIG_ID (non standard OGC:WMS)
- Exemple d'appel GetMap : http://mapsref.brgm.fr/wxs/rhf/bvelementaires?LAYERS=bv_elementaires&TRA...