pyspc.io.pyspcfile.read_PyspcFile

pyspc.io.pyspcfile.read_PyspcFile(dirname='.', filename=None, stations=None, varnames=None, simulations=None, runtimes=None, models=None, scens=None, uncerts=None, warning=False)[source]

Créer une instance Series à partir de données PyspcFile

Paramètres:

filename (str) – Fichier PyspcFile
warning (bool) – Afficher les avertissements ? défaut: False
dirname (str) – Répertoire des fichiers PyspcFile, si filename n’est pas défini
stations (list) – Identifiants des stations, si filename n’est pas défini
varnames (list) – Noms des variables, si filename n’est pas défini
simulations (list) – Nom des simulations
runtimes (list) – Instants de production de la prévision, si filename n’est pas défini
models (list) – Modèles de prévision, si filename n’est pas défini
scens (list) – Scénarios de prévision, si filename n’est pas défini
uncerts (list) – Incertitudes de prévision, si filename n’est pas défini

Renvoie:

series – Collection de séries de données

Type renvoyé:

pyspc.core.series.Series

Notes

Les colonnes ne contenant que des valeurs manquantes ne sont pas exportées

Exemples

>>> from datetime import datetime as dt
>>> from pyspc.io.pyspcfile import read_PyspcFile

Cas d’un fichier avec une seule série d’observation

>>> f = 'data/core/csv/K1321810_QH.txt'
>>> series = read_PyspcFile(filename=f)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = obs
*  NOMBRE DE SERIES     = 1
*  ----------------------------------
*  SERIE #1
*      - CODE    = K1321810
*      - VARNAME = QH
*      - META    = None
*************************************

Cas d’un fichier avec une seule série de simulation

>>> f = 'data/core/csv/K1321810_mohys_QH.txt'
>>> series = read_PyspcFile(filename=f)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = obs
*  NOMBRE DE SERIES     = 1
*  ----------------------------------
*  SERIE #1
*      - CODE    = K1321810
*      - VARNAME = QH
*      - META    = mohys
*************************************

Cas d’un fichier avec une seule série de prévision

>>> f = 'data/core/csv/K1251810_2018010412_2001_brut_QH.txt'
>>> series = read_PyspcFile(filename=f)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = fcst
*  NOMBRE DE SERIES     = 1
*  ----------------------------------
*  SERIE #1
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, brut, None
*************************************

Cas de plusieurs fichiers d’observation/simulation

>>> d = 'data/core/csv'
>>> s = 'K1321810'
>>> v = 'QH'
>>> sim = [None, 'mohys']
>>> series = read_PyspcFile(dirname=d, stations=s, varnames=v,
...                       simulations=sim)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = obs
*  NOMBRE DE SERIES     = 2
*  ----------------------------------
*  SERIE #1
*      - CODE    = K1321810
*      - VARNAME = QH
*      - META    = None
*  ----------------------------------
*  SERIE #2
*      - CODE    = K1321810
*      - VARNAME = QH
*      - META    = mohys
*************************************

Cas de plusieurs fichiers de prévisions

>>> d = 'data/core/csv'
>>> s = 'K1251810'
>>> v = 'QH'
>>> r = dt(2018, 1, 4, 12)
>>> m = ['2001', '2011']
>>> sc = ['brut', 'pilote']
>>> u = [None, '10', '50', '90']
>>> series = read_PyspcFile(dirname=d, stations=s, varnames=v,
...                       runtimes=r, models=m, scens=sc, uncerts=u)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = fcst
*  NOMBRE DE SERIES     = 8
*  ----------------------------------
*  SERIE #1
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, brut, None
*  ----------------------------------
*  SERIE #2
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, brut, 10
*  ----------------------------------
*  SERIE #3
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, brut, 50
*  ----------------------------------
*  SERIE #4
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, brut, 90
*  ----------------------------------
*  SERIE #5
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, pilote, 10
*  ----------------------------------
*  SERIE #6
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, pilote, 50
*  ----------------------------------
*  SERIE #7
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2001, pilote, 90
*  ----------------------------------
*  SERIE #8
*      - CODE    = K1251810
*      - VARNAME = QH
*      - META    = 2018-01-04 12:00:00, 2011, brut, None
*************************************

Cas d’un fichier avec plusieurs séries d’observation/simulation

>>> f = 'data/core/csv/LaLoireChadrac_plathynes_QH.txt'
>>> series = read_PyspcFile(filename=f)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = obs
*  NOMBRE DE SERIES     = 4
*  ----------------------------------
*  SERIE #1
*      - CODE    = LaLoireChadrac
*      - VARNAME = PH
*      - META    = None
*  ----------------------------------
*  SERIE #2
*      - CODE    = LaLoireChadrac
*      - VARNAME = QH
*      - META    = None
*  ----------------------------------
*  SERIE #3
*      - CODE    = LaLoireChadrac
*      - VARNAME = QH
*      - META    = plathynes
*  ----------------------------------
*  SERIE #4
*      - CODE    = LaLoireChadrac
*      - VARNAME = QH
*      - META    = pers
*************************************

Cas d’un fichier avec plusieurs séries de prévision

>>> f = 'data/core/csv/K0253030_2020061200_GR6J_QJ.txt'
>>> series = read_PyspcFile(filename=f)
>>> series
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = PyspcFile
*  TYPE DE COLLECTION   = fcst
*  NOMBRE DE SERIES     = 11
*  ----------------------------------
*  SERIE #1
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPcf, None
*  ----------------------------------
*  SERIE #2
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf1, None
*  ----------------------------------
*  SERIE #3
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf2, None
*  ----------------------------------
*  SERIE #4
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf3, None
*  ----------------------------------
*  SERIE #5
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf4, None
*  ----------------------------------
*  SERIE #6
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf5, None
*  ----------------------------------
*  SERIE #7
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf6, None
*  ----------------------------------
*  SERIE #8
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf7, None
*  ----------------------------------
*  SERIE #9
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf8, None
*  ----------------------------------
*  SERIE #10
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf9, None
*  ----------------------------------
*  SERIE #11
*      - CODE    = K0253030
*      - VARNAME = QJ
*      - META    = 2020-06-12 00:00:00, GR6J, CEPpf10, None
*************************************