サンプル（Sample） (Spatial Analyst)
サマリ
定義された位置のラスタまたは一連のラスタからのセルの値を表示するテーブルを作成します。位置は、ラスタ セルまたは一連のポイントによって定義されます。
使用法
-
入力位置がラスタの場合、一連の位置セルはゼロ以上の値を持つすべてのセルから構成されます。値が NoData のセルは、ロケーション セットには含まれません。位置ラスタは、[抽出] ツールを使用して簡単に作成できます。
-
入力ラスタ内で NoData セルをサンプリングする位置には、出力ジオデータベース テーブルで NULL 値が与えられます。INFO または *.dbf の場合への出力の場合、NULL の概念はサポートされていないため、値は 0（ゼロ）になります。
-
出力テーブル内でサンプリングされた値のフィールドのタイプは、必ず浮動小数になります。これにより、リサンプリング手法に [BILINEAR] または [CUBIC] オプションが選択されていても、適切な精度が維持されます。
-
位置入力がラスタの場合、最適な結果を得るには、入力ラスタと位置ラスタのセル サイズと位置は同じである必要があります。
-
このツールの出力は、テーブルです。
マルチポイント データセットは、入力としてサポートされていません。
構文
| パラメータ | 説明 | データ タイプ |
in_rasters [in_raster,...] |
入力位置データに基づいてサンプリングされる値を持つラスタのリスト。 | Raster Layer |
in_location_data |
サンプリングを行う位置を指定するデータ。 ラスタまたはポイント フィーチャ データセットが使用できます。 | Raster Layer | Feature Layer |
out_table |
サンプリングされたセル値を保持する出力テーブル。 テーブルの形式は、出力先とパスによって決定されます。拡張子を指定しない場合、INFO テーブルになります。位置がジオデータベース内の場合、出力テーブルはその特定のタイプで作成されます（ファイルまたは ArcSDE ジオデータベースなど）。名前に *.dbf 拡張子を付けると、出力は dBASE 形式になります。 | Table |
resampling_type (オプション) |
ラスタのサンプリング時に使用されるリサンプリング アルゴリズム。
| String |
コードのサンプル
入力位置に基づいて、複数のラスタからセル値をテーブルに抽出します。
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")
入力位置に基づいて、複数のラスタからセル値をテーブルに抽出します。
# 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)