Spatial Analyst のライセンスで利用可能。
サマリー
定義された位置のラスターまたは一連のラスターからのセルの値を表示するテーブルを作成します。位置は、ラスター セルまたは一連のポイントによって定義されます。
入力ラスターは 2 次元または多次元です。入力ラスターが多次元の場合、出力テーブルの構造が変わります。
使用法
入力位置がラスターの場合、一連の位置セルはゼロ以上の値を持つすべてのセルから構成されます。値が NoData のセルは、ロケーション セットには含まれません。位置ラスターは、[抽出] ツールを使用して簡単に作成できます。
入力ラスター内で NoData セルをサンプリングする位置には、出力ジオデータベース テーブルで NULL 値が与えられます。INFO または .dbf の場合への出力の場合、NULL の概念はサポートされていないため、値は -9999 になります。
複数の多次元ラスターがある場合、これらは必ず同じディメンション名を共有する必要があります。
NetCDF ラスター レイヤーはサポートされている唯一の多次元タイプです。
入力ラスターに 2 次元ラスターと多次元ラスターが混在する場合、多次元ラスターの現在のスライスのみがサンプリングされます。
入力ラスターが 2 次元の場合、出力テーブル内のサンプリングされた値のフィールドのタイプは、必ず浮動小数になります。これにより、リサンプリング手法に共一次内挿法または三次たたみ込み内挿法オプションが選択されていても、適切な精度が維持されます。
位置入力がラスターの場合、最適な結果を得るには、入力ラスターと位置ラスターのセル サイズと位置は同じである必要があります。
このツールの出力は、テーブルです。
マルチポイント データセットは、入力としてサポートされていません。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と 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 (オプション) | ラスターのサンプリング時に使用されるリサンプリング アルゴリズム。
| String |
unique_id_field (オプション) | 入力位置ラスターまたはポイント フィーチャのすべての位置またはフィーチャについて異なる値を含んでいるフィールドです。 | Field |
process_as_multidimensional (オプション) | 入力ラスターの処理方法を指定します。
| 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)
環境
ライセンス情報
- ArcGIS Desktop Basic: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Standard: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Advanced: 次のものが必要 Spatial Analyst