Nous informons les utilisateurs qu'une nouvelle version des produits fleuves pour Hydroweb est disponible. Cette version améliore le contenu et les métadonnées des fichiers.
Nous informons les utilisateurs que les noms de fichiers des produits fleuves ainsi que leur contenu ont évolué :
Les noms de fichier adoptent le format suivant :
R_nomdubassin_nomdufleuve_KMxxxx où xxxx correspond à la distance en km vers l'embouchure du bassin.
Les métadonnées ont été considérablement enrichies.
Les données ont également été améliorées :
| #COL 1 : DATE(YYYY-MM-DD) |
| #COL 2 : TIME(HH:MM) |
| #COL 3 : ORTHOMETRIC HEIGHT (M) OF WATER SURFACE AT REFERENCE POSITION |
| #COL 4 : ASSOCIATED UNCERTAINTY(M) |
D'autres colonnes contiennent des informations spécifiques sur les données d'entrée d'altimétrie qui peuvent être utiles aux utilisateurs experts.
Elles correspondent aux colonnes 2 à 5 des anciens formats de fichier.
Un exemple de fichier à télécharger se trouve ci-dessous.
R_AMAZONAS_XINGU_KM0256.csv
Pour se connecter au portail Web du Hydroweb, cliquer sur le lien « Se connecter ».
Une fenêtre d’authentification Théia s’affiche. Elle propose à l’utilisateur de saisir ses identifiants de connexion.
Une fois les identifiants saisis et validés, l’utilisateur est connecté au portail.
Pour bénéficier des fonctionnalités de téléchargement des produits HydroWeb, il est nécessaire de s’inscrire. Pour ce faire, cliquer sur le lien « S’inscrire».
Une fenêtre d’inscription Théia s’affiche. Saisir les informations du formulaire.
Une fois l’utilisateur inscrit, un mail de validation lui est envoyé.
La page d’accueil du portail Web du Hydroweb présente une mappemonde.
Elle contient plusieurs pastilles qui représentent la localisation géographique (longitude/latitude) des produits lacs et des produits rivières SV (Station Virtuelle).
Les lacs sont représentés par des pastilles de couleur « fushia ».
Les SV sont représentés par des pastilles de couleur « bleu ».
Les lacs et SV sont agrégés selon le niveau de zoom d'affichage de la carte. Les agrégations sont accompagnées du nombre de lacs et/ou SV agrégés.
Les agrégations mixtes (mélange de lac(s) et SV) sont représentées par des pastilles de couleur « orange ».
Remarque : un agrégat est une facilité graphique en vue de disposer de cartes lisibles. Il ne suit pas les frontières des bassins par exemple (c'est la combinaison d'une densité d'icônes, d'une échelle et d'une extension géographique, donc une entité dynamique).
Les produits lacs et SV sont affichés séparément, dans des tables, en dessous de la mappemonde.
La liste des lacs s'affiche dans le tableau « Produits lacs ».
La liste des SV s'affiche dans le tableau « Produits SV Fleuves ».
Une infobulle apparait quand le curseur de la souris passe sur une SV ou un lac et disparait quand le curseur s'éloigne.
Les informations affichées varient selon l'élément survolé
(lac, SV, agrégation de plusieurs produits).
Ci-dessous,
un récapitulatif des informations affichées selon
l’élément survolé :
|
Elément survolé |
Informations affichées |
|
Lac |
Nom du lac |
|
SV |
Nom SV |
|
Agrégation de produits lacs/SV |
Nombre de produits lacs |
La gestion de l’affichage des couches cartographique suivantes :
Bassins,
Fleuves,
Produits lacs et SV fleuves,
Traces de satellites:
Traces Envisat,
Traces Jason 2 / Jason 3,
Traces Sentinel 3A
Traces Sentinel 3B
s’effectue à partir de l’outil « Liste des couches» disponible dans la barre d’outils sous la mappemonde :
L’IHM du portail Web propose plusieurs modes de recherche des produits :
Une recherche, des produits HydroWeb par désignation sur la carte : clic sur un produit de la carte,
Une recherche par listes : liste déroulante des bassins, lacs et rivières,
Une recherche par bassin : sélection d’un bassin sur la carte,
Une recherche par zone géographique : tracé d’un rectangle délimiteur sur la carte.
Ces recherches sont exclusives (chacune opère indépendamment).
La sélection d’un produit (lac/SV) sur la mappemonde centre le produit sur la carte et l’affiche dans le tableau des résultats.
Un clic avec la souris sur une agrégation de plusieurs produits centre la carte sur les produits agrégés et les affiche dans les tableaux des résultats « Produits lacs », « Produits SV Fleuves ».
La recherche par liste s’effectue à partir de la liste déroulante suivante (sous la mappemonde, à droite) :
Elle contient la liste exhaustive des bassins, lacs et rivières.
La sélection d’un bassin, lac ou rivière exécute une recherche sur l’élément sélectionnée dans la liste.
Les résultats de la recherche sont affichés sur la mappemonde et dans les tableaux des résultats.
La barre d’outils sous la mappemonde propose un outil de
recherche par sélection géographique 
L’outil de « sélection géographique » s’active suite à un clic de souris dessus.
Une fois activé, l’utilisateur peut sélectionner une zone géographique sur la mappemonde.
La recherche s’effectue sur la zone géographique sélectionnée. Tous les produits lacs et SV de la zone s’affichent sur la carte et dans les tableaux des résultats « Produits lacs » et « Produits SV Fleuve ».
L’outil de sélection se désactive automatiquement une fois la recherche terminée.
La sélection d’un bassin sur la carte zoom sur le bassin et affiche les produits lacs et SVs sur la carte.
Les résultats de recherche sont également affichés dans les tableaux des résultats.
La barre d’outils, sous la mappemonde, propose un outil de configuration de la recherche par lacs/rivières ou par type de produit (tous/recherches/opérationnels) :
La barre d’outils, sous la mappemonde, propose un outil de sélection des cibles rivières
selon le mode de validation de la série temporelle de hauteur d'eau : InSitu / Expert / Automatique :
- InSitu désigne les produits donc la série temporelle a été validée par comparaison à des données InSitu
- Expert désigne les produits donc la série temporelle a été validée par des experts hydrologues
- Automatique désigne les produits donc la série temporelle a passé avec succès une série de tests automatiques
(ex : moins de 50% de cycles manquant, 3 cycles consécutifs maximum sans donnée de hauteur incertitude maximale inférieur à 1m)
L’accès aux fiches descriptives des produits HydroWeb se fait à partir des liens hypertextes situés dans les tables des résultats « Produits lacs » et « Produits SV Fleuves ».
La fiche d’un produit lac affiche les données suivantes, sous
forme de courbes :
Série temporelle de la hauteur d’eau,
Série temporelle de la surface,
Série temporelle de la variation du volume,
Courbes hypsométriques.
Les courbes sont affichées dynamiquement. Une courbe qui ne contient pas de données n’est pas affichée.
La fiche contient les informations suivantes :
nom du lac,
coordonnées (longitude, latitude),
bassin versant,
pays,
dates de début et de fin des mesures disponibles,
type de traitement,
Lien vers le site Web Hydrolare (« In situ data are available on the HYDROLARE database www.hydrolare.net »)
La fiche descriptive d’un produit SV affiche la série temporelle de la hauteur d’eau.
Elle contient les informations suivantes :
nom SV,
nom rivière/ Chaîne des affluents, soit l’arborescence des
affluents (à partir de la côte en remontant vers la station
virtuelle)
coordonnées,
bassin versant,
référence du géoïde,
valeur du géoïde,
date de mise à jour de la série temporelle de la SV,
type de traitement,
mode de diffusion,
mission spatiale, numéro de la trace,
Distance à la côte
corrections appliquées, retracker utilisé, biais
intermissions (à valider)
Un lien « Mon panier » est disponible sur chacune des pages du portail (bandeau du haut) d’un utilisateur authentifié. Il permet d’accéder au panier.
Figure 2 - Panier
Le panier contient les informations suivantes, pour chacun des produits du panier :
Nom du produit,
date de début,
date de fin
un lien de suppression du produit du panier
Pour ajouter un produit au panier, l’utilisateur a deux possibilités, soit par :
la page d’accueil du portail du Hydroweb :
l’utilisateur peut sélectionner les produits à partir des
tableaux des résultats « Produits lacs » et
« Produits SV Fleuves », et cliquer sur le bouton
« Ajouter au panier » qui se trouve en dessous.
Les produits ajoutés au panier sont sur la période totale de disponibilité des données.
la page descriptive d’un produit (bouton
) : l’utilisateur peut ajouter le produit au panier sur une période totale ou partielle (à partir du curseur temporelle ou champs de saisie « Date de début »/ « Date de fin »).
La suppression d’un produit du panier s’effectue à partir de l’écran « panier » (cf. §Visualiser le panier).
Chaque produit du panier (ligne) dispose d’un lien « Supprimer » pour être supprimé.
Les fonctionnalités de téléchargement, des produits HydroWeb, sont accessibles aux utilisateurs authentifiés et autorisés.
Il existe deux façons de télécharger les produits :
par le panier (Lien « Télécharger » disponible depuis le panier),
par la page descriptive d’un produit (
).
Le téléchargement des produits, depuis le panier, fournit un fichier archive « zip ». Ce dernier est composé d’un fichier de données par produit. Il contient aussi un fichier readme.txt contenant les conditions de licence associées aux produits, ainsi que des publications de référence.
La page descriptive des produits offre la possibilité de télécharger entièrement ou partiellement (sélection temporelle sur les dates de mesure) un produit (fichier de données) ou figures (fichiers images des séries temporelles, courbes hypsométrique).
La sélection temporelle d’un produit se fait à partir :
du curseur temporel,
des champs de saisie « Date de début » et
« Date de fin »
que l’on retrouve sur chacune des pages descriptives d’un
produit.
Figure 3 - Sélection temporelle d'un produit
Un utilisateur peut télécharger un produit HydroWeb seulement s’il a accepté les termes de licence.
Le premier téléchargement d’un produit/données HydroWeb affiche une fenêtre des conditions de licence :
Figure 4 - Termes de licence
Lien direct vers la licence pdf
Les fiches descriptives d’un produit proposent la sauvegarde
des figures (séries temporelles et/ou courbes hypsométriques)
affichées sur l’IHM. La sauvegarde s’effectue à partir du
bouton 
situé sur le coin droit en haut de chaque graphique.
L’IHM du Hydroweb propose deux langues aux
utilisateurs :
Français,
Anglais.
Le changement de langue s’effectue à partir des icônes 
(Français) et 
(Anglais) disponibles sur chacune des pages Web du
portail (dans le bandeau du haut).
Ce service est accessible sans authentification préalable et permet de télécharger des graphiques de séries temporelles relatifs à un ou plusieurs produits au format PNG.
L'URL du service d'accès aux quicklooks est le suivant: http://hydroweb.theia-land.fr/hydroweb/quicklook Il faut ajouter à cet URL un point d'interrogation « ? » suivi d'une ou plusieurs options présentées ci-après.
L'une des 2 options suivantes est obligatoire:
products: indique les produits dont on souhaite télécharger les quicklooks.
La requête retourne soit un quicklook au format PNG (si un seul produit est demandé), soit un fichier ZIP contenant
l'ensemble des quicklooks correspondant aux produits demandés.
On pourra indiquer:
la liste des références de produit (séparés par des virgules) dont on souhaite obtenir les quicklooks.
lakes, lakes_operational ou lakes_research: télécharger les quicklooks de tous les lacs, lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: télécharger les quicklooks de toutes les stations virtuelles, SV opérationnelles ou de type recherche
list: donne la liste des quicklooks disponibles par produit au format CSV. On pourra indiquer:
all: liste complète
lakes, lakes_operational ou lakes_research: liste uniquement les lacs, les lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: liste uniquement les stations virtuelles, les SV opérationnelles ou de type recherche
Les options suivantes sont facultatives:
sdate = date de début du tracé (au format YYYY-MM-DD)
edate = date de fin du tracé (au format YYYY-MM-DD)
lang = langue du graphique: fr (Français), en (Anglais), fr par défaut
type = type de graphique: height (hauteurs d'eau) ou area (surface) ou volume
ou hypso (hypsométrie), height par défaut. On ne peut télécharger qu’un seul type de quicklook par requête.
validation = critère de validation: expert, automatic ou insitu
Exemples:
Obtenir la liste des quicklooks disponibles pour les lacs opérationnels:
http://hydroweb.theia-land.fr/hydroweb/quicklook?list=lakes_operational
Télécharger le quicklook en Anglais des hauteurs d’eau de la SV R_AMAZONAS_MADEIRA_KM2570 sur les années 2018-2020
http://hydroweb.theia-land.fr/hydroweb/quicklook?products=R_AMAZONAS_MADEIRA_KM2570&sdate=2018-01-01&edate=2020-12-31&lang=en
Télécharger tous les quicklooks des données hypsométriques pour les lacs
http://hydroweb.theia-land.fr/hydroweb/quicklook?products=lakes&type=hypso
Télécharger les quicklooks des données de volume des lacs Uvs, Nasser et Malawi à partir de 2008
http://hydroweb.theia-land.fr/hydroweb/quicklook?products=L_uvs,L_nasser,L_malawi&type=volume&sdate=2008-01-01
Ce service permet de télécharger des données Hydroweb au format ASCII, JSON or CSV.
Il est nécessaire de télécharger une première fois les données manuellement (voir section 7.1) afin de signer l'acceptation des termes de la licence.
L'URL du service d'accès sécurisé aux données est le suivant: http://hydroweb.theia-land.fr/hydroweb/authdownload Il faut ajouter à cet URL un point d'interrogation « ? » suivi d'une ou plusieurs options présentées ci-après.
L'une des 2 options suivantes est obligatoire:
products: indique les produits dont on souhaite télécharger les données.
La requête retourne soit un fichier de données unique (si un seul produit est demandé), soit un fichier ZIP contenant
l'ensemble des données correspondant aux produits demandés (1 fichier par produit).
On pourra indiquer:
la liste des références de produit (séparés par des virgules).
lakes, lakes_operational ou lakes_research: télécharger les données de tous les lacs, lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: télécharger les données de toutes les stations virtuelles, SV opérationnelles ou de type recherche
list: donne la liste des produits disponibles au téléchargement au format CSV. On pourra indiquer:
all: liste complète
lakes, lakes_operational ou lakes_research: liste uniquement les lacs, les lacs opérationnels ou de type recherche
rivers, rivers_operational ou rivers_research: liste uniquement les stations virtuelles, les SV opérationnelles ou de type recherche
Si l’option list est indiquée dans la requête, le service authdownload est accessible sans authentification préalable.
Par contre, le téléchargement de données (via l’option products) ne pourra fonctionner qu'après s'être authentifié sur le site Hydroweb en cliquant sur le bouton "Se connecter" OU bien en saisissant ses identifiant/mot de passe directement dans l'URL comme suit:
http://hydroweb.theia-land.fr/hydroweb/authdownload?products=[...]&user=[...]&pwd=[...]
Autrement, un message d’erreur HTTP 500 s’affichera.
L'utilisateur doit avoir également signé la licence Theia qui est proposée lors d'une première inscription ou d'un premier téléchargement depuis le site web.
Les options suivantes sont facultatives:
sdate = date de début (au format YYYY-MM-DD)
edate = date de fin (au format YYYY-MM-DD)
user = login de l'utilisateur (adresse mail). A noter que cette option n'est pas indispensable si l'utilisateur s'est déjà authentifié sur le site web. Dans ce cas, le service authdownload est capable de retrouver la session active de la personne réalisant la requête.
pwd = mot de passe de l'utilisateur
format = format des fichiers de données: txt (format ASCII, c'est le format classique utilisé dans Hydroweb) ou csv ou json, txt par défaut.
validation = critère de validation: expert, automatic ou insitu
Exemples:
Obtenir la liste des données fleuves de type recherche disponibles:
http://hydroweb.theia-land.fr/hydroweb/authdownload?list=rivers_research
Télécharger la SV R_GARONNE_GARONNE_KM0001 au format CSV en utilisant ses identifiants Theia (XXX/YYY)
http://hydroweb.theia-land.fr/hydroweb/authdownload?products=R_GARONNE_GARONNE_KM0001&format=CSV&user=XXX&pwd=YYY
Télécharger (toujours en étant authentifié) tous les données lacs opérationnels au format JSON de l’année 2015
http://hydroweb.theia-land.fr/hydroweb/authdownload?products=lakes_operational&format=json&sdate=2015-01-01&edate=2015-12-31&user=xxx&pwd=xxx
Ce service est accessible sans authentification préalable et permet de rechercher et délivrer des métadonnées au format XML respectant la norme ISO 19115.
L'URL du service CSW d'accès aux métadonnées est le suivant:
http://hydroweb-csw.theia-land.fr
Il faut ajouter à cet URL un point d'interrogation « ? » suivi de divers paramètres dépendant de la requête souhaitée.
Les requêtes disponibles sont:
GetCapabilities: retourne des informations sur le serveur CSW ainsi que les requêtes disponibles
Exemple : http://hydroweb-csw.theia-land.fr?service=CSW&version=2.0.2&request=GetCapabilities
DescribeRecord: affiche des informations relatives aux standards utilisés par le catalogue ainsi que le schéma de métadonnée utilisé
Exemple : http://hydroweb-csw.theia-land.fr/?service=CSW&version=2.0.2&request=DescribeRecord
GetDomain: retourne des informations sur les valeurs possibles d’un descripteur
Exemple : http://hydroweb-csw.theia-land.fr/?service=CSW&version=2.0.2&request=GetDomain&propertyname=type
GetRecords: permet de réaliser des recherches de métadonnées dans le catalogue suivant différents critères de recherche
Exemple : recherche des métadonnées sur toutes les stations virtuelles de la Garonne
http://hydroweb-csw.theia-land.fr?service=CSW&version=2.0.2&request=GetRecords&elementsetname=full&typenames=csw:Record
&resulttype=results&q=garonne
GetRecordById: permet d’accéder aux métadonnées d’un produit à partir de sa référence
Exemple : http://hydroweb-csw.theia-land.fr/?service=CSW&version=2.0.2&request=GetRecordById&id=L_baikal
GetRepositoryItem: permet de déployer l’arborescence complète des métadonnées d’un produit à partir de sa référence
Exemple : http://hydroweb-csw.theia-land.fr/?service=CSW&version=2.0.2&request=GetRepositoryItem&id=L_baikal
Ce service permet de rechercher et délivrer des données et métadonnées aux format XML, CSV, Ascii, Json respectant le standard OGC / SOS (Sensor Observation Service).
L'URL du service SOS est le suivant :
http://hydroweb-sos.theia-land.fr/hysope
Il faut ajouter à cet URL le terme "/hysope" suivi d'un point d'interrogation « ? » suivi de divers paramètres dépendants de la requête souhaitée.
Les requêtes disponibles sont :
GetCapabilities : retourne des informations sur le serveur SOS, les requêtes disponibles et la liste des produits disponibles ansi que leurs propriétés observables.
Exemple : http://hydroweb-sos.theia-land.fr/hysope?request=getCapabilities&service=SOS
DescribeSensor : affiche les informations d'un produit.
Exemple : http://hydroweb-sos.theia-land.fr/hysope?request=describeSensor&procedure=R_AMAZONAS_MADEIRA_KM2570&outputFormat=text%2Fxml%3Bsubtype%3D%22sensorML%2F1.0.1%22&service=SOS&version=1.0.0
GetFeatureOfInterest : retourne des propriétés observables d'un produit.
Exemple : http://hydroweb-sos.theia-land.fr/hysope?request=getFeatureOfInterest&service=SOS&version=2.0.0&FeatureOfInterestId=L_albert
GetObservation : permet de télécharger des données dans le catalogue suivant différents critères de recherche.
Exemple (remplacer [USER] par votre login Theia et [XXXXX] par votre mot de passe) : http://hydroweb-sos.theia-land.fr/hysope?service=SOS&request=GetObservation&offering=temporary&procedure=R_GARONNE_AGOUT_KM0397&observedProperty=height&responseFormat=text/plain&version=1.0.0&user=[USER]&password=[XXXXX]
En cas de questions /problemes sur HYDROWEB, envoyer un mail au HelpDesk Mail HelpDesk En cas de questions /problemes sur la connexion utilisateur, merci d'envoyer un mail au HelpDesk SSO Theia Mail HelpDesk SSO THEIA
