ee.Image.mask

Получает или задает маску изображения. Выходное изображение сохраняет метаданные и след входного изображения. Пиксели, в которых маска меняется с нуля на другое значение, будут заполнены нулями или значениями, наиболее близкими к нулю в диапазоне типа пикселя.

Примечание. Версия, которая задает маску, будет упразднена. Чтобы установить маску из изображения на ранее немаскированных пикселях, используйте Image.updateMask. Чтобы снять маску с ранее замаскированных пикселей, используйте Image.unmask.

ИспользованиеВозвраты
Image.mask(mask)Изображение
АргументТипСведения
this: imageИзображениеИсходное изображение.
maskИзображение, по умолчанию: nullИзображение маски. Если указано, входное изображение копируется в выходное, но маска задается значениями этого изображения. Если это одна полоса, она используется для всех полос во входном изображении. Если не указано, возвращает изображение, созданное из маски входного изображения, масштабированное до диапазона [0:1] (недействительно = 0, действительно = 1,0).

Примеры

Редактор кода (JavaScript)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR_HARMONIZED/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');

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR_HARMONIZED/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