evalhyd.vigicrues.read_obs_from_csv_hydroportail

read_obs_from_csv_hydroportail(csv_files)

Lire les fichiers au format CSV exportés de l’HydroPortail contenant les observations de débits et retourner sous forme de pandas.DataFrame.

Paramètres:

csv_files: list

La liste de fichiers au format CSV exportés de l’HydroPortail contenant les observations de débits.

Warning

Il est attendu que les noms de fichiers contiennent en préfixe le code entité (code site ou code station) suivi d’un caractère “underscore”, comme c’est le cas lors de l’export de données depuis l’HydroPortail. Ces préfixes sont utilisés pour remplir le niveau “entites” du multi-index de la dataframe retournée.

Retourne:

pandas.DataFrame

La structure de données contenant les observations de débits.

Exemples

Récupérer les observations de débits sous forme de dataframe :

>>> df = read_obs_from_csv_hydroportail(
...     ['data/K010002010_QmnJ(n=1_non-glissant).csv',
...      'data/K025302002_QmnJ(n=1_non-glissant).csv',
...      'data/K025801001_QmnJ(n=1_non-glissant).csv']
... )
>>> df
                          valeur
entite     date_validite
K010002010 2019-01-01       3430
           2019-01-02       3320
           2019-01-03       3030
           2019-01-04       2890
           2019-01-05       2800
...                          ...
K025801001 2019-12-27        623
           2019-12-28        563
           2019-12-29        505
           2019-12-30        450
           2019-12-31        416

[1095 rows x 1 columns]