Komputasi menggunakan Gambar

Setelah Anda mengetahui cara memuat dan menampilkan gambar, saatnya menerapkan komputasi ke gambar tersebut. Misalnya, Anda dapat menghitung kemiringan medan, dengan meneruskan citra elevasi SRTM ke metode slope dari paket ee.Terrain.

Editor Kode (JavaScript)

// Load the SRTM image.
var srtm = ee.Image('CGIAR/SRTM90_V4');

// Apply an algorithm to an image.
var slope = ee.Terrain.slope(srtm);

// Display the result.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.
Map.addLayer(slope, {min: 0, max :60}, 'slope');

Perhatikan bahwa dalam kode ee.Terrain.slope(srtm), gambar srtm disediakan sebagai argumen untuk algoritma kemiringan. Hasilnya akan terlihat seperti Gambar 3.

Tutorial_api_03_slope.png
Gambar 3. Gambar kemiringan.

Matematika gambar

Ada juga metode di class ee.Image yang dapat dipanggil pada objek gambar. Misalnya, Anda ingin melakukan penghitungan menggunakan band gambar (terkadang disebut penghitungan band atau aljabar peta). Misalnya, Anda mungkin tertarik dengan operasi trigonometri pada gambar aspek. Untuk melakukannya, konversikan terlebih dahulu gambar aspek ke radian, lalu panggil sin() pada gambar tersebut. Menggunakan kembali image srtm,

Editor Kode (JavaScript)

// Get the aspect (in degrees).
var aspect = ee.Terrain.aspect(srtm);

// Convert to radians, compute the sin of the aspect.
var sinImage = aspect.divide(180).multiply(Math.PI).sin();

// Display the result.
Map.addLayer(sinImage, {min: -1, max: 1}, 'sin');

Hasilnya akan terlihat seperti Gambar 4. Sebaiknya pelajari kode aspect.divide(180).multiply(Math.PI).sin() lebih lanjut. Dengan merangkai beberapa metode seperti ini, kode akan 'membagi aspek dengan 180, mengalikan hasilnya dengan π, dan terakhir mengambil sin'. Anda dapat melakukan operasi matematika yang kompleks pada gambar dengan menggabungkan metode dengan cara ini. Lihat dokumen Image untuk mengetahui daftar lengkap operasi matematika, add(), subtract(), multiply(), dll.

Tutorial_api_04_sin.png
Gambar 4. Sinus aspek medan.

Statistik gambar

Class operasi lain yang berguna pada gambar melibatkan penghitungan statistik piksel di region gambar, atau overlay raster-vektor. Untuk menghitung statistik di Earth Engine, gunakan reducer seperti yang direpresentasikan oleh class dalam paket ee.Reducer. Misalnya, Anda tertarik dengan rata-rata ketinggian di beberapa wilayah. Anda dapat menentukan region dengan menggambar poligon menggunakan alat gambar geometri. Untuk menggambar wilayah secara interaktif, dapatkan alat gambar poligon (), lalu digitalkan poligon di atas area yang diinginkan dan klik Exit setelah selesai. Perhatikan bahwa objek ee.Geometry yang dihasilkan akan otomatis diberi nama geometry dan ditambahkan sebagai impor di bagian atas skrip Anda. Ganti nama variabel tersebut menjadi 'polygon' dengan mengklik nama variabel di impor dan mengetik nama baru.

Selanjutnya, dapatkan nilai piksel rata-rata dalam poligon menggunakan kode berikut:

Editor Kode (JavaScript)

// Compute the mean elevation in the polygon.
var meanDict = srtm.reduceRegion({
  reducer: ee.Reducer.mean(),
  geometry: polygon,
  scale: 90
});

// Get the mean from the dictionary and print it.
var mean = meanDict.get('elevation');
print('Mean elevation', mean);

Ada beberapa hal yang perlu diperhatikan di sini. Pertama, perhatikan bahwa reduceRegion() adalah metode yang tersedia untuk objek Image (pelajari lebih lanjut cara mengurangi region di sini). Kedua, argumen metode disediakan dalam objek JavaScript yang diteruskan sebagai argumen tunggal. (Secara khusus, kunci objek adalah nama parameter metode. Nilainya adalah argumen untuk metode). Ketiga, parameter reducer menentukan jenis statistik yang akan dihitung dan parameter geometry menentukan region tempat statistik akan dihitung. Parameter scale adalah ukuran piksel dalam meter yang akan digunakan. Untuk menghindari ambiguitas, Anda harus selalu menentukan skala saat melakukan reduksi karena Earth Engine mungkin tidak dapat menentukan skala yang sesuai secara otomatis dari input. (Pelajari lebih lanjut skala di Earth Engine).

Terakhir, nilai yang ditampilkan dari reduceRegion() adalah kamus yang kuncinya adalah nama band dan nilainya adalah statistik piksel untuk band tersebut. Metode get() pada kamus menampilkan nilai yang sesuai dengan kunci yang diberikan sebagai argumen. Dalam hal ini, gambar srtm memiliki satu band, 'elevation', sehingga kode contoh mendapatkan statistik tersebut dari kamus dan mencetaknya.

Saat Anda menjalankan kode ini, jika Anda mendapatkan error yang terlihat seperti:

Jangan khawatir! Ada beberapa hal yang dapat Anda lakukan untuk mengatasi error tersebut. Metode reduceRegion() memiliki pemeriksaan untuk memastikan Anda mempertimbangkan apakah Anda benar-benar ingin menyertakan begitu banyak piksel dalam komputasi. Hal ini dimaksudkan untuk mencegah Anda melakukan hal konyol secara tidak sengaja, seperti mencoba menghitung rata-rata setiap piksel 1 meter di dunia (jangan lakukan itu). Untuk mengatasi error, tetapkan parameter bestEffort ke true dengan menambahkan bestEffort: true ke kamus parameter, atau tetapkan parameter maxPixels ke nilai yang lebih tinggi dari nilai default 10 juta piksel, atau keduanya. Jika bestEffort true, Earth Engine akan otomatis menghitung ulang skala sehingga maxPixels tidak terlampaui.

Digresi: Skala di Earth Engine

Pada contoh sebelumnya, scale ditetapkan ke resolusi native gambar SRTM. Anda dapat menemukan resolusi native gambar dengan:

Editor Kode (JavaScript)

var scale = srtm.projection().nominalScale();
print('SRTM scale in meters', scale);

Jika Anda menentukan skala yang lebih kecil dari resolusi native, Earth Engine akan dengan senang hati melakukan pengambilan sampel ulang pada gambar input menggunakan tetangga terdekat, lalu menyertakan semua piksel yang lebih kecil tersebut dalam komputasi. Jika Anda menetapkan skala yang lebih besar, Earth Engine akan menggunakan piksel input dari versi input gabungan (yaitu, mendapatkan piksel dari tingkat piramida gambar yang lebih tinggi). Pelajari lebih lanjut cara Earth Engine menangani skala dalam dokumen ini.

Sejauh ini, Anda telah menggunakan satu gambar dengan satu band. Di halaman berikutnya, Anda akan mempelajari gambar multi-band dan koleksi gambar.