| 标注 | 说明 | 数据类型 |
输入点要素 | 输入点要素可定义要提取栅格像元值的位置。 | Feature Layer |
输入栅格 | 要提取其值的栅格数据集。 其栅格类型可为整型或浮点型。 | Raster Layer |
输出点要素 | 包含已提取的栅格值的输出点要素数据集。 | Feature Class |
在点位置插值 (可选) | 指定是否使用插值。
| Boolean |
将所有输入栅格属性追加到输出点要素 (可选) | 确定栅格属性是否写入输出点要素数据集。
| Boolean |
需要 Spatial Analyst 许可。
使用情况
输入点要素类中的所有字段均将添加到输出点要素类中。
将名为 RASTERVALU 的新字段添加到输出，以存储提取值。 如果输入要素的属性表中已存在具有此名称的字段，则该工具将无法执行。
输入栅格不会进行重采样以支持分析环境。 相反，系统将以输入栅格的原始分辨率和空间参考来提取像元值，方法是将输入位置投影到从中提取值的栅格空间参考。
但是，分析环境将应用于输入位置。
从输入栅格的 NoData 像元中提取值的位置将在输出表中被赋予 <空> 值。 对于 shapefile，由于不支持空字段，因此 NoData 像元在表中以值 -9999 表示。
shapefile 格式将字段名称的最大长度限制为 10 个字符。 因此，对于追加到输出 shapefile 属性表中的任何字段，其名称都将被截断并获得唯一值。 如果名称很长或很相似，则可能导致各字段间难以区分。 在这种情况下，建议您将其输出至文件地理数据库。
该工具将无法用多点要素执行。 要使用多点要素执行分析，请将其转换为单点要素，然后在提取工具中使用。 有关详细信息，请参阅处理多点数据。
将多波段栅格指定为输入栅格（Python 中的 in_raster）时，将只使用第一个波段。
如需处理其他波段，请指定要使用的波段。
要从多个栅格或某个多波段栅格数据集提取值，请使用多值提取至点工具。
插值选项决定了从栅格中获取值的方式。 默认选项是在输入位置提取准确的像元值。 要使用双线性方法提取内插值，请选中在点位置插入值（Python 中的 interpolate_values）选项。
要从输入栅格表添加所有属性，请选中将所有输入栅格属性追加到输出点要素选项（ALL 用于 Python 中的 add_attributes 参数）。 系统会将这些属性按照原样添加至输出点要素，并保持相关值不变。 请注意，根据所记录属性的性质，某些属性值可能需要重新计算。
如果尚未明确指定输出坐标系环境，则输出要素类的空间参考将从输入点要素中获取。 但是，如果将输出写入要素数据集，则无论是否指定输出坐标系环境，输出空间参考都将与要素数据集相同。
如果在掩膜环境中指定了一个要素，则可使用像元大小和输入栅格中的像元对齐从内部将其转换为栅格。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 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 |
代码示例
此示例根据点 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")此示例根据点 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"
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")环境
自动提交, 当前工作空间, 默认输出 Z 值, 范围, 地理变换, 掩膜, M 分辨率, M 容差, 维护空间索引, 输出配置关键字, 输出坐标系, 输出包含 M 值, 输出包含 Z 值, 输出 M 属性域, 输出 XY 属性域, 输出 Z 属性域, 限定的字段名, 临时工作空间, 传送字段属性域描述, XY 分辨率, XY 容差, Z 分辨率, Z 容差
特殊情况
许可信息
- Basic: 需要 Spatial Analyst
- Standard: 需要 Spatial Analyst
- Advanced: 需要 Spatial Analyst