애셋 관리자 또는 명령줄 인터페이스 (CLI)를 사용하여 이미지 또는 기타 지리적 참조 래스터 데이터 세트를 GeoTIFF 또는 TFRecord 형식으로 업로드할 수 있습니다. 코드 편집기를 사용하여 벡터를 가져오는 방법에 관한 자세한 내용은 벡터 데이터 가져오기를 참고하세요.
이미지 애셋 업로드
GeoTIFF
Code Editor에서는 최대 10GB 크기의 GeoTIFF 이미지 파일을 Earth Engine 사용자 폴더에 업로드할 수 있습니다. 큰 파일의 경우 명령줄 업로드 옵션을 사용하세요.
Code Editor를 사용하여 GeoTIFF를 업로드하려면 왼쪽 상단의 '애셋' 탭을 선택하고 버튼을 클릭한 다음 이미지 업로드를 선택합니다. Earth Engine에 그림 1과 유사한 업로드 대화상자가 표시됩니다. SELECT 버튼을 클릭하고 로컬 파일 시스템의 GeoTIFF로 이동합니다.
사용자 폴더에서 이미지에 아직 존재하지 않는 적절한 애셋 ID를 지정합니다. 이미지를 기존 폴더 또는 컬렉션에 업로드하려면 확장 소재 ID 앞에 폴더 또는 컬렉션 ID(예: projects/myproject/folder-or-collection-id/new-asset)를 추가합니다.
업로드를 클릭하여 업로드를 시작합니다.
업로드를 시작하면 Code Editor 오른쪽에 있는 Tasks 탭에 'Asset ingestion'(애셋 처리) 작업이 표시됩니다. 작업 관리자의 작업 위로 마우스를 가져가면 ?가 표시됨 아이콘을 사용하여 업로드 상태를 확인할 수 있습니다. 업로드를 취소하려면 작업 옆에 있는 회전 아이콘 을 클릭합니다. 처리가 완료되면 저작물이 사용자 폴더에 아이콘과 함께 표시됩니다.
GeoTIFF 압축
GeoTIFF 파일은 DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP 또는 ZSTD로 압축할 수 있습니다.
대용량 파일을 업로드할 때 최적의 환경을 제공하기 위한 권장사항은 다음과 같습니다.
- 권장: ZSTD는 속도와 압축의 균형이 우수합니다.
- 권장하지 않음: LZMA는 압축률이 우수하지만 속도가 매우 느릴 수 있습니다.
- 압축되지 않은 파일: 파일 크기가 커지고 업로드 시간이 더 오래 걸립니다.
- 손실 압축 (예: JPEG): 픽셀 값을 변경할 수 있습니다. 무손실 압축 (예: 데이터에 미칠 수 있는 잠재적 영향을 파악하지 못한 경우 무손실 압축(예: DEFLATE, LZMA, LZW, ZSTD)을 사용하는 것이 좋습니다.
TFRecord
TFRecord 파일에서 이미지를 업로드하려면 추론을 실행한 이미지를 내보낼 때 생성된 연결된 믹서 파일이 있어야 합니다. 믹서 파일에 관한 자세한 내용은 내보내기 페이지를 참고하세요. 구체적으로는 내보낸 이미지에서 만든 예측을 이미지로 가져옵니다.
- 이미지를 하나 이상의 TFRecord 파일로 내보냅니다.
- 이미지 (예:
model.predict())에 대한 추론을 실행합니다. model.predict()의 출력을 TFRecord 파일에 씁니다. 예측은 추론을 실행한 이미지 내보내기와 동일한 순서여야 합니다. 내보내기에서 생성된 파일 이름을 정렬하여 순서를 적용할 수 있습니다. 자세한 내용은 대용량 파일 내보내기 섹션을 참고하세요.- TFRecord 파일과 연결된 믹서를 Earth Engine에 업로드합니다.
속성 수정
메타데이터 속성을 하나 이상 지정하여 저작물 메타데이터를 수정합니다. 속성 메뉴에서 속성 추가를 클릭하여 속성 이름과 값을 정의합니다 (그림 2). 값은 문자열 또는 숫자일 수 있습니다.
따옴표 없이 문자열을 입력합니다. 숫자를 문자열 형식으로 지정하려면 숫자 앞에 따옴표(')를 입력합니다.
기본적으로 system:time_start 속성은 값 없이 추가됩니다. 이 속성은 Earth Engine에서 ImageCollection 날짜 필터를 적용할 때 사용됩니다. 그림 2에 표시된 형식의 날짜 또는 1970년 1월 1일 이후 경과된 밀리초를 나타내는 숫자를 입력합니다. Earth Engine의 타임스탬프에 관한 자세한 내용은 용어집을 참고하세요.
Asset Manager는 system:time_start 또는 system:time_end라는 속성의 값으로 입력된 숫자를 밀리초로 해석하고 날짜 형식으로 지정합니다.
아이콘을 클릭하여 속성을 삭제합니다.
고급 옵션
고급 메뉴에서 데이터의 피라미드화 정책과 마스킹 모드를 선택합니다.
피라미드화 정책은 Earth Engine에서 이미지의 낮은 해상도 버전을 생성하는 방법을 지정합니다. 스케일 문서에서 Earth Engine이 여러 해상도를 처리하는 방법을 자세히 알아보세요. 'Mean', 'Min' 또는 'Max' 피라미딩 정책을 선택하여 이미지 피라미드의 낮은 해상도 수준을 더 높은 해상도 픽셀의 각 2x2 그룹의 평균, 최솟값 또는 최댓값으로 계산합니다. 연속 값 이미지에 적합한 옵션입니다. 카테고리 (예: 토지 피복) 또는 품질보증 데이터의 경우 '샘플' (왼쪽 상단 픽셀) 또는 '모드' (가장 자주 발생하는 값 또는 모드가 없는 경우 샘플) 피라미드화 정책을 선택합니다.
마스킹 모드는 업로드된 이미지가 마스킹되는 방식을 나타냅니다 (마스킹되는 경우). 무데이터 값을 지정하려면 '무데이터 값'을 선택하고 값을 입력합니다. 이 값이 있는 픽셀은 업로드된 이미지에서 마스킹됩니다. 이 값은 이미지의 모든 밴드에 개별적으로 적용됩니다. 이미지의 마지막 밴드를 다른 이미지 밴드의 마스크로 사용하려면 'Use last band as alpha band'를 선택합니다. 알파 범위는 부호 없는 8비트 범위여야 하며 여기서 0은 마스크 처리된 (완전히 투명한) 데이터이고 255는 완전히 불투명합니다.
타일 업로드
단일 이미지를 여러 타일로 업로드하려면(각 타일이 다른 소스 파일에 저장됨) 다른 파일 추가를 클릭하여 업로드에 파일을 추가합니다. Earth Engine은 타일을 결합하여 사용자 폴더에 단일 이미지를 만듭니다.
이미지 저작물에 업로드할 수 있는 파일 형식에는 몇 가지 제약사항이 있습니다. 특히 다음 항목이 중요합니다.
- 이미지의 밴드 수, 비트 심도, 투영, 해상도, 채우기 값이 동일해야 합니다.
- 한 파일에서 다음 파일로의 오프셋은 픽셀 크기의 정수 배수여야 합니다.
- 최종 이미지에서 카드 간의 간격은 마스크 처리된 픽셀로 채워지므로 카드가 서로 인접해 있고 드물게 퍼져 있지 않은 것이 좋습니다. 이미지 영역의 99% 이상을 차지하는 틈이 있는 이미지는 처리되지 않습니다.