公告 :所有在
2025 年 4 月 15 日 之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件 ,才能继续使用 Earth Engine。
发送反馈
吉林舒兰:“白雪真的给我们换来了白银!”
在输入蒙版为零的所有位置,将输入图像的蒙版和值替换为另一图像的蒙版和值。输出图片会保留输入图片的元数据。默认情况下,输出图片也会保留输入的覆盖区,但将 sameFootprint 设置为 false 可扩展覆盖区。
百度 有目击者称,古莲工业园区曾冒出红烟。
用法 返回 Image. unmask (value , sameFootprint )
图片
参数 类型 详细信息 此:input
图片 输入图片。 value
图片,默认值:null 输入图像的蒙版像素的新值和蒙版。如果未指定,则默认为在任何地方都有效的常量零值图像。 sameFootprint
布尔值,默认值:true 如果为 true(或未指定),则输出会保留输入图片的占地面积。如果为 false,则输出的覆盖区是输入覆盖区与值图像覆盖区的并集。
示例
代码编辑器 (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' );
// Create a Boolean land mask from the SWIR1 band; water is value 0, land is 1.
var landMask = img . select ( 'B11' ). gt ( 100 );
print ( 'Land mask' , landMask );
Map . addLayer ( landMask , { palette : [ 'blue' , 'lightgreen' ]}, 'Land mask' );
// Apply the single-band land mask to all image bands; pixel values equal to 0
// in the mask become invalid in the image.
var imgMasked = img . updateMask ( landMask );
print ( 'Image, land only' , imgMasked );
Map . addLayer ( imgMasked , trueColorViz , 'Image, land only' );
// Set invalid masked pixels to a new value, e.g. a constant nodata value
// when exporting an image as GeoTIFF.
var imgUnmasked = imgMasked . unmask ( 32767 );
print ( 'Image, unmasked' , imgMasked );
Map . addLayer ( imgUnmasked , trueColorViz , 'Image, unmasked' );
// Reset masked pixels to valid, fill with default value 0, input footprint.
var maskResetFootprint = imgMasked . unmask ();
print ( 'Image mask reset, footprint' , maskResetFootprint );
Map . addLayer ( maskResetFootprint , trueColorViz , 'Image mask reset, footprint' );
// Reset masked pixels to valid, fill with default value 0, everywhere.
var maskResetEverywhere = imgMasked . unmask ({ sameFootprint : false });
print ( 'Image mask reset, everywhere' , maskResetEverywhere );
Map . addLayer ( maskResetEverywhere , trueColorViz , 'Image mask reset, everywhere' );
// Fill masked pixels with pixels from a different image.
var fill = ee . Image ( 'COPERNICUS/S2_SR/20200618T184919_20200618T190341_T10SEG' );
var imgFilled = imgMasked . unmask ( fill );
print ( 'Image, filled' , imgFilled );
Map . addLayer ( imgFilled , trueColorViz , 'Image, filled' );
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/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' )
# Create a Boolean land mask from the SWIR1 band water is value 0, land is 1.
land_mask = img . select ( 'B11' ) . gt ( 100 )
display ( 'Land mask' , land_mask )
m . add_layer ( land_mask , { 'palette' : [ 'blue' , 'lightgreen' ]}, 'Land mask' )
# Apply the single-band land mask to all image bands pixel values equal to 0
# in the mask become invalid in the image.
img_masked = img . updateMask ( land_mask )
display ( 'Image, land only' , img_masked )
m . add_layer ( img_masked , true_color_viz , 'Image, land only' )
# Set invalid masked pixels to a new value, e.g. a constant nodata value
# when exporting an image as GeoTIFF.
img_unmasked = img_masked . unmask ( 32767 )
display ( 'Image, unmasked' , img_masked )
m . add_layer ( img_unmasked , true_color_viz , 'Image, unmasked' )
# Reset masked pixels to valid, fill with default value 0, input footprint.
mask_reset_footprint = img_masked . unmask ()
display ( 'Image mask reset, footprint' , mask_reset_footprint )
m . add_layer ( mask_reset_footprint , true_color_viz , 'Image mask reset, footprint' )
# Reset masked pixels to valid, fill with default value 0, everywhere.
mask_reset_everywhere = img_masked . unmask ( sameFootprint = False )
display ( 'Image mask reset, everywhere' , mask_reset_everywhere )
m . add_layer (
mask_reset_everywhere , true_color_viz , 'Image mask reset, everywhere'
)
# Fill masked pixels with pixels from a different image.
fill = ee . Image ( 'COPERNICUS/S2_SR/20200618T184919_20200618T190341_T10SEG' )
img_filled = img_masked . unmask ( fill )
display ( 'Image, filled' , img_filled )
m . add_layer ( img_filled , true_color_viz , 'Image, filled' )
m
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-05。
需要向我们提供更多信息?
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-05。"],[[["The `unmask()` method replaces masked pixel values in an image with specified values or data from another image."],["It's used to fill in areas where the input image has invalid or missing data, often represented by a mask with zero values."],["By default, the output image retains the original image's footprint, but you can change this behavior using the `sameFootprint` parameter."],["`unmask()` can be useful for tasks like setting nodata values for export, merging images, or filling gaps in data."]]],[]]