ee.Image.mask

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

הערה: הגרסה שבה מוגדרת מסכה תוצא משימוש. כדי להגדיר מסכה מתמונה על פיקסלים שלא הוסרה מהם המסכה בעבר, משתמשים ב-Image.updateMask. כדי לבטל את המסיכה של פיקסלים שהוסתרו קודם, משתמשים ב-Image.unmask.

שימוש	החזרות
Image.mask(mask)	תמונה

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

דוגמאות

Code Editor (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 מפורט מידע על Python API ועל השימוש ב-geemap לפיתוח אינטראקטיבי.

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