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/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');

تنظیمات پایتون

برای اطلاعات بیشتر در مورد API پایتون و استفاده از geemap برای توسعه تعاملی، به صفحه محیط پایتون مراجعه کنید.

import ee
import geemap.core as geemap

کولب (پایتون)

# 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