ArcMap

按掩膜提取

需要 Spatial Analyst 许可。

摘要

提取掩膜所定义区域内的相应栅格像元。

插图

按掩膜提取插图
OutRas = ExtractByMask(InRas1, InMsk1)

用法

  • 当输入为多波段栅格时，将输出一个新的多波段栅格。对输入多波段栅格中的每一单个波段都会进行相应分析。

  • 当为输入栅格掩膜指定多波段栅格时，将只在运算中使用第一个波段。

  • 执行按掩膜提取工具时，如果在环境设置中指定了掩膜，则输出栅格仅包含位于环境掩膜和输入掩膜数据交集内区域的像元值。

  • 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

语法

ExtractByMask (in_raster, in_mask_data)
参数说明数据类型
in_raster

提取像元的输入栅格。

Raster Layer
in_mask_data

用于定义提取区域的输入掩膜数据。

它可以是栅格，也可以是要素数据集。

当输入掩膜数据为栅格时，将在输出栅格中为掩膜数据中的 NoData 像元指定 NoData 值。

当输入掩膜是要素数据时，如果输入栅格中像元的中心位于要素周长范围内，则会在输出中包含这些像元，而其中心落在要素周长之外的像元将会收到 NoData。

Raster Layer; Feature Layer

返回值

名称说明数据类型
out_raster

包含从输入栅格中提取的像元值的输出栅格。

Raster

代码示例

ExtractByMask 示例 1（Python 窗口）

本示例将从栅格内提取由输入面 shapefile 要素类所定义的掩膜内的像元。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExtractByMask = ExtractByMask("elevation", "mask.shp")
outExtractByMask.save("C:/sapyexamples/output/maskextract")
ExtractByMask 示例 2（独立脚本）

本示例将从栅格内提取由输入面 shapefile 要素类所定义的掩膜内的像元。

# Name: ExtractByMask_Ex_02.py
# Description: Extracts the cells of a raster that correspond with the areas
#    defined by a mask.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
inMaskData = "mask.shp"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ExtractByMask
outExtractByMask = ExtractByMask(inRaster, inMaskData)

# Save the output 
outExtractByMask.save("C:/sapyexamples/output/extractmask")

环境

许可信息

  • ArcGIS Desktop Basic: 需要 Spatial Analyst
  • ArcGIS Desktop Standard: 需要 Spatial Analyst
  • ArcGIS Desktop Advanced: 需要 Spatial Analyst

相关主题