Earth Engine dirancang agar Anda jarang perlu mengkhawatirkan proyeksi peta saat melakukan komputasi. Seperti halnya skala, proyeksi tempat komputasi dilakukan ditentukan berdasarkan "pull". Secara khusus, input diminta dalam proyeksi output. Output dapat ditentukan dari parameter fungsi (misalnya, crs), objek peta Editor Kode dan geemap (yang memiliki proyeksi mercator peta (EPSG:3857)), atau dengan panggilan reproject(). Saat Anda
menampilkan gambar di Editor Kode atau geemap, input diminta dalam
maps mercator. Pertimbangkan operasi berikut pada gambar MODIS, yang memiliki proyeksi sinusoidal:
Editor Kode (JavaScript)
// The input image has a SR-ORG:6974 (sinusoidal) projection. var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0); // Normalize the image and add it to the map. var rescaled = image.unitScale(-2000, 10000); var visParams = {min: 0.15, max: 0.7}; Map.addLayer(rescaled, visParams, 'Rescaled');
import ee import geemap.core as geemap
Colab (Python)
# The input image has a SR-ORG:6974 (sinusoidal) projection. image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0) # Normalize the image and add it to the map. rescaled = image.unitScale(-2000, 10000) vis_params = {'min': 0.15, 'max': 0.7} m = geemap.Map() m.add_layer(rescaled, vis_params, 'Rescaled') m
Urutan operasi untuk contoh kode ini digambarkan dalam Diagram 1. Perhatikan bahwa proyeksi input ditentukan oleh output, khususnya proyeksi maps mercator dari tampilan peta di Editor Kode. Proyeksi ini menyebar kembali melalui urutan operasi sehingga input diminta dalam mercator peta, pada skala yang ditentukan oleh tingkat zoom peta.
Di Earth Engine, proyeksi ditentukan oleh Sistem Referensi Koordinat (CRS atau parameter crs dari banyak metode). Anda dapat memeriksa proyeksi gambar dengan memanggil projection() pada gambar tersebut:
Editor Kode (JavaScript)
var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0); print('Projection, crs, and crs_transform:', image.projection()); print('Scale in meters:', image.projection().nominalScale());
import ee import geemap.core as geemap
Colab (Python)
image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0) display('Projection, crs, and crs_transform:', image.projection()) display('Scale in meters:', image.projection().nominalScale())
Perhatikan bahwa dengan memanggil nominalScale() pada ee.Projection yang ditampilkan
oleh projection(), Anda dapat menentukan resolusi native gambar. Resolusi
native adalah skala piksel nominal dalam meter dari tingkat terendah
piramida gambar. Karena setiap band gambar dapat memiliki skala dan/atau proyeksi yang berbeda, jika Anda memanggil projection() pada gambar dengan setidaknya satu band yang tidak memiliki proyeksi yang sama dengan yang lain, Anda mungkin akan melihat error seperti:
Proyeksi default
Kecuali jika Anda memerlukan komputasi terjadi dalam proyeksi tertentu, umumnya
tidak perlu menentukan proyeksi. Hanya untuk output yang ambigu, Earth Engine akan mengharuskan Anda menentukan proyeksi dan/atau skala. Ambiguitas dapat terjadi akibat
pengurangan ImageCollection image container yang berisi gambar dengan proyeksi yang berbeda
(yaitu membuat komposit). Gambar yang merupakan komposit atau mosaik gambar input dengan proyeksi yang berbeda akan memiliki proyeksi default, yaitu WGS84 dengan skala 1 derajat.
Jika proyeksi default ini tidak sesuai untuk analisis Anda (misalnya, terlalu kasar, atau Anda perlu mencegah artefak pengambilan sampel ulang dalam komputasi downstream seperti analisis medan), Anda dapat menetapkan default yang berbeda menggunakan image.setDefaultProjection(crs). Hal ini memastikan bahwa jika Earth Engine perlu memilih proyeksi untuk komputasi yang melibatkan gambar, Earth Engine akan menggunakan proyeksi yang ditentukan, bukan WGS84 pada skala 1 derajat.
Contoh:
Editor Kode (JavaScript)
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA'); var mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic(); print(mosaic.projection());
import ee import geemap.core as geemap
Colab (Python)
collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic() display(mosaic.projection())
Jika Anda mencoba menggunakan gambar seperti ini dalam komputasi, Anda mungkin melihat error seperti:
Umumnya, agregasi pada skala 1 derajat tidak diinginkan atau dimaksudkan, sehingga Earth Engine memberikan pengingat yang berguna ini untuk memberikan spesifikasi lengkap untuk output.
Pengguna sering kali merasa bingung dengan perilaku ini dan khawatir tentang informasi proyeksi yang "hilang", tetapi piksel sebenarnya tidak dihitung sampai diperlukan (pelajari lebih lanjut), dan pada saat itu, selalu ada proyeksi output yang menyertai permintaan yang menentukan cara menghitung komposit.
Dalam sebagian besar kasus penggunaan, tidak adanya proyeksi bukanlah masalah dan sebenarnya merupakan pengoptimalan yang berharga, karena memungkinkan pratinjau hasil pada tingkat zoom apa pun tanpa harus menunggu komputasi resolusi penuh selesai. Namun, ini berarti output dapat terlihat berbeda pada tingkat zoom yang berbeda.
Jika gambar tampilan yang dioptimalkan entah bagaimana tidak memadai, komputasi dalam proyeksi tertentu dapat dipaksakan dengan memproyeksikan ulang output seperti yang dijelaskan di bagian berikut.
Proyeksikan ulang
Anda dapat memaksa operasi dilakukan dalam proyeksi tertentu dengan metode reproject(). Penggunaan reproject() akan menghasilkan input
yang diminta dalam proyeksi yang ditentukan dalam panggilan reproject().
Komputasi dalam kode Anda sebelum panggilan reproject() akan dilakukan dalam proyeksi yang ditentukan. Misalnya, untuk memaksa komposit dibuat dalam proyeksi tertentu:
Editor Kode (JavaScript)
// Some projection that is suitable for your area of interest. var proj = ee.Projection(...); var output = collection.reduce(...).reproject(proj);
import ee import geemap.core as geemap
Colab (Python)
# Some projection that is suitable for your area of interest. proj = ee.Projection(...) output = collection.reduce(...).reproject(proj)
Beberapa kasus yang memerlukan proyeksi tetap meliputi:
- Menghitung gradien (misalnya,
ee.Terrain.gradientatauee.Terrain.slope). reduceResolution, untuk saat Anda ingin menggabungkan piksel resolusi lebih tinggi menjadi resolusi lebih rendah. (Pelajari lebih lanjut cara mengurangi resolusi).
Fungsi dalam paket ee.Terrain (misalnya, slope,
aspect, hillshade) menghitung nilai berdasarkan piksel
yang berdekatan dan sensitif terhadap artefak pengambilan sampel ulang yang muncul selama
proyeksi ulang. Jika proyeksi komputasi berbeda dengan proyeksi native DEM, pengambilan sampel ulang tetangga terdekat default dapat membuat pola buatan dalam output. Untuk hasil terbaik, lakukan analisis medan dalam proyeksi native DEM. Jika menggunakan
ImageCollection ubin DEM, buat mosaik dan gunakan
setDefaultProjection() dengan proyeksi native
koleksi untuk memastikan analisis berjalan pada petak yang benar, seperti yang dijelaskan
di bagian Proyeksi default.
Ada beberapa alasan mengapa Anda harus menghindari penggunaan reproject() kecuali jika
benar-benar diperlukan. Misalnya, Anda memproyeksikan ulang sesuatu dan menambahkannya ke
peta. Jika skala yang Anda tentukan dalam panggilan reproject() jauh lebih kecil
daripada tingkat zoom peta, Earth Engine akan meminta semua input dalam skala yang sangat kecil, pada cakupan spasial yang sangat luas. Hal ini dapat menyebabkan terlalu banyak data yang diminta sekaligus dan menyebabkan error.
Jika output akhir berada dalam proyeksi yang berbeda dari yang ditentukan dalam panggilan reproject(), hal ini akan menghasilkan proyeksi ulang lain. Ini adalah
alasan lain untuk berhati-hati dalam menggunakan reproject() dalam kode Anda. Pertimbangkan
contoh berikut, yang memaksa gambar MODIS untuk diproyeksikan ulang terlebih dahulu ke
WGS84, lalu diproyeksikan ulang ke
maps mercator untuk ditampilkan di peta Editor Kode:
Editor Kode (JavaScript)
// The input image has a SR-ORG:6974 (sinusoidal) projection. var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0); // Operations *before* the reproject call will be done in the projection // specified by reproject(). The output results in another reprojection. var reprojected = image .unitScale(-2000, 10000) .reproject('EPSG:4326', null, 500); Map.addLayer(reprojected, {min: 0.15, max: 0.7}, 'Reprojected');
import ee import geemap.core as geemap
Colab (Python)
# The input image has a SR-ORG:6974 (sinusoidal) projection. image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0) # Operations *before* the reproject call will be done in the projection # specified by reproject(). The output results in another reprojection. reprojected = image.unitScale(-2000, 10000).reproject('EPSG:4326', None, 500) m = geemap.Map() m.add_layer(reprojected, {'min': 0.15, 'max': 0.7}, 'Reprojected') m
Gambar 2 membuat diagram alur operasi yang sesuai dengan contoh proyeksi ulang sederhana ini. Perhatikan bahwa proyeksi ulang pertama bersifat eksplisit, seperti yang ditentukan dalam panggilan reproject(). Proyeksi ulang kedua bersifat implisit, dilakukan oleh Earth Engine secara otomatis untuk menampilkan hasilnya di peta. Perhatikan juga bahwa
informasi tentang proyeksi yang akan digunakan disebarkan kembali dari permintaan ke input.