Możesz eksportować obrazy z Earth Engine w formacie GeoTIFF lub TFRecord. Więcej opcji wyjściowych znajdziesz w sekcji Parametry konfiguracji.
Przykładowa konfiguracja
Zacznij od zdefiniowania danych obrazu, które zostaną wyeksportowane:
Edytor kodu (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])
Następnie zdefiniuj parametry projekcji, które będą używane w kolejnych eksportach. Używamy parametru crs, aby określić układ współrzędnych, oraz parametru crsTransform, aby precyzyjnie określić siatkę pikseli. Parametr crsTransform to lista parametrów z macierzy przekształcenia afinicznego w kolejności wierszowej [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. Punkt początkowy obrazu jest określany przez wartości xTranslation i yTranslation, a rozmiar obrazu w pikselach – przez wartości xScale i yScale. Zobacz przykłady macierzy afinicznych.
Edytor kodu (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()
Ustawiam scale
Możesz też określić parametr scale, a Earth Engine obliczy dla Ciebie parametr crsTransform. Jednak samo ustawienie skali obrazu nie określa punktu początkowego projekcji i może spowodować, że obraz będzie przesunięty względem innego obrazu o tym samym rozmiarze piksela.
Przyczyną potencjalnego przesunięcia jest to, że parametr scale jest używany do wypełniania wartości xScale i yScale w crsTransform, ale wartości xTranslation i yTranslation są obliczane w taki sposób, że jeśli zostaną podzielone przez odpowiadające im wartości xScale i yScale, reszta będzie wynosić zero. Te parametry określają siatkę pikseli, w której początek projekcji znajduje się w rogu piksela. Ta konwencja różni się od parametrów translacji używanych przez niektórych dostawców danych, którzy korzystają z siatek przesuniętych względem punktu początkowego projekcji. Na przykład obrazy Landsat dostarczane przez USGS używają parametrów translacji, które są przesunięte o 1/2 piksela od początku projekcji (przesunięcie o 15 m w przypadku pasm 30 m), podczas gdy obrazy Sentinel-2 dostarczane przez ESA używają parametrów translacji, które są wyrównane z początkiem projekcji. Jeśli crsTransform określone w eksporcie nie pasują do crsTransform oryginalnego obrazu, piksele wyjściowe zostaną ponownie próbkowane (domyślnie przy użyciu najbliższego sąsiada), co spowoduje przesunięcie wynikowego obrazu względem oryginalnego.
Podsumowując, jeśli chcesz dopasować piksele wyeksportowanego obrazu do konkretnego obrazu, użyj parametrów crs i crsTransform, aby mieć pełną kontrolę nad siatką.
na Dysk
Aby wyeksportować obraz na konto Dysku, użyj Export.image.toDrive(). Na przykład aby wyeksportować fragmenty obrazu Landsat, zdefiniuj region do wyeksportowania, a następnie wywołaj Export.image.toDrive():
Edytor kodu (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()
Po uruchomieniu tego kodu na karcie Zadania w edytorze kodu zostanie utworzone zadanie eksportu. Kliknij przycisk Uruchom obok zadania, aby je rozpocząć. (więcej informacji o Menedżerze zadań znajdziesz w sekcji Edytor kodu). Obraz zostanie utworzony na Twoim koncie Dysku z określonym fileFormat.
do Cloud Storage
Aby wyeksportować obraz do zasobnika Cloud Storage Google Cloud Storage, użyj Export.image.toCloudStorage(). Aby wyeksportować obraz Landsat z poprzedniego przykładu do Cloud Storage zamiast na Dysk, użyj:
Edytor kodu (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()
Podobnie jak w przypadku eksportowania na Dysk, rozpocznij eksportowanie na karcie Zadania. Jeśli planujesz odczytać wyeksportowane pliki z powrotem w Earth Engine (za pomocą ee.Image.loadGeoTIFF() lub rejestrując je jako zasoby COG), zasobnik musi znajdować się w obsługiwanej lokalizacji.
na zasób
Aby wyeksportować obraz do zasobu w folderze zasobów Earth Engine, użyj Export.image.toAsset(). Aby zarządzać zasobami Earth Engine lub sprawdzić, ile limitu miejsca na dane jest wykorzystywane, użyj Menedżera zasobów. Poniższy przykład ilustruje eksportowanie fragmentów obrazu Landsat przy użyciu różnych zasad piramidy dla tego samego pasma. Zasada piramidy określa, jak Earth Engine oblicza wersje zasobu o niższej rozdzielczości. Więcej informacji o tym, jak Earth Engine obsługuje różne rozdzielczości, znajdziesz w dokumentacji dotyczącej skali.
Edytor kodu (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()
Możesz podać domyślną zasadę piramidyzacji dla każdego pasma, które nie jest wyraźnie określone, używając klucza '.default'. Możesz też przekazać tylko klucz '.default'. Aby na przykład ustawić dla wszystkich pasm domyślną zasadę piramidy „sample”, użyj {'.default': 'sample'}.
Parametry konfiguracji
Zwróć uwagę, że słownik parametrów konfiguracji przekazanych do Export.image zawiera scale (w metrach) i region eksportu jako ee.Geometry. Wyeksportowany obraz będzie obejmował określony region z pikselami w określonej skali. Jeśli nie zostanie to wyraźnie określone, CRS danych wyjściowych zostanie pobrany z pierwszego pasma obrazu, który ma zostać wyeksportowany.
Możesz też określić dimensions, crs lub crsTransform wyeksportowanego obrazu. Więcej informacji o crs i crsTransform znajdziesz w słowniczku. Aby na przykład uzyskać blok pikseli dokładnie dopasowany do innego źródła danych, określ dimensions, crs i crsTransform.
Aby uzyskać blok pikseli o wstępnie zdefiniowanym rozmiarze (np. miniaturę 256 x 256), który obejmuje dany region, określ parametry dimensions i region.
Możesz określić format wyjściowy obrazu (jeśli miejscem docelowym nie jest toAsset()) za pomocą parametru fileFormat (domyślnie 'GeoTIFF').
Parametr formatOptions
Inne opcje konfiguracji są ustawiane za pomocą parametru formatOptions, który powinien być słownikiem z kluczami odpowiadającymi innym opcjom formatu, specyficznymi dla każdego fileFormat, jak opisano poniżej.
GeoTIFF
Cloud Optimized GeoTIFF (COG)
Aby wyeksportować plik Cloud Optimized GeoTIFF (COG), ustaw klucz cloudOptimized na true w formatOptions. Nawiązując do poprzedniego przykładu:
Edytor kodu (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()
Pliki COG można ponownie wczytać z Cloud Storage do Image lub zarejestrować jako zasoby. Pełne specyfikacje i opcje eksportu znajdziesz w omówieniu COG.
Nodata
Określ wartość nodata GeoTIFF za pomocą klucza noData w parametrze formatOptions. Na przykład:
Edytor kodu (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()
Pamiętaj, że wartość nodata powinna mieścić się w prawidłowym zakresie dla PixelType obrazu. Możesz sprawdzić PixelType, drukując metadane obrazu i sprawdzając właściwość data_type pierwszego pasma. Możesz też ustawić PixelType obrazu, rzutując dane na określony typ za pomocą metod obrazu, takich jak toShort() lub toInt().
TFRecord
Zobacz stronę Format danych TFRecord.
maxPixels
Parametr maxPixels ma zapobiegać przypadkowemu tworzeniu bardzo dużych eksportów. Jeśli wartość domyślna jest zbyt niska dla zamierzonego obrazu wyjściowego, możesz zwiększyć wartość maxPixels. Na przykład:
Export.image.toDrive({ image: landsat, description: 'maxPixelsExample', crs: projection.crs, crsTransform: projection.transform, region: geometry, maxPixels: 1e9 });
Eksporty dużych plików
Jeśli obraz wyjściowy jest duży, zostanie wyeksportowany jako kilka plików. Jeśli eksportujesz do plików GeoTIFF, obraz jest dzielony na kafelki. Nazwa pliku każdego kafelka będzie miała postać baseFilename-yMin-xMin, gdzie xMin i yMin to współrzędne każdego kafelka w ogólnej ramce ograniczającej wyeksportowanego obrazu.
Jeśli eksportujesz do TFRecord, do plików zostaną dołączone rozszerzenia -00000, -00001,... -0000N dla N+1 plików. Zachowanie tej kolejności jest ważne, jeśli zamierzasz przeprowadzić wnioskowanie na plikach i przesłać prognozy z powrotem do Earth Engine jako obraz. Szczegółowe informacje znajdziesz w artykule o przesyłaniu obrazów jako plików TFRecord.
Eksportowanie obrazów w postaci, w jakiej są wyświetlane w edytorze kodu
Aby wyeksportować zdjęcia wyrenderowane na ekranie w Earth Engine, utwórz obrazy wizualizacji, jak pokazano w sekcjach Obrazy wizualizacji oraz Komponowanie i tworzenie mozaiki. Ponieważ edytor kodu używa układu współrzędnych 'EPSG:3857', podczas eksportowania określ układ współrzędnych 'EPSG:3857', aby uzyskać obraz w tym samym odwzorowaniu co obraz wyświetlany na mapie edytora kodu. Szczegółowe informacje o określaniu rozdzielczości i układu współrzędnych danych wyjściowych znajdziesz w sekcji dotyczącej konfigurowania eksportu obrazów.