ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

专为贵组织打造的制图平台

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS for Developers

用于构建位置感知应用程序的工具

ArcGIS Solutions

适用于行业的免费模板地图和应用程序

ArcGIS Marketplace

获取适用于组织的应用程序和数据

  • 文档
  • 支持
Esri
  • 登录
user
  • 我的个人资料
  • 登出

ArcMap

  • 主页
  • 入门
  • 地图
  • 分析
  • 管理数据
  • 工具
  • 扩展模块

值提取至点

需要 Spatial Analyst 许可。

  • 摘要
  • 用法
  • 语法
  • 代码示例
  • 环境
  • 许可信息

摘要

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

用法

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

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

    注:

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

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

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

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

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

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

  • 输入栅格中采样 NoData 像元的位置将在输出地理数据库表中被赋予 <空> 值。由于输出 shapefile 不支持空值概念,所以将为其赋值 -9999。

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

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

  • 有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 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
(可选)

指定是否使用插值。

  • 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"

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

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

环境

  • 自动提交
  • 当前工作空间
  • 默认输出 Z 值
  • 范围
  • 地理变换
  • 掩膜
  • M 分辨率
  • M 容差
  • 维护空间索引
  • 输出配置关键字
  • 输出坐标系
  • 输出包含 M 值
  • 输出包含 Z 值
  • 输出 M 值域
  • 输出 XY 值域
  • 输出 Z 值域
  • 限定的字段名
  • 临时工作空间
  • 捕捉栅格
  • 传输字段域描述
  • XY 分辨率
  • XY 容差
  • Z 分辨率
  • Z 容差

许可信息

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

相关主题

  • 提取分析工具集概述

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS 平台

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

  • 关于我们
  • 招贤纳士
  • Esri 博客
  • 用户大会
  • 开发者峰会
Esri
分享您的想法。
Copyright © 2019 Esri. | 隐私政策 | 法律声明