Download data
-----------------

En Région Wallonne, les données hydrométriques sont disponibles sur
un `site géré conjointement par le SPW-MI (DGO2) et le SPW-ARNE (DGO3) <https://hydrometrie.wallonie.be/>`_.

Pour télécharger les données, il est possible d'utiliser les webservices proposés par KIWIS. C'est das ce cadre
que le sub-package `hydrometry <autoapi/wolfhece/hydrometry/index.html>`_ a été développé. Il permet d'accéder
aux données hydrométriques de la Région Wallonne, de les télécharger et de les manipuler.

.. note::
    Exemple de téléchargement et d'affichage de données : `Jupyter Notebook <https://wolf.hece.uliege.be/_static/hydrometry/example_hydrometry.ipynb>`_

.. note::
    Pour utiliser les webservices, il est recommandé de disposer d'un compte utilisateur. Pour obtenir un compte,
    il est nécessaire de s'adresser au SPW-MI (DGO2) ou au SPW-ARNE (DGO3). Les stations accessibles dépendent des
    droits attribués à l'utilisateur.

    Certaines limites de téléchargement sont imposées par les services. Le paquet scindera automatiquement les
    requêtes afin de ne pas dépasser ces limites et reconstituera la chronique complète sur base de morceaux de données
    obtenus.

    Il est possible d'accéder au données via l'API ou une interface graphique.

Statistical analysis
--------------------

Sur base de chroniques hydrométriques, il est possible de réaliser différentes analyses statistiques classiques (courbe de débit classé,
recherche des événements de crue...). Le package `hydrometry` propose des classes et des outils pour réaliser ces analyses.

.. image:: _static/hydrometry/figure1.png
    :width: 600px
    :align: center

.. image:: _static/hydrometry/figure2.png
    :width: 600px
    :align: center

Extreme value analysis
----------------------

Il est également possible de procéder à une analyse des valeurs extrêmes:

- Sélection des valeurs maximales (annuelles ou par saison)
- Ajustement de lois de probabilité des valeurs extrêmes (2, 3 ou 4 paramètres)
- Comparaison de différentes lois de probabilité (critère AIC, AICc, BIC, RSS)
- Calcul des quantiles de retour et d'intervalles de confiance par bootstrap

.. image:: _static/hydrometry/eva.png
    :width: 600px
    :align: center

Exemple d'analyse des valeurs extrêmes

Répété pour différentes duréees, il est alors possible de calculer des hydrogrammes synthétiques mono-fréquence en
émettant des hypothèses sur la forme de montée et en ajustant la descente de l'hydrogramme.

.. image:: _static/hydrometry/hsmf.png
    :width: 600px
    :align: center

Exemple d'hydrogramme synthétique mono-fréquence

.. warning::
    Ces analyses demandent une certaine expertise et ne peuvent être réalisées sans une connaissance approfondie des
    données et des méthodes statistiques utilisées.

    Il est recommandé de consulter la littérature scientifique et de se former à ces méthodes avant de les utiliser.

    Des spécialistes sont disponibles aussi bien au SPW-MI (DGO2) qu'au SPW-ARNE (DGO3) pour vous aider dans ces analyses.