Earth Engine에서 GeoTIFF 또는 TFRecord 형식으로 이미지를 내보낼 수 있습니다. 출력 옵션에 대한 자세한 내용은 구성 매개변수를 참조하세요.
설정 예시
먼저 내보낼 이미지 데이터를 정의합니다.
코드 편집기 (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])
다음으로 다음 내보내기에 사용될 투영 매개변수를 정의합니다. crs 매개변수를 사용하여 좌표계를 지정하고
crsTransform 매개변수를 사용하여 픽셀 그리드를 정확하게 지정합니다.
crsTransform 매개변수는 행 우선 순서
[xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]의 아핀 변환
행렬에서 가져온 매개변수 목록입니다. 이미지의 원점은 xTranslation 및 yTranslation 값으로 정의되고 이미지의 픽셀 크기는 xScale 및 yScale 값으로 정의됩니다. 아핀 행렬의
예를
참조하세요.
코드 편집기 (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()
scale 설정
바로가기로 scale 매개변수를 지정하면 Earth Engine에서 crsTransform 매개변수를 계산합니다. 하지만 이미지의 스케일을 설정하는 것만으로는 투영의 원점이 지정되지 않으며 픽셀 크기가 동일한 다른 이미지에 비해 이미지가 이동될 수 있습니다.
이동이 발생할 수 있는 이유는 scale 매개변수가 crsTransform의 xScale 및 yScale 값을 채우는 데 사용되지만 xTranslation 및 yTranslation 값은 해당 xScale 및 yScale 값으로 나누면 나머지가 0이 되도록 계산되기 때문입니다. 이러한 매개변수는 투영의 원점이 픽셀의 모서리에 있는 픽셀 그리드를 지정합니다. 이 규칙은 투영의 원점에서 오프셋된 그리드를 사용하는 일부 데이터 제공업체에서 사용하는 변환 매개변수와 다릅니다. 예를 들어 USGS에서 제공하는 Landsat 이미지는 투영의 원점에서 1/2픽셀 오프셋된 변환 매개변수 (30m 대역의 경우 15m 오프셋)를 사용하는 반면 ESA에서 제공하는 Sentinel-2 이미지는 투영의 원점과 정렬된 변환 매개변수를 사용합니다. 내보내기에 지정된 crsTransform이 원본 이미지의 crsTransform과 일치하지 않으면 출력 픽셀이 리샘플링됩니다 (기본적으로 최근접 이웃 사용). 이로 인해 결과 이미지가 원본 이미지에 비해 이동됩니다.
요약하자면 내보낸 이미지의 픽셀을 특정
이미지와 일치시켜야 하는 경우 그리드를 완전히 제어할 수 있도록 crs 및 crsTransform 매개변수를 사용해야 합니다.
Drive로
이미지를 Drive 계정으로 내보내려면 Export.image.toDrive()를 사용합니다. 예를 들어 Landsat 이미지의 일부를 내보내려면 내보낼 리전을 정의한 후 Export.image.toDrive()를 호출합니다.
코드 편집기 (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()
이 코드가 실행되면 코드 편집기 작업 탭에 내보내기 작업이 생성됩니다. 작업 옆에 있는 실행 버튼을 클릭하여 작업을 시작합니다. (코드 편집기
섹션에서 작업 관리자에 관해 자세히 알아보세요.) 이미지는 지정된 fileFormat으로 Drive 계정에 생성됩니다.
Cloud Storage로
이미지를 Google Cloud Storage 버킷으로 내보내려면 Export.image.toCloudStorage()를 사용합니다. 이전 예의 Landsat 이미지를 Drive 대신 Cloud Storage로 내보내려면 다음을 사용합니다.
코드 편집기 (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()
Drive로 내보내는 경우와 마찬가지로 작업 탭에서 내보내기를 시작합니다. Cloud Storage 버킷 위치는 성능 및 스토리지 비용에 영향을 미칠 수 있습니다. 자세한 내용은 위치 고려사항 에 관한 FAQ 항목을 참조하세요.
애셋으로
이미지를 Earth Engine 애셋 폴더의 애셋으로 내보내려면 Export.image.toAsset()을 사용합니다. Earth Engine 애셋을 관리하거나 사용 중인 스토리지 한도가 얼마나 되는지 확인하려면 애셋 관리자를 사용합니다. 다음 예에서는 동일한 대역에 다른 피라미드 정책을 사용하여 Landsat 이미지의 일부를 내보내는 방법을 보여줍니다. 피라미드 정책은 Earth Engine에서 애셋의 저해상도 버전을 계산하는 방법을 나타냅니다. Earth Engine에서 스케일 문서의 여러 해상도를 처리하는 방법을 자세히 알아보세요.
코드 편집기 (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()
`'.default'` 키를 사용하여 명시적으로 지정되지 않은 모든 대역에 기본 피라미드 정책을 제공할 수 있습니다.
'.default' 키만 전달할 수도 있습니다. 예를 들어 모든 대역을 기본적으로 'sample'
피라미드 정책으로 설정하려면 {'.default': 'sample'}을 사용합니다.
구성 매개변수
Export.image에 전달된 구성 매개변수의 딕셔너리에는 scale (미터) 및 내보내기 리전이 ee.Geometry로 포함되어 있습니다. 내보낸 이미지는 지정된 스케일의 픽셀로 지정된 리전을 포함합니다. 명시적으로 지정하지 않으면 출력의 CRS는 내보낼 이미지의 첫 번째 대역에서 가져옵니다.
내보낸 이미지의
dimensions, crs 또는 crsTransform을 지정할 수도 있습니다. 자세한 내용은 용어집을 참조하세요
crs 및 crsTransform에 관한 예를 들어 다른 데이터 소스와 정확히
정렬된 픽셀 블록을 가져오려면 dimensions, crs 및 crsTransform을 지정합니다.
리전을 포함하는 미리 정의된 크기의 픽셀 블록 (예: 256x256 썸네일 이미지)을 가져오려면 dimensions 및 region을 지정합니다.
대상 위치가 toAsset()이 아닌 경우
fileFormat 매개변수 ('GeoTIFF' (기본값))를 사용하여 이미지 출력 형식을 지정할 수 있습니다.
formatOptions 매개변수
다른 구성 옵션은 formatOptions 매개변수로 설정됩니다. 이 매개변수는 아래 설명된 대로 각 fileFormat에 고유한 다른 형식 옵션을 키로 사용하는 딕셔너리여야 합니다.
GeoTIFF
클라우드 최적화 GeoTIFF
클라우드 최적화 GeoTIFF를 내보내려면 클라우드 최적화 GeoTIFF를 내보내려면 formatOptions의 JavaScript
리터럴을 전달합니다. 여기서 cloudOptimized 키는
true로 설정됩니다. 이전 예시를 계속합니다.
코드 편집기 (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()
클라우드 최적화 GeoTIFF는 Cloud Storage에서 Image로 다시 로드하거나 애셋으로 등록할 수 있습니다. 전체 내보내기 사양 및 옵션은
클라우드 최적화 GeoTIFF (COG) 개요
를 참조하세요.
Nodata
formatOptions 매개변수 내에서 noData 키를 사용하여 GeoTIFF nodata 값을 지정합니다. 예를 들면 다음과 같습니다.
코드 편집기 (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()
nodata 값은 이미지의 PixelType에 유효한 범위 내에 있어야 합니다.
이미지 메타데이터를 출력하고
첫 번째 대역의 data_type 속성을 확인하여 PixelType을 확인할 수 있습니다. 예를 들어 이미지 메서드 toShort() 또는 toInt()를 사용하여 데이터를 특정 유형으로 변환하여 이미지의 PixelType을 설정할 수도 있습니다.
TFRecord
TFRecord 데이터 형식 페이지를 참조하세요.
maxPixels
maxPixels 매개변수는 실수로 매우 큰 내보내기가 생성되지 않도록 하기 위한 것입니다. 의도한 출력 이미지에 기본값이 너무 낮으면 maxPixels를 늘릴 수 있습니다. 예를 들면 다음과 같습니다.
Export.image.toDrive({ image: landsat, description: 'maxPixelsExample', crs: projection.crs, crsTransform: projection.transform, region: geometry, maxPixels: 1e9 });
대용량 파일 내보내기
출력 이미지가 크면 여러 파일로 내보내집니다. GeoTIFF로 내보내는 경우 이미지가 타일로 분할됩니다. 각 타일의 파일 이름은 baseFilename-yMin-xMin 형식입니다. 여기서 xMin 및 yMin는 내보낸 이미지의 전체 경계 상자 내에 있는 각 타일의 좌표입니다.
TFRecord로 내보내는 경우 파일에 N+1 파일의 경우 -00000, -00001,... -0000N이 추가됩니다. 파일에서 추론을 실행하고 예측을 이미지로 다시 Earth Engine에 업로드하려면 이 순서를 유지하는 것이 중요합니다. 자세한 내용은 TFRecord
파일로 이미지 업로드를 참조하세요.
코드 편집기에 표시된 대로 이미지 내보내기
Earth Engine에서 화면에 렌더링된 대로 이미지를 내보내려면 시각화
이미지 및 시각화
이미지 및 합성 및
모자이크 섹션에 설명된 대로 시각화
이미지를 만듭니다. 코드 편집기는
'EPSG:3857' CRS를 사용하므로 내보내기에서 'EPSG:3857' CRS를 지정하여 코드 편집기 지도에 표시된 것과 동일한 투영으로 이미지를 가져옵니다. 출력의 해상도 및 좌표계를 지정하는 방법에 관한 자세한 내용은 이미지 내보내기 구성 섹션을 참조하세요.