帮助

采样

需要 Spatial Analyst 许可。

摘要

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

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

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

用法

  • 输入位置是栅格时，位置像元集包括值大于等于零的所有像元，不包括具有 NoData 值的像元。可使用提取工具轻松创建位置栅格。

  • 采样输入栅格或栅格集中 NoData 像元的位置将在输出地理数据库表中被赋予 <空> 值。由于 INFO 或 .dbf 格式的输出不支持空值概念，所以将为其赋值 0（零）。

  • 如果提供了多个多维栅格，它们必须共享相同的维度名称。

  • 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

代码示例

采样示例 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")
采样示例 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)

环境

许可信息

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

相关主题