サンプル（Sample） (Spatial Analyst)

サマリ

定義された位置のラスタまたは一連のラスタからのセルの値を表示するテーブルを作成します。位置は、ラスタ セルまたは一連のポイントによって定義されます。

[サンプル（Sample）] ツールの仕組みの詳細

使用法

• 入力位置がラスタの場合、一連の位置セルはゼロ以上の値を持つすべてのセルから構成されます。値が NoData のセルは、ロケーション セットには含まれません。位置ラスタは、[抽出] ツールを使用して簡単に作成できます。

• 入力ラスタ内で NoData セルをサンプリングする位置には、NULL 値が与えられます。シェープファイルの場合、NULL はサポートされていないため値は 0（ゼロ）になります。

• 整数である入力ラスタ内のラスタに対しては、リサンプリング手法に [BILINEAR] または [CUBIC] オプションが選択されていても、セルの値は整数のままです。

• 入力ラスタと位置ラスタのセル サイズと位置は同じである必要があります。

• このツールの出力は、テーブルです。

構文

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	サンプリングされたセル値を保持する出力テーブル。	Table
resampling_type （オプション）	ラスタのサンプリング時に使用されるリサンプリング アルゴリズム。 NEAREST — 最近隣内挿法。 BILINEAR — 共一次内挿法。 CUBIC — 三次たたみ込み内挿法。	String

コードのサンプル

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)

環境

セル サイズ, 現在のワークスペース, マスク, 出力データの座標系, 範囲, テンポラリ ワークスペース, スナップ対象ラスタ

ライセンス情報

ArcView: 必須 Spatial Analyst

ArcEditor: 必須 Spatial Analyst

ArcInfo: 必須 Spatial Analyst