deafrica_tools.waterbodies#

Chargement et traitement des données sur les étendues d’eau de DE Africa. Dernière modification : novembre 2023

Fonctions

display_time_series([wb_timeseries])

Affiche la série temporelle sous forme de graphique interactif

get_geohashes([bbox, crs])

Obtient tous les geohashes des étendues d'eau.

get_time_series([geohash, waterbody, ...])

Obtient la série temporelle pour une étendue d'eau.

get_water_quality_rankings([geohash, waterbody])

Obtient les classements annuels de la qualité de l'eau pour une étendue d'eau.

get_water_quality_summary([geohash, ...])

Obtient les résumés annuels de la qualité de l'eau pour une étendue d'eau.

get_waterbodies(bbox[, crs])

Obtient les polygones et les métadonnées pour plusieurs étendues d'eau par bbox.

get_waterbody(geohash)

Obtient le polygone et les métadonnées d'une étendue d'eau par geohash.

plot_last_valid_obs(waterbodies)

Trace les étendues d'eau en fonction de la valeur dans la colonne "last_valid_obs".
deafrica_tools.waterbodies.display_time_series(wb_timeseries: pandas.DataFrame = None) → None#

Affiche la série temporelle sous forme de graphique interactif

Paramètres:

wb_timeseries (pd.DataFrame) – Une série temporelle pour l’étendue d’eau.

Type renvoyé:

None

deafrica_tools.waterbodies.get_geohashes(bbox: tuple = None, crs: str = 'EPSG:4326') → list[str]#

Obtient tous les geohashes des étendues d’eau.

Paramètres:

  • bbox ((xmin, ymin, xmax, ymax)) – Boîte englobante optionnelle.

  • crs (str) – CRS optionnel pour la boîte englobante.

Renvoie:

Une liste de geohashes.

Type renvoyé:

[str]

deafrica_tools.waterbodies.get_time_series(geohash: str = None, waterbody: pandas.Series = None, start_date: str = '1984-01-01', end_date: str = '2026-10-06') → pandas.DataFrame#

Obtient la série chronologique pour un plan d’eau. Spécifiez soit une ligne GeoDataFrame, soit un geohash.

Paramètres:

  • geohash (str) – Le geohash/uid pour un plan d’eau dans DE Africa Water Bodies.

  • waterbody (pd.Series) – Une ligne d’un GeoDataFrame représentant un plan d’eau.

  • start_date (str) – Date de début de la plage temporelle pour filtrer la série chronologique.

  • end_date (str) – Date de fin de la plage temporelle pour filtrer la série chronologique.

Renvoie:

Une série temporelle pour l’étendue d’eau.

Type renvoyé:

pd.DataFrame

deafrica_tools.waterbodies.get_water_quality_rankings(geohash: str = None, waterbody: pandas.Series = None) → pandas.DataFrame#

Obtient les classements annuels de la qualité de l’eau pour un plan d’eau. Spécifiez soit une ligne GeoDataFrame, soit un geohash.

Paramètres:

  • geohash (str) – Le geohash/uid pour un plan d’eau dans DE Africa Water Bodies.

  • waterbody (pd.Series) – Une ligne d’un GeoDataFrame représentant un plan d’eau.

Renvoie:

Une série temporelle pour l’étendue d’eau.

Type renvoyé:

pd.DataFrame

deafrica_tools.waterbodies.get_water_quality_summary(geohash: str = None, waterbody: pandas.Series = None, start_date: str = '2000-01-01', end_date: str = '2026-10-06') → pandas.DataFrame#

Obtient les résumés annuels de la qualité de l’eau pour un plan d’eau. Spécifiez soit une ligne GeoDataFrame, soit un geohash.

Paramètres:

  • geohash (str) – Le geohash/uid pour un plan d’eau dans DE Africa Water Bodies.

  • waterbody (pd.Series) – Une ligne d’un GeoDataFrame représentant un plan d’eau.

  • start_date (str) – Date de début de la plage temporelle pour filtrer la série chronologique.

  • end_date (str) – Date de fin de la plage temporelle pour filtrer la série chronologique.

Renvoie:

Une série temporelle pour l’étendue d’eau.

Type renvoyé:

pd.DataFrame

deafrica_tools.waterbodies.get_waterbodies(bbox: tuple, crs: str = 'EPSG:4326') → geopandas.GeoDataFrame#

Obtient les polygones et les métadonnées pour plusieurs étendues d’eau par bbox.

Paramètres:

  • bbox ((xmin, ymin, xmax, ymax)) – Boîte englobante.

  • crs (str) – CRS optionnel pour la boîte englobante.

Renvoie:

Un GeoDataFrame avec les polygones et les métadonnées.

Type renvoyé:

gpd.GeoDataFrame

deafrica_tools.waterbodies.get_waterbody(geohash: str) → geopandas.GeoDataFrame#

Obtient le polygone et les métadonnées d’une étendue d’eau par geohash.

Paramètres:

geohash (str) – Le geohash/uid pour un plan d’eau dans DE Africa Water Bodies.

Renvoie:

Un GeoDataFrame avec le polygone.

Type renvoyé:

gpd.GeoDataFrame

deafrica_tools.waterbodies.plot_last_valid_obs(waterbodies: geopandas.GeoDataFrame)#

Tracer les plans d’eau en fonction de la valeur dans la colonne « last_valid_obs ». :param waterbodies: Plans d’eau à tracer :type waterbodies: gpd.GeoDataFrame