ee.Image.mask

Recupera 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 cambia 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 ripristinare i pixel precedentemente mascherati, utilizza Image.unmask.

Utilizzo	Resi
Image.mask(mask)	Immagine

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

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

Consulta la pagina Ambiente Python per informazioni sull'API Python e sull'utilizzo di geemap per lo sviluppo interattivo.

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