值提取至点 (空间分析)

摘要

基于一组点要素提取栅格像元值，并将这些值记录到输出要素类的属性表。

用法

• 输入点要素类中的所有字段均将包括在输出点要素类中。

• 输出要素类将添加一个名为 RASTERVALU 的新字段。

  注:

  该字段不能已存在于输入要素的属性表中。否则，将发生错误。如果要保留原始信息，可在执行值提取至点之前向属性表添加一个新字段（例如，RASVAL1），计算该字段的值，然后删除原始的 RASTERVALU 字段。

• 对多波段栅格使用值提取至点时，RASTERVALU 字段将包含输入栅格的最后一个波段的值。要从多个栅格或某个多波段栅格数据集提取值，请使用多值提取至点工具。

• 对于属性表的 RASTERVALU 字段，若赋值栅格中的像元值为 NoData，则该像元的字段值为 -9999。

• 插值选项决定了从栅格中获取值的方式。默认选项为使用被采样像元的中心值。插值选项将使用双线性插值法在像元中心内插一个值。

• 如果输入栅格为浮点型，则生成的输出点数据集将仅包含输入要素数据的属性和像元值（由插值选项确定）。

• 添加来自输入栅格的属性时，如果输出点要素数据集是 shapefile，则输入栅格中不能存在名称长度超过 10 个字符的字段。如果存在此类字段，则必须在运行该工具之前对其进行重命名。

• 不支持将多点数据集作为输入。

语法

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 (可选)	指定是否使用插值。 NONE — 不应用任何插值法；将使用像元中心值。 INTERPOLATE — 将使用双线性插值法根据相邻像元的有效值计算像元值。除非所有相邻像元都为 NoData，否则会在插值时忽略 NoData 值。	Boolean
add_attributes (可选)	确定是否将栅格属性写入输出点要素数据集。 VALUE_ONLY — 仅将输入栅格的值添加到点属性。这是默认设置。 ALL — 输入栅格的所有字段（“计数”除外）都将添加到点属性。	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")

环境

当前工作空间, 输出配置关键字, 输出 M 属性域, 输出 XY 属性域, 输出 Z 属性域, 输出坐标系, 范围, 输出空间格网 1；输出空间格网 2；输出空间格网 3, 限定的字段名, 临时工作空间, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

ArcGIS for Desktop Basic: 需要 Spatial Analyst

ArcGIS for Desktop Standard: 需要 Spatial Analyst

ArcGIS for Desktop Advanced: 需要 Spatial Analyst