ee.Image.mask

Ottiene o imposta la maschera di un'immagine. L'immagine di output conserva i metadati e l'impronta dell'immagine di input. I pixel in cui la maschera passa da zero a un altro valore verranno riempiti con zeri o con i valori più vicini a zero nell'intervallo del tipo di pixel.

Nota: la versione che imposta una maschera verrà ritirata. Per impostare una maschera da un'immagine su pixel precedentemente non mascherati, utilizza Image.updateMask. Per rimuovere la maschera dai pixel precedentemente mascherati, utilizza Image.unmask.

Utilizzo	Restituisce
Image.mask(mask)	Immagine

Argomento	Tipo	Dettagli
this: image	Immagine	L'immagine di input.
mask	Immagine, valore predefinito: null	L'immagine della maschera. Se specificata, l'immagine di input viene copiata nell'output, ma viene assegnata la maschera in base ai valori di questa immagine. Se si tratta di una singola banda, viene utilizzata per tutte le bande dell'immagine di input. Se non specificata, restituisce un'immagine creata dalla maschera dell'immagine di input, scalata all'intervallo [0:1] (non valido = 0, valido = 1.0).

Esempi

Editor di codice (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');

Configurazione di Python

Per informazioni sull'API Python e sull'utilizzo di geemap per lo sviluppo interattivo, consulta la pagina Ambiente 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