Vous pouvez exporter des images depuis Earth Engine au format GeoTIFF ou TFRecord. Pour en savoir plus sur les options de sortie, consultez Paramètres de configuration.
Exemple de configuration
Commencez par définir les données d'image qui seront exportées :
Éditeur de code (JavaScript)
// Load a landsat image and select three bands. var landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515') .select(['B4', 'B3', 'B2']); // Create a geometry representing an export region. var geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236]);
import ee import geemap.core as geemap
Colab (Python)
# Load a landsat image and select three bands. landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515').select( ['B4', 'B3', 'B2'] ) # Create a geometry representing an export region. geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236])
Ensuite, définissez les paramètres de projection qui seront utilisés dans les exportations suivantes. Nous utilisons le paramètre crs pour spécifier le système de coordonnées et le paramètre crsTransform pour spécifier précisément la grille de pixels. Le paramètre crsTransform est une liste de paramètres d'une matrice de transformation affine dans l'ordre ligne-major [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. L'origine d'une image est définie par les valeurs xTranslation et yTranslation, et la taille en pixels de l'image est définie par les valeurs xScale et yScale. Consultez des exemples de matrices affines.
Éditeur de code (JavaScript)
// Retrieve the projection information from a band of the original image. // Call getInfo() on the projection to request a client-side object containing // the crs and transform information needed for the client-side Export function. var projection = landsat.select('B2').projection().getInfo();
import ee import geemap.core as geemap
Colab (Python)
# Retrieve the projection information from a band of the original image. # Call getInfo() on the projection to request a client-side object containing # the crs and transform information needed for the client-side Export function. projection = landsat.select('B2').projection().getInfo()
Configurer scale
Pour gagner du temps, vous pouvez spécifier un paramètre scale, et Earth Engine calculera un paramètre crsTransform pour vous. Cependant, le simple fait de définir l'échelle d'une image ne spécifie pas l'origine de la projection et peut entraîner un décalage de l'image par rapport à une autre image de même taille en pixels.
La raison de ce décalage potentiel est que le paramètre scale est utilisé pour renseigner les valeurs xScale et yScale de crsTransform, mais les valeurs xTranslation et yTranslation sont calculées de sorte que si elles sont divisées par les valeurs xScale et yScale correspondantes, le reste sera égal à zéro. Ces paramètres spécifient une grille de pixels où l'origine de la projection se trouve à l'angle d'un pixel. Cette convention diffère des paramètres de translation utilisés par certains fournisseurs de données, qui utilisent des grilles décalées par rapport à l'origine de la projection. Par exemple, les images Landsat fournies par l'USGS utilisent des paramètres de translation décalés d'un demi-pixel par rapport à l'origine de la projection (décalage de 15 m pour les bandes de 30 m), tandis que les images Sentinel-2 fournies par l'ESA utilisent des paramètres de translation alignés sur l'origine de la projection. Si les crsTransform spécifiés dans une exportation ne correspondent pas aux crsTransform de l'image d'origine, les pixels de sortie seront rééchantillonnés (en utilisant le plus proche voisin par défaut), ce qui entraînera un décalage de l'image obtenue par rapport à l'image d'origine.
En résumé, si vous devez faire correspondre les pixels de l'image exportée à une image spécifique, veillez à utiliser les paramètres crs et crsTransform pour contrôler entièrement la grille.
dans Drive
Pour exporter une image vers votre compte Drive, utilisez Export.image.toDrive(). Par exemple, pour exporter des parties d'une image Landsat, définissez une région à exporter, puis appelez Export.image.toDrive() :
Éditeur de code (JavaScript)
// Export the image, specifying the CRS, transform, and region. Export.image.toDrive({ image: landsat, description: 'imageToDriveExample_transform', crs: projection.crs, crsTransform: projection.transform, region: geometry });
import ee import geemap.core as geemap
Colab (Python)
# Export the image, specifying the CRS, transform, and region. task = ee.batch.Export.image.toDrive( image=landsat, description='imageToDriveExample_transform', crs=projection['crs'], crsTransform=projection['transform'], region=geometry, ) task.start()
Lorsque ce code est exécuté, une tâche d'exportation est créée dans l'onglet Tasks (Tâches) de l'éditeur de code. Cliquez sur le bouton Exécuter à côté de la tâche pour la lancer. (Pour en savoir plus sur le gestionnaire de tâches, consultez la section "Éditeur de code"). L'image sera créée dans votre compte Drive avec le fileFormat spécifié.
vers Cloud Storage
Pour exporter une image vers un bucket Google Cloud Storage, utilisez Export.image.toCloudStorage(). Pour exporter l'image Landsat de l'exemple précédent vers Cloud Storage au lieu de Drive, utilisez :
Éditeur de code (JavaScript)
// Export the image to Cloud Storage. Export.image.toCloudStorage({ image: landsat, description: 'imageToCloudExample', bucket: 'your-bucket-name', fileNamePrefix: 'exampleExport', crs: projection.crs, crsTransform: projection.transform, region: geometry });
import ee import geemap.core as geemap
Colab (Python)
# Export the image to Cloud Storage. task = ee.batch.Export.image.toCloudStorage( image=landsat, description='imageToCloudExample', bucket='your-bucket-name', fileNamePrefix='exampleExport', crs=projection['crs'], crsTransform=projection['transform'], region=geometry, ) task.start()
Comme pour les exportations vers Drive, lancez l'exportation depuis l'onglet Tâches. Si vous prévoyez de lire les fichiers exportés dans Earth Engine (avec ee.Image.loadGeoTIFF() ou en les enregistrant en tant qu'éléments COG), le bucket doit se trouver dans un emplacement compatible.
en élément
Pour exporter une image vers un asset dans votre dossier d'assets Earth Engine, utilisez Export.image.toAsset(). Pour gérer vos éléments Earth Engine ou vérifier la quantité de votre quota de stockage utilisée, utilisez le gestionnaire d'éléments. L'exemple suivant illustre l'exportation de parties d'une image Landsat à l'aide de différentes règles de pyramide pour la même bande. La règle de pyramide indique comment Earth Engine calcule les versions de l'élément à résolution inférieure. Pour en savoir plus sur la façon dont Earth Engine gère plusieurs résolutions, consultez la documentation sur l'échelle.
Éditeur de code (JavaScript)
// Get band 4 from the Landsat image, copy it. var band4 = landsat.select('B4').rename('b4_mean') .addBands(landsat.select('B4').rename('b4_sample')) .addBands(landsat.select('B4').rename('b4_max')); // Export the image to an Earth Engine asset. Export.image.toAsset({ image: band4, description: 'imageToAssetExample', assetId: 'exampleExport', crs: projection.crs, crsTransform: projection.transform, region: geometry, pyramidingPolicy: { 'b4_mean': 'mean', 'b4_sample': 'sample', 'b4_max': 'max' } });
import ee import geemap.core as geemap
Colab (Python)
# Get band 4 from the Landsat image, copy it. band_4 = ( landsat.select('B4') .rename('b4_mean') .addBands(landsat.select('B4').rename('b4_sample')) .addBands(landsat.select('B4').rename('b4_max')) ) # Export the image to an Earth Engine asset. task = ee.batch.Export.image.toAsset( image=band_4, description='imageToAssetExample', assetId='projects/your-project/assets/exampleExport', crs=projection['crs'], crsTransform=projection['transform'], region=geometry, pyramidingPolicy={ 'b4_mean': 'mean', 'b4_sample': 'sample', 'b4_max': 'max', }, ) task.start()
Vous pouvez fournir une règle de pyramide par défaut pour chaque bande qui n'est pas explicitement spécifiée à l'aide de la clé '.default'. Vous pouvez également ne transmettre que la clé '.default'. Par exemple, pour que toutes les bandes utilisent par défaut la règle de pyramide "sample", utilisez {'.default': 'sample'}.
Paramètres de configuration
Notez que le dictionnaire des paramètres de configuration transmis à Export.image inclut scale (en mètres) et la région d'exportation en tant qu'ee.Geometry. L'image exportée couvrira la région spécifiée avec des pixels à l'échelle spécifiée. S'il n'est pas explicitement spécifié, le CRS de la sortie sera extrait de la première bande de l'image à exporter.
Vous pouvez également spécifier les éléments dimensions, crs et/ou crsTransform de l'image exportée. Pour en savoir plus sur crs et crsTransform, consultez le glossaire. Par exemple, pour obtenir un bloc de pixels précisément aligné sur une autre source de données, spécifiez dimensions, crs et crsTransform.
Pour obtenir un bloc de pixels de taille prédéfinie (par exemple, une vignette de 256 x 256) qui couvre une région, spécifiez dimensions et region.
Vous pouvez spécifier le format de sortie de l'image (si la destination n'est pas toAsset()) avec le paramètre fileFormat ('GeoTIFF' par défaut).
Paramètre formatOptions
Les autres options de configuration sont définies avec le paramètre formatOptions, qui doit être un dictionnaire dont les clés sont d'autres options de format, spécifiques à chaque fileFormat, comme décrit ci-dessous.
GeoTIFF
Cloud Optimized GeoTIFF (COG)
Pour exporter un Cloud Optimized GeoTIFF (COG), définissez la clé cloudOptimized sur true dans formatOptions. Reprenons l'exemple précédent :
Éditeur de code (JavaScript)
// Export a cloud-optimized GeoTIFF. Export.image.toDrive({ image: landsat, description: 'imageToCOGeoTiffExample', crs: projection.crs, crsTransform: projection.transform, region: geometry, fileFormat: 'GeoTIFF', formatOptions: { cloudOptimized: true } });
import ee import geemap.core as geemap
Colab (Python)
# Export a cloud-optimized GeoTIFF. task = ee.batch.Export.image.toDrive( image=landsat, description='imageToCOGeoTiffExample', crs=projection['crs'], crsTransform=projection['transform'], region=geometry, fileFormat='GeoTIFF', formatOptions={'cloudOptimized': True}, ) task.start()
Les COG peuvent être rechargés depuis Cloud Storage dans un Image ou enregistrés en tant qu'éléments. Consultez la présentation des COG pour connaître toutes les spécifications et options d'exportation.
Nodata
Spécifiez la valeur nodata GeoTIFF à l'aide de la clé noData dans le paramètre formatOptions. Exemple :
Éditeur de code (JavaScript)
// Set a nodata value and replace masked pixels around the image edge with it. var noDataVal = -9999; landsat = landsat.unmask(noDataVal); Export.image.toDrive({ image: landsat, description: 'imageNoDataExample', crs: projection.crs, scale: 2000, // large scale for minimal demo region: landsat.geometry(), // full image bounds fileFormat: 'GeoTIFF', formatOptions: { noData: noDataVal, } });
import ee import geemap.core as geemap
Colab (Python)
# Set a nodata value and replace masked pixels around the image edge with it. no_data_val = -9999 landsat = landsat.unmask(no_data_val) task = ee.batch.Export.image.toDrive( image=landsat, description='imageNoDataExample', crs=projection['crs'], scale=2000, # large scale for minimal demo region=landsat.geometry(), # full image bounds fileFormat='GeoTIFF', formatOptions={'noData': no_data_val}, ) task.start()
Notez que la valeur nodata doit se situer dans la plage valide pour le PixelType de l'image. Vous pouvez vérifier PixelType en imprimant les métadonnées de l'image et en examinant la propriété data_type de la première bande. Vous pouvez également définir le PixelType de l'image en castant les données vers un type spécifique à l'aide des méthodes d'image toShort() ou toInt(), par exemple.
TFRecord
Consultez la page Format de données TFRecord.
maxPixels
Le paramètre maxPixels est destiné à empêcher la création accidentelle d'exportations très volumineuses. Si la valeur par défaut est trop faible pour l'image de sortie prévue, vous pouvez augmenter maxPixels. Exemple :
Export.image.toDrive({ image: landsat, description: 'maxPixelsExample', crs: projection.crs, crsTransform: projection.transform, region: geometry, maxPixels: 1e9 });
Exportations de fichiers volumineux
Si l'image de sortie est volumineuse, elle sera exportée sous forme de plusieurs fichiers. Si vous exportez vers un ou plusieurs fichiers GeoTIFF, l'image est divisée en tuiles. Le nom de fichier de chaque tuile sera au format baseFilename-yMin-xMin, où xMin et yMin sont les coordonnées de chaque tuile dans le cadre de délimitation global de l'image exportée.
Si vous exportez au format TFRecord, les fichiers seront ajoutés par -00000, -00001,... -0000N pour les fichiers N+1. Il est important de conserver cet ordre si vous avez l'intention d'effectuer une inférence sur les fichiers et d'importer les prédictions dans Earth Engine sous forme d'image. Pour en savoir plus, consultez Importer des images en tant que fichiers TFRecord.
Exporter des images telles qu'elles apparaissent dans l'éditeur de code
Pour exporter des images telles qu'elles s'affichent à l'écran dans Earth Engine, créez des images de visualisation comme indiqué dans les sections Images de visualisation et Composition et mosaïque. Étant donné que l'éditeur de code utilise le CRS 'EPSG:3857', spécifiez un CRS 'EPSG:3857' dans l'exportation pour obtenir une image dans la même projection que celle affichée dans la carte de l'éditeur de code. Pour en savoir plus sur la spécification de la résolution et du système de coordonnées de la sortie, consultez la section sur la configuration des exportations d'images.