deafrica_tools.coastal#

Analyses côtières sur les données de Digital Earth Africa.

Fonctions

get_coastlines(bbox[, crs, layer, drop_wms])

Obtenir les données des côtes DE Africa pour une boîte englobante fournie en utilisant WFS.

model_tides(*args, **kwargs)

pixel_tides(*args, **kwargs)

tidal_stats(*args, **kwargs)

tidal_tag(*args, **kwargs)

transect_distances(transects_gdf, lines_gdf)

Prendre un ensemble de transects (par ex. lignes d'étude de plage perpendiculaires au rivage), et déterminer la distance le long du transect jusqu'à chaque objet dans un ensemble de lignes (par ex. lignes de rivage).
deafrica_tools.coastal.get_coastlines(bbox: tuple, crs='EPSG:4326', layer='shorelines', drop_wms=True) → geopandas.GeoDataFrame#

Obtenir les données des côtes DE Africa pour une boîte englobante fournie en utilisant WFS.

Pour une description complète du jeu de données DE Africa Coastlines, veuillez vous référer à la description officielle du produit Digital Earth Africa :

Paramètres:

  • bbox ((xmin, ymin, xmax, ymax), or geopandas object) – Boîte englobante exprimée sous forme de tuple. Alternativement, une boîte englobante peut être automatiquement extraite en fournissant un geopandas.GeoDataFrame ou geopandas.GeoSeries.

  • crs (str, optional) – CRS optionnel pour la boîte englobante. Ceci est ignoré si bbox est fourni en tant qu’objet geopandas.

  • layer (str, optional) – Quelle couche DE Africa Coastlines charger. Les options incluent les vecteurs de ligne de rivage annuels (« shorelines ») et les points de statistiques de taux de changement (« statistics »). Par défaut à « shorelines ».

  • drop_wms (bool, optional) – Indique s’il faut supprimer les colonnes d’attributs spécifiques WMS des données. Ces colonnes sont utilisées pour visualiser le jeu de données sur DE Africa Maps, et ne sont probablement pas utiles pour l’analyse scientifique. Par défaut à True.

Renvoie:

Un GeoDataFrame contenant des caractéristiques de ligne de rivage ou de point et les métadonnées associées.

Type renvoyé:

gpd.GeoDataFrame

deafrica_tools.coastal.transect_distances(transects_gdf, lines_gdf, mode='distance')#

Prendre un ensemble de transects (par ex. lignes d’étude de plage perpendiculaires au rivage), et déterminer la distance le long du transect jusqu’à chaque objet dans un ensemble de lignes (par ex. lignes de rivage). Les distances sont mesurées dans le CRS des jeux de données d’entrée.

Pour les applications côtières, les transects doivent être tracés de la terre vers la mer (le premier point étant situé sur terre afin de servir de point de référence cohérent pour mesurer les distances).

Le calcul de la distance peut être effectué selon deux modes :

  • “distance” : Les distances sont mesurées depuis le début du transect jusqu’au point d’intersection avec chaque ligne. Tout transect intersectant une ligne plus d’une fois est ignoré. Ce mode est utile pour mesurer, par exemple, la distance par rapport au rivage au fil du temps à partir d’un point de départ cohérent.

  • “width” : Les distances sont mesurées entre la première et la dernière intersection entre un transect et chaque ligne. Tout transect n’intersectant une ligne qu’une seule fois est ignoré. Ce mode est utile pour mesurer, par exemple, la largeur d’une zone côtière étroite au fil du temps, comme le col d’une flèche littorale ou d’un tombolo.

Paramètres:

  • transects_gdf (geopandas.GeoDataFrame) – Un GeoDataFrame contenant une ou plusieurs lignes de profil vectorielles. La colonne d’index du GeoDataFrame sera utilisée pour nommer les lignes dans la table de distances en sortie.

  • lines_gdf (geopandas.GeoDataFrame) – Un GeoDataFrame contenant une ou plusieurs entités linéaires vectorielles qui intersectent les lignes de profil fournies à transects_gdf. La colonne d’index du GeoDataFrame sera utilisée pour nommer les colonnes dans la table de distances en sortie.

  • mode (string, optional) – Indique s’il faut utiliser le mode “distance” (pour mesurer les distances depuis le début d’un profil) ou le mode “width” (pour mesurer la largeur entre deux intersections de profil). Voir la docstring ci-dessus pour plus d’informations ; par défaut, “distance” est utilisé.

Renvoie:

distance_df – Un DataFrame contenant les mesures de distance pour chaque ligne de profil (lignes) et entité linéaire (colonnes).

Type renvoyé:

pandas.DataFrame