Spatial Analyst のライセンスで利用可能。
概要
定義された位置のラスターまたは一連のラスターからのセルの値を表示するテーブルを作成します。位置は、ラスター セルまたは一連のポイントによって定義されます。
入力ラスターは 2 次元または多次元です。入力ラスターが多次元の場合、出力テーブルの構造が変わります。
使用法
セル値は、各位置にあるすべての入力ラスターから抽出されます。各入力ラスターのセル値を含むフィールドを使用して、テーブルが作成されます。
入力ラスター テーブルからの追加属性 (存在する場合) は、出力テーブルに含まれません。
解析環境では、入力ラスターはリサンプリングされません。代わりに、値が抽出されるラスターの空間参照に入力位置を投影することによって、元の解像度および空間参照ですべての入力ラスターからセル値が抽出されます。
ただし、解析環境は入力位置に適用されます。
入力ラスター内で NoData セルから値を抽出する位置には、出力テーブルで NULL 値が与えられます。シェープファイルでは、NULL フィールドがサポートされていないため、NoData セルは -9999 の値でテーブルに表示されます。
[入力ラスター] (Python では in_rasters) には、任意のラスターの組み合わせ (シングル バンドまたはマルチバンド) を指定できます。
[入力ラスター] (Python では in_rasters) の 1 つとしてマルチバンド ラスターが指定された場合、その入力のすべてのバンドが使用されます。
入力マルチバンド ラスターから選択したバンドを処理するには、まず、[コンポジット バンド (Composite Bands)] ツールを使用して、それら特定のバンドから構成される新しいラスター データセットを作成します。その結果を入力ラスターのリストで使用します。
入力位置データがラスターの場合、有効な値 (NoData ではない) を含む各セルの中心を使用して、その位置におけるすべての入力ラスターからセル値が抽出されます。
入力位置データがポイント フィーチャクラスで、空間インデックスを含まない場合は、警告が表示されます。大規模な入力ポイント フィーチャのツール パフォーマンスを向上させるには、空間インデックスを作成します。
マルチポイント フィーチャでは、ツールの実行に失敗します。マルチポイント フィーチャを使用して解析を実行するには、抽出ツールでマルチポイント フィーチャを使用する前に、まずシングルポイント フィーチャに変換します。詳細については、「マルチポイント データの処理」をご参照ください。
出力サンプルテーブルの X、Y 座標の空間参照は、[出力座標系] 環境で指定されていない限り、[入力ロケーション ラスター、またはポイント フィーチャ] (Python では in_location_data) の空間参照と同じです。入力位置データの空間参照が不明の場合、X、Y 座標の空間参照も不明となります。
X、Y 座標の空間参照は、ツールの実行完了時にジオプロセシング メッセージとして識別されます。
[リサンプリング手法] (Python では resampling_type) オプションは、ラスターから値を取得する方法を決定します。デフォルトのオプションは [最近接] で、入力位置の正確なセル値を抽出します。内挿値を抽出するには、[共一次内挿法] または [三次たたみ込み内挿法] オプションを指定します。
セル値を含むフィールドタイプは、最近接オプションのラスター タイプと一致します。ただし、内挿値の精度を保持するために、フィールド タイプは常に [共一次内挿法] または [三次たたみ込み内挿法] オプションの浮動小数点になります。リサンプリング オプションが [最近接] に設定されている場合、出力テーブルのフィールドはラスター タイプのフィールドと一致します。ただし、内挿値の精度を保持するために、フィールド タイプは常に [共一次内挿法] または [三次たたみ込み内挿法] オプションの浮動小数点になります。
Sample_point という名前のフィールドが出力テーブルに追加され、[一意の ID フィールド] (Python では unique_id_field) に指定された値が格納されます。詳細に分析するには、各位置の識別子として個別値を含むフィールドを使用することをお勧めします。
入力ラスターとして多次元ラスターが指定され、[多次元として処理] パラメーターがオンでない (Python では ALL_SLICES パラメーターが process_as_multidimensional) の場合、多次元ラスターの現在のスライスのみがサンプリングされます。
入力多次元データセットから、すべての変数のすべてのスライスから値を抽出するには、[多次元として処理] パラメーターをオンにします。
[多次元として処理] パラメーターがオンになっている場合 (Python では ALL_SLICES パラメーターが process_as_multidimensional) の場合、次のようになります。
このツールは、1 つの多次元ラスターのみを処理します。複数の多次元ラスターを指定した場合、最初のラスターだけが処理されます。
抽出された値は、変数と同じ名前のフィールドに格納されます。ディメンションと同じ名前の空間ディメンション以外のディメンション値を格納するための追加フィールドが作成されます。
多次元ラスターに複数のバンドがある場合、各バンドに対して追加のフィールドは作成されません。代わりに、バンドに対して抽出された値が変数フィールドに格納されます。バンドの指定に使用されたディメンションの追加フィールドが作成され、ディメンション値が格納されます。
このツールの多次元処理で、現在サポートされている多次元ラスターのタイプは、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 (オプション) | ラスターのサンプリング時に使用されるリサンプリング アルゴリズム。
| 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)
環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst