ee.Image.mask

Mendapatkan atau menetapkan mask gambar. Gambar output mempertahankan metadata dan jejak gambar input. Piksel yang mask-nya berubah dari nol ke nilai lain akan diisi dengan nol, atau nilai yang paling mendekati nol dalam rentang jenis piksel.

Catatan: versi yang menetapkan mask akan dihentikan penggunaannya. Untuk menyetel mask dari gambar pada piksel yang sebelumnya tidak di-mask, gunakan Image.updateMask. Untuk menampilkan piksel yang sebelumnya ditutup, gunakan Image.unmask.

Penggunaan	Hasil
Image.mask(mask)	Gambar

Argumen	Jenis	Detail
ini: image	Gambar	Gambar input.
mask	Gambar, default: null	Gambar mask. Jika ditentukan, gambar input akan disalin ke output, tetapi diberi mask oleh nilai gambar ini. Jika ini adalah satu band, band ini akan digunakan untuk semua band dalam gambar input. Jika tidak ditentukan, akan menampilkan gambar yang dibuat dari mask gambar input, yang diskalakan ke rentang [0:1] (tidak valid = 0, valid = 1,0).

Contoh

Editor Kode (JavaScript)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');
var trueColorViz = {
  bands: ['B4', 'B3', 'B2'],
  min: 0,
  max: 2700,
  gamma: 1.3
};
print('Sentinel-2 image', img);
Map.setCenter(-122.36, 37.47, 10);
Map.addLayer(img, trueColorViz, 'Sentinel-2 image');

// Get masks for all image bands; each band has an independent mask.
// Valid pixels are value 1, invalid are 0.
var multiBandMaskImg = img.mask();
print('Multi-band mask image', multiBandMaskImg);
Map.addLayer(multiBandMaskImg, null, 'Multi-band mask image');

// Get the mask for a single image band.
var singleBandMaskImg = img.select('B1').mask();
print('Single-band mask image', singleBandMaskImg);
Map.addLayer(singleBandMaskImg, null, 'Single-band mask image');

Penyiapan Python

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

import ee
import geemap.core as geemap

Colab (Python)

# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
true_color_viz = {
    'bands': ['B4', 'B3', 'B2'],
    'min': 0,
    'max': 2700,
    'gamma': 1.3,
}
display('Sentinel-2 image', img)
m = geemap.Map()
m.set_center(-122.36, 37.47, 10)
m.add_layer(img, true_color_viz, 'Sentinel-2 image')

# Get masks for all image bands each band has an independent mask.
# Valid pixels are value 1, invalid are 0.
multi_band_mask_img = img.mask()
display('Multi-band mask image', multi_band_mask_img)
m.add_layer(multi_band_mask_img, None, 'Multi-band mask image')

# Get the mask for a single image band.
single_band_mask_img = img.select('B1').mask()
display('Single-band mask image', single_band_mask_img)
m.add_layer(single_band_mask_img, None, 'Single-band mask image')
m