deafrica_tools.app.imageexport#

Créer une carte interactive pour sélectionner l’imagerie satellite et exporter des fichiers image.

Fonctions

`export_image_app`(geopolygon, date, satellites)	Exporte les données satellite de Digital Earth Africa sous forme de fichier image en fonction de l'étendue et de la période sélectionnées en utilisant `select_region_app()`.
`select_region_app`(date, satellites[, size_limit])	Une application interactive qui permet à l'utilisateur de sélectionner une région sur une carte en utilisant l'imagerie de Sentinel-2 et Landsat.

deafrica_tools.app.imageexport.export_image_app(geopolygon, date, satellites, style='True colour', resolution=None, vmin=0, vmax=2000, percentile_stretch=None, power=None, image_proc_funcs=None, output_format='jpg', standardise_name=False)#

Exporte les données satellite de Digital Earth Africa sous forme de fichier image en fonction de l’étendue et de la période sélectionnées en utilisant select_region_app(). La fonction prend en charge les données Sentinel-2 et Landsat, créant des images en couleurs réelles et fausses couleurs.

Par défaut, les fichiers sont nommés en utilisant :

"<produit> - <AAAA-MM-JJ> - <site, état> - <description>.png"

Définissez standardise_name=True pour un nom lisible par machine :

"<produit>_<AAAA-MM-JJ>_<site-état>_<description>.png"

Dernière modification : septembre 2021

Paramètres:

geopolygon (datacube.utils.geometry object) – Un géopolygone datacube fournissant les limites spatiales utilisées pour charger les données satellite.
date (str) – La date exacte utilisée pour extraire l’imagerie (par ex. date=”1988-01-01”).
satellites (str) – Les données satellite à utiliser pour extraire l’imagerie. Les options suivantes sont prises en charge : 'Landsat-9' : données du satellite Landsat 9 'Landsat-8' : données du satellite Landsat 8 'Landsat-7' : données du satellite Landsat 7 'Landsat-5' : données du satellite Landsat 5 'Sentinel-2' : données de Sentinel-2A et Sentinel-2B 'Sentinel-2 geomedian' : données de la géomédiane annuelle Sentinel-2
style (str, optional) – Le style utilisé pour produire l’image. Deux options sont actuellement prises en charge : * 'True colour' : Crée une image en couleurs réelles utilisant les bandes satellite rouge, vert et bleu * 'False colour' : Crée une image en fausses couleurs utilisant les bandes satellite infrarouge à ondes courtes, infrarouge et vert. Les bandes spécifiques utilisées varient entre Landsat et Sentinel-2.
resolution (tuple, optional) – La résolution spatiale pour charger les données. Par défaut, l’outil définira automatiquement la meilleure résolution possible en fonction des satellites sélectionnés (c’est-à-dire 30 m pour Landsat, 10 m pour Sentinel-2). L’augmenter (par exemple à resolution=(-100, 100)) peut être utile pour charger de grandes étendues spatiales.
vmin (int or float) – Les valeurs de réflectance de surface minimale et maximale utilisées pour rogner l’imagerie résultante afin d’améliorer le contraste.
vmax (int or float) – Les valeurs de réflectance de surface minimale et maximale utilisées pour rogner l’imagerie résultante afin d’améliorer le contraste.
percentile_stretch (tuple of floats, optional) – Un tuple de deux nombres flottants (entre 0.00 et 1.00) qui peut être utilisé pour rogner l’imagerie en fonction de centiles afin d’obtenir un meilleur contrôle sur la luminosité et le contraste de l’image. La valeur par défaut est None ; (0.02, 0.98) est équivalent à robust=True. Si ce paramètre est utilisé, vmin et vmax n’auront aucun effet.
power (float, optional) – Élève l’imagerie à une puissance pour réduire les caractéristiques lumineuses et améliorer les caractéristiques sombres. Cela peut ajouter une définition supplémentaire sur les zones présentant des caractéristiques extrêmement lumineuses comme la neige, les plages ou les marais salants.
image_proc_funcs (list of funcs, optional) – Une liste optionnelle contenant des fonctions qui seront appliquées à l’image de sortie. Cela peut inclure des fonctions de traitement d’image telles que l’augmentation du contraste, le masquage flou, la saturation, etc. La fonction doit prendre ET retourner un numpy.ndarray avec la forme [y, x, bandes]. Si votre fonction a des paramètres, vous pouvez transmettre des valeurs personnalisées en utilisant une fonction lambda, par ex. : [lambda x: skimage.filters.unsharp_mask(x, radius=5, amount=0.2)]
output_format (str, optional) – Le format de fichier de sortie de l’image. Les options valides incluent 'jpg' et 'png'. Par défaut à 'jpg'.
standardise_name (bool, optional) – Indique s’il faut exporter le fichier image avec un nom de fichier lisible par machine (par ex. <produit>_<AAAA-MM-JJ>_<site-état>_<description>.png)

deafrica_tools.app.imageexport.select_region_app(date, satellites, size_limit=10000)#

Une application interactive qui permet à l’utilisateur de sélectionner une région sur une carte en utilisant l’imagerie de Sentinel-2 et Landsat. La sortie de cette fonction est utilisée comme entrée pour export_image_app() afin d’exporter des images satellite haute résolution.

Dernière modification : septembre 2021

Paramètres:

date (str) – La date exacte utilisée pour tracer l’imagerie sur la carte interactive (par ex. date='1988-01-01').
satellites (str) – Les données satellite à tracer sur la carte interactive. Les options suivantes sont prises en charge : 'Landsat-9' : données du satellite Landsat 9 'Landsat-8' : données du satellite Landsat 8 'Landsat-7' : données du satellite Landsat 7 'Landsat-5' : données du satellite Landsat 5 'Sentinel-2' : données de Sentinel-2A et Sentinel-2B 'Sentinel-2 geomedian' : données de la géomédiane annuelle Sentinel-2
size_limit (int, optional) – Une limite de taille optionnelle pour la sélection de zone en km². Par défaut à 10000 km².

Renvoie:

Un dictionnaire contenant –
- “geopolygon” (définissant la zone à partir de laquelle exporter l’imagerie),
- ”date” (date utilisée pour exporter l’imagerie), et
- ’satellites” (les satellites à partir desquels extraire l’imagerie).
Ceux-ci sont transmis à la fonction export_image_app() pour exporter l’image.