ee.Image.mask

Pobiera lub ustawia maskę obrazu. Obraz wyjściowy zachowuje metadane i obszar obrazu wejściowego. Piksele, w których maska zmienia się z zera na inną wartość, zostaną wypełnione zerami lub wartościami najbliższymi zeru w zakresie typu piksela.

Uwaga: wersja, która ustawia maskę, zostanie wycofana. Aby ustawić maskę z obrazu na pikselach, które wcześniej nie były zamaskowane, użyj funkcji Image.updateMask. Aby odkryć wcześniej zamaskowane piksele, użyj funkcji Image.unmask.

Wykorzystanie	Zwroty
Image.mask(mask)	Obraz

Argument	Typ	Szczegóły
to: image	Obraz	Obraz wejściowy.
mask	Obraz, domyślny: null	Obraz maski. Jeśli jest określony, obraz wejściowy jest kopiowany do danych wyjściowych, ale maska jest nadawana przez wartości tego obrazu. Jeśli jest to pojedyncze pasmo, jest ono używane dla wszystkich pasm na obrazie wejściowym. Jeśli nie zostanie określony, zwraca obraz utworzony na podstawie maski obrazu wejściowego, przeskalowany do zakresu [0:1] (nieprawidłowy = 0, prawidłowy = 1,0).

Przykłady

Edytor kodu (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');

Konfiguracja Pythona

Informacje o interfejsie API dla Pythona oraz o używaniu geemap do interaktywnego programowania znajdziesz na stronie środowiska Python.

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