Ringkasan Gambar

Logo Colab Jalankan di Google Colab Logo GitHub Lihat sumber di GitHub

Seperti yang disebutkan dalam dokumen Mulai, data raster ditampilkan sebagai objek Image di Earth Engine. Gambar terdiri dari satu atau beberapa band dan setiap band memiliki nama, jenis data, skala, mask, dan proyeksi sendiri. Setiap gambar memiliki metadata yang disimpan sebagai serangkaian properti.

Konstruktor ee.Image

Gambar dapat dimuat dengan menempelkan ID aset Earth Engine ke konstruktor ee.Image. Anda dapat menemukan ID gambar di katalog data. Misalnya, ke model elevasi digital (NASADEM):

Editor Kode (JavaScript)

var loadedImage = ee.Image('NASA/NASADEM_HGT/001');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

loaded_image = ee.Image('NASA/NASADEM_HGT/001')

Perhatikan bahwa menemukan gambar melalui alat penelusuran Editor Kode adalah sama. Saat Anda mengimpor aset, kode pembuatan gambar akan ditulis untuk Anda di bagian impor Code Editor. Anda juga dapat menggunakan ID aset pribadi sebagai argumen untuk konstruktor ee.Image.

Mendapatkan ee.Image dari ee.ImageCollection

Cara standar untuk mendapatkan gambar dari koleksi adalah dengan memfilter koleksi, dengan filter dalam urutan penurunan spesifisitas. Misalnya, untuk mendapatkan gambar dari koleksi reflektansi permukaan Sentinel-2:

Editor Kode (JavaScript)

var first = ee.ImageCollection('COPERNICUS/S2_SR')
                .filterBounds(ee.Geometry.Point(-70.48, 43.3631))
                .filterDate('2019-01-01', '2019-12-31')
                .sort('CLOUDY_PIXEL_PERCENTAGE')
                .first();
Map.centerObject(first, 11);
Map.addLayer(first, {bands: ['B4', 'B3', 'B2'], min: 0, max: 2000}, 'first');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

first = (
    ee.ImageCollection('COPERNICUS/S2_SR')
    .filterBounds(ee.Geometry.Point(-70.48, 43.3631))
    .filterDate('2019-01-01', '2019-12-31')
    .sort('CLOUDY_PIXEL_PERCENTAGE')
    .first()
)

# Define a map centered on southern Maine.
m = geemap.Map(center=[43.7516, -70.8155], zoom=11)

# Add the image layer to the map and display it.
m.add_layer(
    first, {'bands': ['B4', 'B3', 'B2'], 'min': 0, 'max': 2000}, 'first'
)
display(m)

Perhatikan bahwa pengurutan dilakukan setelah filter. Hindari pengurutan seluruh koleksi.

Gambar dari GeoTIFF Cloud

Anda dapat menggunakan ee.Image.loadGeoTIFF() untuk memuat gambar dari GeoTIFF yang Dioptimalkan untuk Cloud di Google Cloud Storage. Misalnya, set data Landsat publik yang dihosting di Google Cloud berisi GeoTIFF ini, yang sesuai dengan band 5 dari adegan Landsat 8. Anda dapat memuat gambar ini dari Cloud Storage menggunakan ee.Image.loadGeoTIFF():

Editor Kode (JavaScript)

var uri = 'gs://gcp-public-data-landsat/LC08/01/001/002/' +
    'LC08_L1GT_001002_20160817_20170322_01_T2/' +
    'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF';
var cloudImage = ee.Image.loadGeoTIFF(uri);
print(cloudImage);

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

uri = (
    'gs://gcp-public-data-landsat/LC08/01/001/002/'
    + 'LC08_L1GT_001002_20160817_20170322_01_T2/'
    + 'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF'
)
cloud_image = ee.Image.loadGeoTIFF(uri)
display(cloud_image)

Perhatikan bahwa jika Anda ingin memuat ulang Cloud Optimized GeoTIFF yang Anda ekspor dari Earth Engine ke Cloud Storage, saat Anda melakukan ekspor, tetapkan cloudOptimized ke true seperti yang dijelaskan di sini.

Gambar dari array Zarr v2

Anda dapat menggunakan ee.Image.loadZarrV2Array() untuk memuat gambar dari array Zarr v2 di Google Cloud Storage. Misalnya, set data ERA5 publik yang dihosting di Google Cloud berisi array Zarr v2 ini, yang sesuai dengan meter air yang telah menguap dari permukaan Bumi. Anda dapat memuat array ini dari Cloud Storage menggunakan ee.Image.loadZarrV2Array():

Editor Kode (JavaScript)

var timeStart = 1000000;
var timeEnd = 1000010;
var zarrV2ArrayImage = ee.Image.loadZarrV2Array({
  uri:
      'gs://gcp-public-data-arco-era5/ar/full_37-1h-0p25deg-chunk-1.zarr-v3/evaporation/.zarray',
  proj: 'EPSG:4326',
  starts: [timeStart],
  ends: [timeEnd]
});
print(zarrV2ArrayImage);
Map.addLayer(zarrV2ArrayImage, {min: -0.0001, max: 0.00005}, 'Evaporation');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

time_start = 1000000
time_end = 1000010
zarr_v2_array_image = ee.Image.loadZarrV2Array(
    uri='gs://gcp-public-data-arco-era5/ar/full_37-1h-0p25deg-chunk-1.zarr-v3/evaporation/.zarray',
    proj='EPSG:4326',
    starts=[time_start],
    ends=[time_end],
)

display(zarr_v2_array_image)

m.add_layer(
    zarr_v2_array_image, {'min': -0.0001, 'max': 0.00005}, 'Evaporation'
)
m

Gambar konstanta

Selain memuat gambar menurut ID, Anda juga dapat membuat gambar dari konstanta, daftar, atau objek Earth Engine lainnya yang sesuai. Berikut mengilustrasikan metode untuk membuat gambar, mendapatkan subset band, dan memanipulasi band:

Editor Kode (JavaScript)

// Create a constant image.
var image1 = ee.Image(1);
print(image1);

// Concatenate two images into one multi-band image.
var image2 = ee.Image(2);
var image3 = ee.Image.cat([image1, image2]);
print(image3);

// Create a multi-band image from a list of constants.
var multiband = ee.Image([1, 2, 3]);
print(multiband);

// Select and (optionally) rename bands.
var renamed = multiband.select(
    ['constant', 'constant_1', 'constant_2'], // old names
    ['band1', 'band2', 'band3']               // new names
);
print(renamed);

// Add bands to an image.
var image4 = image3.addBands(ee.Image(42));
print(image4);

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

# Create a constant image.
image_1 = ee.Image(1)
display(image_1)

# Concatenate two images into one multi-band image.
image_2 = ee.Image(2)
image_3 = ee.Image.cat([image_1, image_2])
display(image_3)

# Create a multi-band image from a list of constants.
multiband = ee.Image([1, 2, 3])
display(multiband)

# Select and (optionally) rename bands.
renamed = multiband.select(
    ['constant', 'constant_1', 'constant_2'],  # old names
    ['band1', 'band2', 'band3'],  # new names
)
display(renamed)

# Add bands to an image.
image_4 = image_3.addBands(ee.Image(42))
display(image_4)