Les services de calcul de bassin versant

Sommaire

 

Tutoriel d'utilisation

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


Tutoriel d'utilisation

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
ou
text/xml; subtype=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>&...

Exemple : http://mapsref.brgm.fr/wxs/rhf/bvruntime?LAYERS=bv_runtime&TRANSPARENT=true&VERSION=1.1.1&FORMAT=image%2Fpng&SERVICE=WMS&REQUEST=GetMap&STYLES=&EXCEPTIONS=application%2Fvnd.ogc.se_inimage&SRS=EPSG%3A2154&X=226591.3420795&Y=6776903.7971716&TOKEN=3007cc81-40fe-4ec4-8c19-046a97a5cbc5&BBOX=226026.45696787,6776616.7244099,226910.16482401,6777212.0365885&WIDTH=668&HEIGHT=450

 

Liste des formats de sortie disponibles ( MimeType ) :

 

MimeType Définition

application/wfs-collection-1.0
ou
text/xml; subtype=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
ou
text/xml; subtype=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.

 

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.

 

 

imprimerImprimer