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/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