采样 (空间分析)

摘要

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

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

用法

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

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

• 输出表中采样值的字段类型总是浮点型。这样，可以确保重采样技术选择“双线性”或“双三次卷积”时仍能保持适当精度。

• 如果位置输入为栅格，为了获得最佳结果，输入栅格和位置栅格的像元大小和配准应相同。

• 工具的输出为表。

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

语法

Sample (in_rasters, in_location_data, out_table, {resampling_type})

参数	说明	数据类型
in_rasters [in_raster,...]	将根据输入位置数据对其中的值进行采样的栅格列表。	Raster Layer
in_location_data	用于识别想要进行采样的位置数据。 可以是栅格，也可以是点要素数据集。	Raster Layer | Feature Layer
out_table	保存已采样的像元值的输出表。 表的格式由输出位置和路径确定。如果未指定扩展名，则该表将为 INFO 表。如果位置在地理数据库中，将创建此特殊类型（例如文件或 ArcSDE 地理数据库）的输出表。如果名称包含 .dbf 扩展名，输出将为 dBASE 格式。	Table
resampling_type (可选)	对栅格进行采样时所使用的重采样算法。 NEAREST — 最邻近分配法。 BILINEAR — 双线性插值法。 CUBIC — 三次卷积插值法。	String

代码实例

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