匯入光柵資料

您可以使用資產管理工具指令列介面 (CLI),以 GeoTIFF 或 TFRecord 格式上傳圖片或其他經地理參照的光柵資料集。(如要進一步瞭解如何使用程式碼編輯器匯入向量,請參閱「匯入向量資料」一文)。

上傳圖片素材資源

GeoTIFF

您可以在程式碼編輯器中,將最多 10 GB 的 GeoTIFF 圖片檔案上傳至 Earth Engine 使用者資料夾。(如果是較大的檔案,請使用指令列上傳選項)。

如要使用程式碼編輯器上傳 GeoTIFF,請選取左上角的「Assets」分頁,按一下 按鈕,然後選取「Image upload」。Earth Engine 會顯示上傳對話方塊,應類似於圖 1 所示。按一下「SELECT」按鈕,然後前往本機檔案系統中的 GeoTIFF。

在使用者資料夾中為圖片指定適當的素材資源 ID (尚未存在的 ID)。如果您想將圖片上傳至現有資料夾或珍藏內容,請在素材資源 ID 前方加上資料夾或珍藏內容 ID,例如 projects/myproject/folder-or-collection-id/new-asset

按一下「上傳」開始上傳。

資產
圖 1. 素材資源管理工具圖片上傳對話方塊

開始上傳後,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 檔案上傳圖片,您必須擁有相關聯的混合器檔案,該檔案是在您匯出用於執行推論的圖像時產生。如要進一步瞭解 Mixer 檔案,請參閱匯出頁面。具體來說,您可以匯入匯出圖像的預測結果 (以圖片格式匯入),

  1. 將圖像匯出為一或多個 TFRecord 檔案。
  2. 對圖像 (即 model.predict()) 執行推論。
  3. model.predict() 的輸出內容寫入 TFRecord 檔案。預測結果應與您執行推論時相同順序匯出的圖片相同。您可以透過匯出作業產生的檔案名稱排序,強制執行順序。詳情請參閱大型檔案匯出部分
  4. 將 TFRecord 檔案和相關混合器上傳至 Earth Engine。

屬性編輯

請指定一或多個中繼資料屬性,以便編輯資產中繼資料。在「Properties」選單中,按一下「Add property」,即可定義屬性名稱和值 (圖 2)。值可以是字串或數字。請輸入不含引號的字串。如要將數字格式化為字串,請在數字前輸入單引號 (')。

根據預設,系統會新增 system:time_start 屬性,但不含任何值。Earth Engine 會在套用 ImageCollection 日期篩選器時使用這項屬性。輸入日期時,請使用圖 2 所示的格式,或是自 1970 年 1 月 1 日起算的毫秒數。(如要進一步瞭解 Earth Engine 中的時間戳記,請參閱詞彙解釋)。資產管理工具會將輸入的數字解讀為名為 system:time_startsystem:time_end 的屬性值,並將其格式化為日期。

按一下 圖示即可移除資源。

進階選項

在「進階」選單中,選擇資料的金字塔政策和遮罩模式。

金字塔原則可指定 Earth Engine 產生較低解析度圖片的方式。如要進一步瞭解 Earth Engine 如何處理多種解析度,請參閱縮放說明文件。請選擇「平均值」、「最小值」或「最大值」金字塔處理政策,以便將圖像金字塔的較低解析度層級計算為較高解析度像素的平均值、最小值或最大值。這是連續值圖片的適當選項。如果是分類 (例如土地覆蓋率) 或 QA 資料,請選擇「取樣」(左上方像素) 或「模式」(最常出現的值,如果沒有模式則為取樣) 金字塔疊加政策。

遮罩模式會指出上傳圖片的遮罩方式 (如果有)。如要指定無資料值,請選取「無資料值」並輸入值。上傳圖片時,系統會遮蓋含有這個值的像素。這個值會個別套用至圖片的每個頻帶。如要將圖片的最後一個頻帶做為其他圖片頻帶的遮罩,請選取「使用最後一個頻帶做為 Alpha 頻帶」。alpha 頻帶應為無符號 8 位元頻帶,其中 0 是遮罩 (完全透明) 資料,而 255 是完全不透明。

並排上傳

如要將單張圖片上傳為多個圖塊,並將每個圖塊儲存在不同的來源檔案中,請按一下「新增其他檔案」,將其他檔案新增至上傳內容。Earth Engine 會將圖塊合併,在使用者資料夾中建立單一圖片。

可上傳至圖片資產的檔案類型有幾項限制。請特別注意以下幾點:

  1. 圖片必須具有相同的頻帶數量、位元深度、投影、解析度和填充值。
  2. 每個檔案之間的偏移量必須是像素大小的整數倍數。
  3. 最終圖片會在圖塊間的空隙填入遮罩像素,因此圖塊應盡量相鄰,不要分散分布。圖片區域中空白區域占比超過 99% 的圖片將不會擷取。