Bạn có thể xuất hình ảnh từ Earth Engine ở định dạng GeoTIFF hoặc TFRecord. Xem Tham số cấu hình để biết thêm các tuỳ chọn đầu ra.
Thiết lập mẫu
Bắt đầu bằng cách xác định dữ liệu hình ảnh sẽ được xuất:
Trình soạn thảo mã (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])
Tiếp theo, hãy xác định các tham số phép chiếu sẽ được dùng trong các lần xuất sau. Chúng ta sử dụng tham số crs để chỉ định hệ toạ độ và tham số crsTransform để chỉ định chính xác lưới pixel. Tham số crsTransform là danh sách các tham số từ ma trận biến đổi affine theo thứ tự hàng chính [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. Điểm gốc của hình ảnh được xác định bằng các giá trị xTranslation và yTranslation, còn kích thước pixel của hình ảnh được xác định bằng các giá trị xScale và yScale. Xem ví dụ về ma trận affine.
Trình soạn thảo mã (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()
Đặt scale
Để nhanh hơn, bạn có thể chỉ định tham số scale và Earth Engine sẽ tính toán tham số crsTransform cho bạn. Tuy nhiên, việc chỉ đặt tỷ lệ của một hình ảnh sẽ không chỉ định gốc của phép chiếu và có thể dẫn đến việc hình ảnh bị dịch chuyển so với một hình ảnh khác có cùng kích thước pixel!
Lý do cho sự thay đổi tiềm năng này là tham số scale được dùng để điền các giá trị xScale và yScale của crsTransform, nhưng các giá trị xTranslation và yTranslation được tính toán sao cho nếu chúng được chia cho các giá trị xScale và yScale tương ứng thì số dư sẽ bằng 0. Các tham số này chỉ định một lưới pixel, trong đó gốc của phép chiếu nằm ở góc của một pixel. Quy ước này khác với các tham số dịch được một số nhà cung cấp dữ liệu sử dụng, trong đó sử dụng các lưới được bù trừ từ điểm gốc của phép chiếu. Ví dụ: Hình ảnh Landsat do USGS cung cấp sử dụng các tham số dịch chuyển lệch 1/2 pixel so với gốc của phép chiếu (độ lệch 15 m cho các dải 30 m), trong khi hình ảnh Sentinel-2 do ESA cung cấp sử dụng các tham số dịch chuyển được căn chỉnh với gốc của phép chiếu. Nếu crsTransform được chỉ định trong một lần xuất không khớp với crsTransform của hình ảnh gốc, thì các pixel đầu ra sẽ được lấy mẫu lại (theo mặc định là sử dụng lân cận gần nhất), khiến hình ảnh thu được bị dịch chuyển so với hình ảnh gốc.
Tóm lại, nếu bạn cần so khớp các pixel của hình ảnh đã xuất với một hình ảnh cụ thể, hãy nhớ sử dụng các tham số crs và crsTransform để kiểm soát toàn bộ lưới.
vào Drive
Để xuất hình ảnh sang tài khoản Drive, hãy dùng Export.image.toDrive(). Ví dụ: để xuất các phần của hình ảnh Landsat, hãy xác định một vùng cần xuất, sau đó gọi Export.image.toDrive():
Trình soạn thảo mã (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()
Khi mã này chạy, một tác vụ xuất sẽ được tạo trong thẻ Tasks (Tác vụ) của Trình soạn thảo mã. Nhấp vào nút Run (Chạy) bên cạnh tác vụ để bắt đầu. (Tìm hiểu thêm về Trình quản lý tác vụ trong phần Trình soạn thảo mã). Hình ảnh sẽ được tạo trong tài khoản Drive của bạn
với fileFormat được chỉ định.
vào Cloud Storage
Để xuất hình ảnh sang bộ chứa Google Cloud Storage, hãy sử dụng Export.image.toCloudStorage(). Để xuất hình ảnh Landsat trong ví dụ trước sang Cloud Storage thay vì Drive, hãy sử dụng:
Trình soạn thảo mã (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()
Tương tự như khi xuất sang Drive, hãy bắt đầu xuất từ thẻ Việc cần làm. Nếu bạn dự định đọc lại các tệp đã xuất vào Earth Engine (bằng ee.Image.loadGeoTIFF() hoặc bằng cách đăng ký các tệp đó dưới dạng tài sản được COG hỗ trợ), thì bộ chứa phải nằm ở một vị trí được hỗ trợ.
vào Tài sản
Để xuất hình ảnh sang một thành phần trong thư mục thành phần Earth Engine, hãy sử dụng Export.image.toAsset(). Để quản lý tài sản của bạn trên Earth Engine hoặc kiểm tra xem bạn đã sử dụng bao nhiêu hạn mức bộ nhớ, hãy dùng Trình quản lý tài sản. Ví dụ sau đây minh hoạ việc xuất các phần của hình ảnh Landsat bằng cách sử dụng các chính sách kim tự tháp khác nhau cho cùng một dải. Chính sách kim tự tháp cho biết cách Earth Engine tính toán các phiên bản có độ phân giải thấp hơn của tài sản. Tìm hiểu thêm về cách Earth Engine xử lý nhiều độ phân giải trong tài liệu về tỷ lệ.
Trình soạn thảo mã (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()
Bạn có thể cung cấp chính sách tạo kim tự tháp mặc định cho mọi dải không được chỉ định rõ ràng bằng cách sử dụng khoá '.default'. Bạn cũng có thể chỉ truyền khoá '.default'. Ví dụ: để đặt tất cả các dải thành chính sách kim tự tháp "mẫu" mặc định, hãy sử dụng {'.default': 'sample'}.
Thông số cấu hình
Hãy quan sát thấy từ điển của các tham số cấu hình được truyền đến Export.image bao gồm scale (tính bằng mét) và vùng xuất dưới dạng ee.Geometry. Hình ảnh được xuất sẽ bao phủ vùng được chỉ định bằng các pixel theo tỷ lệ được chỉ định. Nếu không được chỉ định rõ ràng, CRS của kết quả đầu ra sẽ được lấy từ
băng tần đầu tiên của hình ảnh cần xuất.
Bạn cũng có thể chỉ định dimensions, crs và/hoặc crsTransform của hình ảnh được xuất. Hãy xem bảng chú giải thuật ngữ để biết thêm thông tin về crs và crsTransform. Ví dụ: để có được một khối pixel được căn chỉnh chính xác với một nguồn dữ liệu khác, hãy chỉ định dimensions, crs và crsTransform.
Để lấy một khối pixel có kích thước được xác định trước (ví dụ: hình thu nhỏ 256x256) bao phủ một khu vực, hãy chỉ định dimensions và region.
Bạn có thể chỉ định định dạng đầu ra của hình ảnh (nếu đích đến không phải là toAsset()) bằng tham số fileFormat ('GeoTIFF' theo mặc định).
tham số formatOptions
Các tuỳ chọn cấu hình khác được đặt bằng tham số formatOptions. Tham số này phải là một từ điển được khoá bằng các tuỳ chọn định dạng khác, dành riêng cho từng fileFormat như mô tả dưới đây.
GeoTIFF
Cloud Optimized GeoTIFF (COG)
Để xuất GeoTIFF được tối ưu hoá cho đám mây (COG), hãy đặt khoá cloudOptimized thành true trong formatOptions. Tiếp tục ví dụ trước:
Trình soạn thảo mã (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()
Bạn có thể tải lại COG từ Cloud Storage vào Image hoặc đăng ký dưới dạng tài sản. Hãy xem
tổng quan về COG
để biết đầy đủ thông số kỹ thuật và các lựa chọn xuất.
Nodata
Chỉ định giá trị nodata của GeoTIFF bằng khoá noData trong tham số formatOptions. Ví dụ:
Trình soạn thảo mã (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()
Xin lưu ý rằng giá trị nodata phải nằm trong phạm vi hợp lệ cho PixelType của hình ảnh. Bạn có thể kiểm tra PixelType bằng cách in siêu dữ liệu hình ảnh và xem thuộc tính data_type của dải đầu tiên. Bạn cũng có thể đặt PixelType của hình ảnh bằng cách truyền dữ liệu đến một loại cụ thể, chẳng hạn như sử dụng các phương thức hình ảnh toShort() hoặc toInt().
TFRecord
Xem trang Định dạng dữ liệu TFRecord.
maxPixels
Tham số maxPixels nhằm ngăn chặn việc vô tình tạo ra các tệp xuất có kích thước quá lớn. Nếu giá trị mặc định quá thấp so với hình ảnh đầu ra dự kiến, bạn có thể tăng maxPixels. Ví dụ:
Export.image.toDrive({ image: landsat, description: 'maxPixelsExample', crs: projection.crs, crsTransform: projection.transform, region: geometry, maxPixels: 1e9 });
Xuất tệp lớn
Nếu hình ảnh đầu ra có kích thước lớn, thì hình ảnh đó sẽ được xuất dưới dạng nhiều tệp. Nếu bạn
xuất sang (các) tệp GeoTIFF, hình ảnh sẽ được chia thành các ô. Tên tệp của mỗi ô sẽ có dạng baseFilename-yMin-xMin, trong đó xMin và yMin là toạ độ của mỗi ô trong hộp giới hạn tổng thể của hình ảnh được xuất.
Nếu bạn xuất sang TFRecord, các tệp sẽ được thêm vào bằng -00000,
-00001,... -0000N cho các tệp N+1. Việc duy trì thứ tự này rất quan trọng nếu bạn dự định thực hiện suy luận trên các tệp và tải kết quả dự đoán lên lại Earth Engine dưới dạng hình ảnh. Hãy xem phần tải hình ảnh lên dưới dạng tệp TFRecord để biết thông tin chi tiết.
Xuất hình ảnh như trong Trình soạn thảo mã
Để xuất hình ảnh như được kết xuất trên màn hình trong Earth Engine, hãy tạo hình ảnh trực quan như minh hoạ trong phần Hình ảnh trực quan và phần Kết hợp và ghép mảnh. Vì Trình soạn thảo mã sử dụng CRS 'EPSG:3857', hãy chỉ định CRS 'EPSG:3857' trong quá trình xuất để nhận được hình ảnh có cùng phép chiếu như hình ảnh hiển thị trong bản đồ của Trình soạn thảo mã. Hãy xem phần định cấu hình xuất hình ảnh để biết thông tin chi tiết về cách chỉ định độ phân giải và hệ toạ độ của kết quả đầu ra.