值提取至点 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

根据一组点要素提取栅格的像元值,并将值记录在输出要素类的属性表中。

多值提取至点工具提供了增强的功能或性能。

使用情况

  • 输入点要素类中的所有字段均将添加到输出点要素类中。

  • 将名为 RASTERVALU 的字段添加到输出,以存储提取的值。 如果输入要素属性表中已经存在具有此名称的字段,则工具将无法执行。

  • 不会根据分析环境对输入栅格进行重采样。 相反,将通过将输入位置投影到从中提取值的栅格空间参考,以原始分辨率和空间参考从所有输入栅格中提取像元值。

    但是,分析环境将应用于输入位置。

  • 从输入栅格的 NoData 像元中提取值的位置将在输出表中被赋予 <空> 值。 对于 shapefile,由于不支持空字段,因此 NoData 像元在表中以值 -9999 表示。

  • shapefile 格式将字段名称的最大长度限制为 10 个字符。 因此,对于追加到输出 shapefile 属性表中的任何字段,其名称都将被截断并获得唯一值。 如果名称很长或很相似,则可能导致各字段间难以区分。 在这种情况下,建议您将其输出至文件地理数据库。

  • 该工具无法使用多点要素执行。 要使用多点要素执行分析,请将其转换为单点要素,然后在提取工具中使用。 有关详细信息,请参阅处理多点数据

  • 将多波段栅格指定为输入栅格(Python 中的 in_raster)值时,将只使用第一个波段。

    如需处理其他波段,请指定要使用的波段。

    要从多个栅格或某个多波段栅格数据集提取值,请使用多值提取至点工具。

  • 插值选项决定了从栅格中获取值的方式。 默认选项为在输入位置提取准确的像元值。 要使用双线性插值方法提取插值值,请选中在点位置插值(Python 中的 interpolate_values)选项。

  • 要添加输入栅格表中的所有属性,请选中将所有输入栅格属性追加到输出点要素选项(在 Python 中, add_attributes 参数设置为 ALL)。 系统会将这些属性按照原样添加至输出点要素,并保持相关值不变。 需注意,根据所记录属性的性质,某些属性值可能需要重新计算。

  • 如果未显式指定输出坐标系环境,则输出要素类的空间参考将派生自输入点要素。 但是,如果输出写入到要素数据集中,无论是否指定了输出坐标系环境,输出空间参考都将与要素数据集相同。

  • 如果在掩膜环境中指定了要素,则可使用像元大小和输入栅格中的像元对齐从内部将其转换为栅格。

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

参数

标注说明数据类型
输入点要素

输入点要素定义了要从中提取栅格像元值的位置。

Feature Layer
输入栅格

要提取值的栅格数据集。

其栅格类型可为整型或浮点型。

Raster Layer
输出点要素

包含提取的栅格值的输出点要素数据集。

Feature Class
在点位置插值值
(可选)

指定是否使用插值。

  • 未选中 - 不应用任何插值法;将使用像元中心值。 这是默认设置。
  • 选中 - 将使用双线性插值法根据相邻像元的有效值计算像元值。 插值时将忽略 NoData 值,除非所有相邻像元均为 NoData。
Boolean
将所有输入栅格属性追加到输出点要素
(可选)

确定是否将栅格属性写入输出点要素数据集。

  • 未选中 - 仅将输入栅格的值添加到点属性。 这是默认设置。
  • 选中 - 输入栅格的所有字段(Count 除外)都将添加到点属性。
Boolean

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输入栅格的所有字段(Count 除外)都将添加到点属性。
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"

# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
                      "INTERPOLATE", "VALUE_ONLY")

许可信息

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

相关主题