ee.Image.mask

קבלת המסכה של תמונה או הגדרת המסכה של תמונה. תמונת הפלט שומרת על המטא-נתונים ועל טביעת הרגל של תמונת הקלט. פיקסלים שבהם המסכה משתנה מאפס לערך אחר ימולאו באפסים, או בערכים הכי קרובים לאפס בטווח של סוג הפיקסל.

שימושהחזרות
Image.mask(mask)תמונה
ארגומנטסוגפרטים
זה: imageתמונהתמונת הקלט.
maskתמונה, ברירת מחדל: nullתמונת המסכה. אם מציינים תמונה, היא מועתקת לפלט אבל המסכה שלה מוגדרת לפי הערכים של התמונה הזו. אם מדובר בפס יחיד, הוא ישמש את כל הפסים בתמונת הקלט. אם לא מציינים, הפונקציה מחזירה תמונה שנוצרה מהמסכה של תמונת הקלט, ששונתה בה הסקאלה לטווח [0:1] (לא תקין = 0, תקין = 1.0).

דוגמאות

עורך הקוד (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');

הגדרת Python

מידע על Python API ועל שימוש ב-geemap לפיתוח אינטראקטיבי מופיע בדף Python Environment.

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