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 للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام 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