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 许可。

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

摘要

在点要素类的指定位置提取一个或多个栅格像元值,并将值记录到点要素类的属性表中。

用法

    警告:

    此工具会修改输入数据。应考虑首先保存一份数据集副本,然后对该副本执行工具。或者如果您对结果不满意,可以使用删除字段工具删除添加的字段。

  • 此工具可以在其操作中修改输入点的 ID 编号。因此,建议在输入点数据集的属性表中使用唯一标识符字段,而不仅仅依赖于原始数据集所提供的对象 ID 字段(可能为 FID、OID 或 ObjectID,具体取决于格式)。获取字段的简单方法为添加一个新的整型字段并在字段中计算该值。这将确保您可以将结果与原始输入相关联。

  • 可以将任意栅格组合(单波段或多波段)指定为输入。

  • 系统将为每个输入栅格提取像元值。包含每个输入栅格像元值的新字段将追加到输入点要素类。

  • 输入栅格表中的其他属性(若有的话)将不会追加到输入点要素。

  • 将多波段栅格指定为输入栅格(Python 中的 in_rasters)之一时,将使用该输入中的所有波段。

    要处理一系列来自输入多波段栅格的波段,请首先用波段合成工具创建由这些特定波段组成的新栅格数据集。在输入栅格列表中使用该结果。

  • 默认情况下,将根据输入栅格的名称来创建输出字段的名称;或者您也可以为每个存储栅格值的字段指定唯一名称。

  • 当输入多波段栅格时,为所有波段添加的输出字段的名称中将包含指示波段号的 b1_, b2_, …bn 前缀。

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

  • Shapefile 格式的字段最大长度限制为 10 个字符。默认情况下,追加到输入 shapefile 的输出字段将被截断并获得唯一值。如果名称很长或很相似,则可能很难区分各输入栅格。在这种情况下,建议您将输入要素转换为文件地理数据库,然后将其用作输入。

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

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

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

语法

ExtractMultiValuesToPoints (in_point_features, in_rasters, {bilinear_interpolate_values})
参数说明数据类型
in_point_features

要添加栅格值的输入点要素。

Feature Layer
in_rasters
[Raster, {Output Field Name}]

要基于输入点要素的位置提取栅格值。

您还可以为存储栅格值的字段指定名称。默认情况下,将根据输入栅格数据集的名称创建唯一的字段名称。

Extract Values
bilinear_interpolate_values
(可选)

指定是否使用插值。

  • NONE — 不应用任何插值法;将使用像元中心值。这是默认设置。
  • BILINEAR — 将使用双线性插值法根据相邻像元的有效值计算像元值。除非所有相邻像元都为 NoData,否则会在插值时忽略 NoData 值。
Boolean

派生输出

名称说明数据类型
out_point_features

代码示例

多值提取至点 (ExtractMultiValuesToPoints) 示例 1(Python 窗口)

将多个栅格的像元值提取到 shapefile 点要素类的属性中。

import arcpy
from arcpy.sa import *
from arcpy import env 
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"], 
                           ["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
多值提取至点 (ExtractMultiValuesToPoints) 示例 2(独立脚本)

使用插值法将多个栅格的像元值提取到 shapefile 点要素类的属性中。

# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
#    an output point feature class.  This example takes a multiband IMG
#    and two GRID files as input.
# 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 = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"], 
                ["redmin", "focalmin"]]

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

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")

环境

  • 自动提交
  • 当前工作空间
  • 范围
  • 掩膜
  • 输出配置关键字
  • 临时工作空间

许可信息

  • 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. | 隐私政策 | 法律声明