pyspc.io.vigicrues.read_Vigicrues

pyspc.io.vigicrues.read_Vigicrues(filename=None, datatype=None, codes=None)[source]

Créer une instance Reaches à partir d’un fichier au format geojson de Vigicrues

Paramètres:
  • filename (str) – Nom du fichier json de Vigicrues

  • datatype (str) – Type du fichier Vigicrues Voir pyspc.convention.vigicrues.DATATYPES

  • codes (list) – Liste des codes des entités

Renvoie:

  • - pyspc.core.reach.Reaches – Collection de tronçon de Vigicrues si datatype = “vigicrues_reach”

  • - pyspc.core.location.Locations – Collection de lieux de Vigicrues si datatype = “vigicrues_loc”

  • - pyspc.core.series.Series – Collection d’observation de Vigicrues si datatype = “vigicrues_obs”

  • - pyspc.core.series.Series – Collection de prévisions de Vigicrues si datatype = “vigicrues_fcst”

Exemples

Cas de tronçons de vigilance

>>> from pyspc.io.vigicrues import read_Vigicrues
>>> f = 'data/metadata/vigicrues/troncons.json'
>>> d = 'vigicrues_reach'
>>> content = read_Vigicrues(filename=f, datatype=d)
>>> content
*************************************
********* REACHES *******************
*************************************
*  NOM DE LA COLLECTION = Vigicrues
*  NOMBRE DE LIEUX      = 2
*  ----------------------------------
*  TRONCON #1
*      - CODE    = LC110
*  ----------------------------------
*  TRONCON #2
*      - CODE    = LC120
*************************************
>>> content['LC110']
*************************************
************ REACH ******************
*************************************
*  CODE TRONCON     = LC110
*  NOM TRONCON      = Haut bassin de la Loire
*  STATUT TRONCON   = 1
*  DATE STATUT      = 2018-09-22 07:50:00
*  NOMBRE DE LIEUX  = 0
*************************************

Cas de station de mesure

>>> f = 'data/metadata/vigicrues/K118001010_station.json'
>>> d = 'vigicrues_loc'
>>> content = read_Vigicrues(filename=f, datatype=d)
>>> content
*************************************
*********** LOCATIONS ***************
*************************************
*  NOM DE LA COLLECTION = Vigicrues
*  NOMBRE DE LIEUX      = 1
*  ----------------------------------
*  LIEU #1
*      - CODE    = K118001010
*************************************
>>> content['K118001010']
*************************************
*********** LOCATION ****************
*************************************
*  CODE LIEU        = K118001010
*  NOM LIEU         = Digoin [Pont canal]
*  NOM COMPLET LIEU = Digoin [Pont canal]
*  COURS D'EAU      = Loire
*  TYPE LIEU        = point
*  COORDONNEES X    =  775417.00 m
*  COORDONNEES Y    = 6598045.00 m
*  ALTITUDE LIEU    =      -1.00 m NGF
*  SURFACE LIEU     =      -1.00 km2
*  COMMUNES         = 71176
*  TRONCONS         = None
*************************************

Cas de séries de données observées

>>> f = 'data/data/vigicrues/K118001010_observation.json'
>>> d = 'vigicrues_obs'
>>> content = read_Vigicrues(filename=f, datatype=d)
>>> content
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = Vigicrues
*  TYPE DE COLLECTION   = obs
*  NOMBRE DE SERIES     = 1
*  ----------------------------------
*  SERIE #1
*      - CODE    = K118001010
*      - VARNAME = QI
*      - META    = None
*************************************
>>> content[('K118001010', 'QI', None)]
*************************************
*********** SERIE *******************
*************************************
*  NOM VARIABLE SPC     = QI
*  INTITULE VARIABLE    = Débit instantané
*  IDENTIFIANT          = K118001010
*  FOURNISSEUR          = Provider(name='Vigicrues')
*  NOM VARIABLE         = QI
*  UNITE                = m3/s
*  VALEUR MANQUANTE     = []
*  SERIE CONTINUE       = True
*  PAS DE TEMPS         = None
*  UNITE DE TEMPS       = None
*  FUSEAU HORAIRE       = UTC
*  PROFONDEUR SERIE     = 50
*  PREMIER PAS DE TEMPS = 2022-03-29 10:00:00
*  DERNIER PAS DE TEMPS = 2022-03-29 14:30:00
*************************************

Cas de séries de données prévues

>>> f = 'data/data/vigicrues/K118001010_prevision.json'
>>> d = 'vigicrues_fcst'
>>> content = read_Vigicrues(filename=f, datatype=d)
>>> content
*************************************
********** SERIES *******************
*************************************
*  NOM DE LA COLLECTION = Vigicrues
*  TYPE DE COLLECTION   = fcst
*  NOMBRE DE SERIES     = 3
*  ----------------------------------
*  SERIE #1
*      - CODE    = K118001010
*      - VARNAME = QI
*      - META    = 2022-03-29 12:06:52, Vigicrues, Released, 10
*  ----------------------------------
*  SERIE #2
*      - CODE    = K118001010
*      - VARNAME = QI
*      - META    = 2022-03-29 12:06:52, Vigicrues, Released, 50
*  ----------------------------------
*  SERIE #3
*      - CODE    = K118001010
*      - VARNAME = QI
*      - META    = 2022-03-29 12:06:52, Vigicrues, Released, 90
*************************************
>>> k = ('K118001010', 'QI',
...      (dt(2022, 3, 29, 12, 6, 52), 'Vigicrues', 'Released', '50'))
>>> content[k]
*************************************
*********** SERIE *******************
*************************************
*  NOM VARIABLE SPC     = QI
*  INTITULE VARIABLE    = Débit instantané
*  IDENTIFIANT          = K118001010_2022032912_Vigicrues_Released_50
*  FOURNISSEUR          = Provider(name='Vigicrues')
*  NOM VARIABLE         = QI
*  UNITE                = m3/s
*  VALEUR MANQUANTE     = []
*  SERIE CONTINUE       = True
*  PAS DE TEMPS         = None
*  UNITE DE TEMPS       = None
*  FUSEAU HORAIRE       = UTC
*  PROFONDEUR SERIE     = 9
*  PREMIER PAS DE TEMPS = 2022-03-29 15:00:00
*  DERNIER PAS DE TEMPS = 2022-03-29 23:00:00
*************************************