需要 Spatial Analyst 许可。
摘要
基于一组点要素提取栅格像元值,并将这些值记录到输出要素类的属性表。
用法
输入点要素类中的所有字段均将包括在输出点要素类中。
输出要素类将添加一个名为 RASTERVALU 的新字段。
对多波段栅格使用值提取至点时,RASTERVALU 字段将包含来自输入栅格的最后一个波段的值。要从多个栅格或某个多波段栅格数据集提取值,请使用多值提取至点工具。
对于属性表的 RASTERVALU 字段,若赋值栅格中的像元值为 NoData 像元,则该字段的值为 -9999。
-
插值选项决定了从栅格中获取值的方式。默认选项为使用被采样像元的中心值。插值选项将使用双线性插值法在像元中心内插一个值。
如果输入栅格为浮点型,则生成的输出点数据集将仅包含输入要素数据的属性和像元值(由插值选项确定)。
添加来自输入栅格的属性时,如果输出点要素数据集是 shapefile,则输入栅格中不能存在名称长度超过 10 个字符的字段。如果存在此类字段,则必须在运行该工具之前对其进行重命名。
不支持将多点数据集作为输入。
有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst。
语法
ExtractValuesToPoints (in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})
参数 | 说明 | 数据类型 |
in_point_features | 用于定位待提取栅格像元值的输入点要素。 | Feature Layer |
in_raster | 待提取值的栅格数据集。 其栅格数据可为整型或浮点型。 | Raster Layer |
out_point_features | 包含提取的栅格值的输出点要素数据集。 | Feature Class |
interpolate_values (可选) | 指定是否使用插值。
| Boolean |
add_attributes (可选) | 确定是否将栅格属性写入输出点要素数据集。
| Boolean |
代码示例
值提取至点 (ExtractValuesToPoints) 示例 1(Python 窗口)
本示例根据点 shapefile 所定义的位置提取栅格的像元值,并创建这些值的输出点要素类。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ExtractValuesToPoints("rec_sites.shp", "elevation",
"C:/sapyexamples/output/outValPnts","INTERPOLATE",
"VALUE_ONLY")
值提取至点 (ExtractValuesToPoints) 示例 2(独立脚本)
本示例根据点 shapefile 所定义的位置提取栅格的像元值,并创建这些值的输出点 shapefile。
# Name: ExtractValuesToPoints_Ex_02.py
# Description: Extracts the cells of a raster based on a set of points.
# 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
inPointFeatures = "rec_sites.shp"
inRaster = "elevation"
outPointFeatures = "C:/sapyexamples/output/extractvaluespts.shp"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")
环境
许可信息
- ArcGIS for Desktop Basic: 需要 Spatial Analyst
- ArcGIS for Desktop Standard: 需要 Spatial Analyst
- ArcGIS for Desktop Advanced: 需要 Spatial Analyst