ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

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

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS Developers

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

ArcGIS Solutions

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

ArcGIS Marketplace

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

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

ArcMap

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

示例

需要 Spatial Analyst 许可。

  • 描述
  • 使用方法
  • 语法
  • 代码示例
  • 环境
  • 许可信息

描述

创建一个表,其中显示从一个栅格或一组栅格提取的已定义位置的像元值。这些位置可通过栅格像元或一组点进行定义。

输入栅格可以是二维或多维的。如果输入栅格是多维的,输出表的结构会发生更改。

了解有关“采样”工作原理的详细信息

使用方法

  • 系统将从每个位置的所有输入栅格中提取像元值。系统将使用包含每个输入栅格像元值的字段创建一个表格。

  • 输入栅格表中的其他属性(若有的话)将不会包含在输出表中。

  • 输入栅格不会进行重采样以支持分析环境。相反,系统将以所有输入栅格的原始分辨率和空间参考来提取像元值,方法是将输入位置投影到从中提取值的栅格空间参考。

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

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

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

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

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

  • 如果输入位置数据为栅格,则每个包含有效值(非 NoData)的像元的中心均可用于从该位置的所有输入栅格中提取像元值。

  • 如果输入位置数据为点要素类且不包含空间索引,将发出一则警告。要提升大型输入点要素的工具性能,请创建空间索引。

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

  • 除非在输出坐标系环境中已指定输出采样表中 x,y 坐标的空间参考,否则该空间参考将与输入位置栅格或点要素(Python 中的in_location_data)的空间参考相同。如果输入位置数据的空间参考未知,则 x,y 坐标的空间参考也将是未知的。

    x,y 坐标的空间参考在工具执行结束时被标识为地理处理消息。

  • 重采样技术(Python 中的 resampling_type)选项决定了从栅格中获取值的方式。默认选项为最邻近,它可用于在输入位置提取准确的像元值。要提取内插值,请指定双线性或三次卷积选项。

  • 包含像元值的字段类型与最邻近选项的栅格类型相匹配。然而,为了保持内插值的精度,双线性或三次卷积选项的字段类型将始终为浮点型。如果将重采样选项设置为最邻近,则输出表中的字段将与栅格类型的字段相匹配。然而,为了保持内插值的精度,双线性或三次卷积选项的字段类型将始终为浮点型。

  • 将名为 Sample_point 的字段添加到输出表中,以存储唯一 ID 字段(Python 中的 unique_id_field)中指定的值。建议使用包含唯一值的字段作为每个位置的标识符以供进一步分析。

  • 将多维栅格指定为输入栅格时,如果未选中以多维方式处理参数(ALL_SLICES 用于 Python 中的 process_as_multidimensional 参数),则系统将仅对多维栅格的当前切割片进行采样。

    要从输入多维数据集中提取所有变量的所有切割片中的值,请选中以多维方式处理参数。

  • 如果选中了以多维方式处理参数(ALL_SLICES 用于 Python 中的 process_as_multidimensional 参数),将出现以下情况。

    • 该工具仅处理一个多维栅格。如果指定了多个多维栅格,则仅会处理第一个栅格。

    • 提取的值将使用与变量相同的名称存储在字段中。将创建附加字段,以存储与维度的名称相同的非空间维度值。

    • 如果多维栅格具有多个波段,则不会为每个波段创建附加字段。相反,针对波段提取的值将存储在变量字段中。系统将为曾用于指定波段的维度创建一个附加字段,以存储维度值。

  • 该工具目前支持用于多维处理的多维栅格类型为 netCDF 栅格图层和多维镶嵌数据集。也可以使用多维数据的影像服务,前提是先将影像服务设置为允许使用多维数据。

  • 如果在掩膜环境中指定了一个要素,则系统将使用输入栅格的最小像元大小创建内部栅格。提取过程中,内部掩模栅格将被再次重采样到每个输入栅格的像元大小。

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

语法

Sample(in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional})
参数说明数据类型
in_rasters
[in_raster,...]

将根据输入位置数据对其中的值进行采样的栅格列表。

Raster Layer
in_location_data

用于识别想要进行采样的位置数据。

可以是栅格,也可以是点要素数据集。

Raster Layer; Feature Layer
out_table

保存已采样的像元值的输出表。

表的格式由输出位置和路径确定。默认情况下,输出为一张地理数据库表。如果路径不在地理数据库中,则格式将由表达式确定。如果扩展名为 .dbf,则将采用 dBASE 格式。如果未指定扩展名,则输出将为 INFO 表。

Table
resampling_type
(可选)

对栅格进行采样时所使用的重采样算法。

  • NEAREST —最邻近分配法
  • BILINEAR —双线性插值法
  • CUBIC —三次卷积插值法
String
unique_id_field
(可选)

包含输入位置栅格或点要素中每个位置或要素不同值的字段。

Field
process_as_multidimensional
(可选)

确定输入栅格的处理方式。

  • ALL_SLICES —将对多维数据集的所有维度(如时间或深度)进行采样。
  • CURRENT_SLICE —将对多维数据集的当前片进行采样。这是默认设置。
Boolean

代码示例

Sample 示例 1(Python 窗口)

根据输入位置将像元值从多个栅格提取到表。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Sample(["elevation", "costraster"], "observers.shp",
       "c:/sapyexamples/output/samptable","NEAREST")
Sample 示例 2(独立脚本)

根据输入位置将像元值从多个栅格提取到表。

# Name: Sample_Ex_02.py
# Description: Creates a table that shows the values of cells from 
#              a raster, or set of rasters, for defined locations. 
#              The locations are defined by raster cells or by 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
inRasters = ["elevation",
             "costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"

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

# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)

环境

  • 自动提交
  • 范围
  • 当前工作空间
  • 地理变换
  • 掩膜
  • 输出配置关键字
  • 输出坐标系
  • 临时工作空间

许可信息

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

相关主题

  • 提取分析工具集概述

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

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