ee.Image.mask

ماسک تصویر را دریافت یا تنظیم می‌کند. تصویر خروجی فراداده و ردپای تصویر ورودی را حفظ می‌کند. پیکسل‌هایی که در آن‌ها ماسک از صفر به مقدار دیگری تغییر می‌کند با صفر یا مقادیری که در محدوده نوع پیکسل به صفر نزدیک‌تر هستند پر می‌شوند.

توجه: نسخه‌ای که ماسک را تنظیم می‌کند منسوخ خواهد شد. برای تنظیم ماسک از تصویر روی پیکسل‌هایی که قبلاً پوشانده نشده‌اند، از Image.updateMask استفاده کنید. برای آشکار کردن پیکسل‌هایی که قبلاً پوشانده شده‌اند، از Image.unmask استفاده کنید.

کاربردبازگشتی‌ها
Image.mask(mask)تصویر
متغیر مستقلنوعجزئیات
این: imageتصویرتصویر ورودی.
maskتصویر، پیش‌فرض: تهیتصویر ماسک. اگر مشخص شده باشد، تصویر ورودی در خروجی کپی می‌شود اما پوشش با مقادیر این تصویر داده می‌شود. اگر این یک باند تکی باشد، برای همه باندهای تصویر ورودی استفاده می‌شود. اگر مشخص نشده باشد، تصویری را برمی‌گرداند که از ماسک تصویر ورودی ایجاد شده است و به محدوده [0:1] مقیاس‌بندی شده است (نامعتبر = 0، معتبر = 1.0).

مثال‌ها

ویرایشگر کد (جاوا اسکریپت)

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