サンプル (Image Analyst ツール)
サマリー
定義された位置のラスターまたは一連のラスターからのセルの値を表示するテーブルまたはポイント フィーチャクラスを作成します。 位置は、ラスター セル、ポイント、ポリライン、またはポリゴンによって定義されます。
使用法
セル値は、各位置にあるすべての 入力ラスター (Python では in_rasters) から抽出されます。 各入力ラスターのセル値を含むフィールドを使用して、テーブルまたはポイント フィーチャクラスが作成されます。
入力ラスター テーブルからの追加属性 (存在する場合) は、出力テーブルに含まれません。
入力ラスターには、任意のラスターの組み合わせ (シングル バンドまたはマルチバンド) を指定できます。 入力ラスターが多次元の場合、出力テーブルの構造が自動的に変わります。
入力ラスター の 1 つとしてマルチバンド ラスターが指定された場合、その入力のすべてのバンドが使用されます。
入力ロケーション ラスターまたはフィーチャ (Python では in_location_data) パラメーター値として以下の値を使用できます:
Raster—有効な値 (NoData 以外) を含むセルを使用して、すべての入力ラスターからセル値を抽出し、ポイント位置にはセルの中心を使用します。
Point—各ポイント位置で値がサンプリングされます。
Polyline or polygon—入力が 2 次元ラスターまたは複数のラスターの場合に、各ポリラインまたはポリゴンと交差するすべてのセルの平均値が計算されます。 入力が多次元ラスターで多次元として処理される場合、追加の統計情報タイプを指定できます。
入力ラスターの NoData セルから値を抽出する位置には、出力テーブルで <null> 値が割り当てられます。 シェープファイルの場合、NULL フィールドはサポートされていないため、NoData セルはテーブル内で代わりに値 -9999 で表されます。
入力ラスター は、ネイティブの空間参照および空間解像度でサンプリングされます。 空間参照の異なる複数の入力ラスターがある場合、まず入力位置が各ラスターの空間参照に個別に投影変換され、次に値が抽出されます。 つまり、入力ラスターは解析の環境設定を適用しませんが、入力位置には適切な環境が適用されます。
デフォルトでは、出力テーブルまたはフィーチャクラス (Python では out_table) パラメーターの X、Y 座標の空間参照は、出力座標系環境で別の値が指定されていない限り、入力ロケーション ラスターまたはフィーチャ パラメーターの値と同じになります。 入力位置データの空間参照が不明の場合、X、Y 座標の空間参照も不明となります。
X、Y 座標の空間参照は、ツールの実行完了時にジオプロセシング メッセージとして報告されます。
入力ロケーション ラスターまたはフィーチャ が空間インデックスを含まないポイント フィーチャクラスの場合、警告が表示されます。 入力に多数のポイントが含まれている場合にツールのパフォーマンスを向上させるには、空間インデックスを作成します。 詳細については、空間インデックスの追加をご参照ください。
マルチポイント フィーチャを使用して実行すると、このツールは失敗します。 マルチポイント フィーチャを使用して解析を実行するには、この抽出ツールで使用する前に、フィーチャをシングルポイント フィーチャに変換します。 詳細については、マルチポイント データの処理をご参照ください。
リサンプリング手法 パラメーターが 最近接 (Python では resampling_type = "NEAREST") に設定されている場合、出力テーブルのフィールド タイプはラスター タイプのフィールドと一致します。 このリサンプリング オプションが 共一次内挿法 または 三次たたみ込み内挿法 の場合、内挿値の精度を維持するために、フィールド タイプは常に浮動小数点になります。
フィールドが出力テーブルに追加され、一意の ID フィールド パラメーター (Python では unique_id_field) に指定された値が格納されます。 デフォルトでは、このフィールドの名前は入力位置データセット名と同じになります。 さらに詳しく解析するために、各位置の識別子として個別値を含むフィールドを使用することをおすすめします。
多次元として処理 パラメーターがオフ (Python では process_as_multidimensional = "CURRENT_SLICE") の場合、次の条件が適用されます。
入力が多次元ラスターである場合、現在のスライスのみがサンプリングされます。
入力が多変量ラスターである場合、現在の変数のみがサンプリングされます。
多次元として処理 パラメーターがオン (Python では process_as_multidimensional = "ALL_SLICES") の場合、次の条件が適用されます。
入力が多次元ラスターである場合、すべてのスライスがサンプリングされます。
入力が多変量ラスターである場合、すべての変数がサンプリングされます。
入力が複数の変数を持つ多次元ラスターである場合、すべての変数のすべてのスライスがサンプリングされます。 変数は同じディメンションを持つ必要があります。
多次元として処理 パラメーターがオン (Python では process_as_multidimensional = "ALL_SLICES") の場合、次のうち適切なシナリオが適用されます。
サンプリングに使用する入力ラスターのサブセットを指定するには、位置データの取得情報 パラメーター (Python では acquisition_definition) を使用します。
ディメンション、開始値、終了値を指定すると、開始値および終了値内のスライスが処理されます。 デフォルトの終了値は最大ディメンション値です。 時間ディメンションの場合、値を標準形式で指定します。 それ以外のディメンションの場合、入力ラスターと同じ単位で値を指定します。
ディメンション、開始フィールド、および終了フィールドを指定すると (開始フィールドと終了フィールドは位置データから取得される)、これらのフィールドの値を使用して、該当の位置で値をサンプリングする際の入力ラスターのサブセットが指定されます。
相対値または日前 および 相対値または日後 の値を使用して、開始値に対するサブセットを指定できます。「日前」の値はサブセットの開始を指定し、「日後」の値はサブセットの終了を指定します。 時間値は日数で、その他のディメンション値は入力ラスターと同じ単位で指定します。
統計の種類 パラメーター (Python では statistics_type) は、サブセットによって 位置データの取得情報 パラメーターに指定された 入力ラスター パラメーターの値を集約します。
列方向レイアウト パラメーターがオフ (Python では layout = "ROW_WISE") の場合、抽出された値は、変数と同じ名前のフィールドに格納されます。 ディメンションと同じ名前の空間ディメンション以外のディメンション値を格納するための追加フィールドが作成されます。
列方向レイアウト パラメーターがオン (Python では layout = "COLUMN_WISE") の場合、抽出された値は、命名規則
<variable_name>_<dimension_name>_<dimension_value>に従う名前のフィールドに格納されます。 列方向レイアウト パラメーターがサポートされているのは、多次元ラスターに含まれる変数が 1 つだけの場合、変数に 1 つのディメンションしかない場合、および各スライスがシングル バンドの場合のみですので注意してください。 それ以外の場合は、エラー メッセージが生成されます。多次元ラスターに複数のバンドがある場合、各バンド用の追加フィールドが作成され、そのバンドから抽出された値がそこに格納されます。
NoData セルから値を抽出する位置には、入力多次元ラスターから NoData 値が割り当てられます。
多次元ラスターは、NetCDF ラスター レイヤー、多次元ラスター レイヤー、多次元モザイク データセット、多次元 CRF、多次元イメージ サービス、または NetCDF ファイルにすることができます。 ツール ダイアログ ボックスから NetCDF ファイルを参照することはできませんが、ファイルのパスを指定できます。
フィーチャクラスの生成 パラメーターがオン (Python では generate_feature_class = "FEATURE_CLASS") の場合、出力は、サンプリング値が属性テーブルに格納されたポイント フィーチャクラスになります。 使用可能な位置情報の種類および値のサンプリング方法に関する説明を次に示します。
Raster—セルの中心位置を使用してポイントが作成されます。
Point—それぞれのポイント位置でポイントが作成されます。
Polyline or polygon—それぞれのポリゴンまたはポリラインの重心でポイントが作成されます。
出力フィーチャクラスの空間参照は、出力座標系環境で指定されていない限り、入力ロケーション ラスターまたはフィーチャ と同じです。
並列処理ファクター環境がサポートされているのは、多次元として処理 パラメーターがオンの場合のみです。
マスク環境でフィーチャが指定されている場合は、入力ラスターの最小セル サイズを使用して内部ラスターが作成されます。 抽出時に、この内部マスク ラスターが各入力ラスターのセル サイズに従って再度リサンプリングされます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力ラスター |
入力ロケーション データに基づいてサンプリングされる値を持つラスター。 多次元として処理 パラメーターは、入力が単一の多次元ラスターである場合のみ利用可能です。 |
Raster Layer |
|
入力ロケーション ラスターまたはフィーチャ |
サンプリングを行う位置を指定するデータ。 入力はラスターまたはフィーチャクラスにすることができます。 |
Raster Layer; Feature Layer |
|
出力テーブルまたはフィーチャクラス |
サンプリングされたセル値を格納する出力テーブルまたはフィーチャクラス。 出力形式は出力場所とパスによって決定されます。 デフォルトでは、出力は、ジオデータベース ワークスペースまたは dBASE テーブル内のジオデータベース テーブルまたはジオデータベース フィーチャクラス、またはフォルダー ワークスペース内のシェープファイル フィーチャクラスになります。 テーブルまたはフィーチャクラスを生成する出力データ タイプは、フィーチャクラスの生成 パラメーターによって制御されます。 |
Table; Point feature class |
|
リサンプリング手法 (オプション) |
ラスターから値を取得する方法を決定するために、ラスターのサンプリング時に使用されるリサンプリング アルゴリズム。
|
String |
|
一意の ID フィールド (オプション) |
入力ロケーション ラスターまたはフィーチャのすべての位置またはフィーチャについて異なる値を含んでいるフィールドです。 |
Field |
|
多次元として処理 (オプション) |
入力ラスターの処理方法を指定します。 このパラメーターは、入力が単一の多次元ラスターである場合のみ利用可能です。
|
Boolean |
|
位置データの取得情報 (オプション) |
位置フィーチャに関連付けられている時間、深度、その他の取得データを指定します。 次の組み合わせのみがサポートされています。
相対値または日前 および 相対値または日後 は、負でない値のみをサポートしています。 統計の種類 パラメーターを使用して、このディメンション範囲内にある変数の統計が計算されます。 値テーブル列:
|
Value Table |
|
統計の種類 (オプション) |
計算する統計の種類を指定します。
|
String |
|
パーセンタイル値 (オプション) |
統計の種類 パラメーターが パーセンタイル に設定されている場合に計算するパーセンタイル。 この値の範囲は 0 〜 100 です。 デフォルトは 90 です。 |
Double |
|
バッファー距離フィールドまたは値 (オプション) |
位置データ フィーチャの周囲の距離。 バッファー距離は、位置フィーチャの空間参照の距離単位で指定されます。 フィーチャが地理参照を使用している場合、単位は度になります。 統計は、このバッファー エリア内で計算されます。 |
Double; Field |
|
列方向レイアウト (オプション) |
サンプリングされた値が出力テーブルの行と列のどちらに表示されるかを指定します。
|
Boolean |
|
フィーチャクラスの生成 (オプション) |
属性テーブル内にサンプリング値を持つポイント フィーチャクラスを生成するか、サンプリング値を持つテーブルを生成するかを指定します。
|
Boolean |
環境
自動コミット, 範囲, 現在のワークスペース, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, 並列処理ファクター, スクラッチ ワークスペース
ライセンス情報
- Basic: Image Analyst または Spatial Analyst が必要
- Standard: Image Analyst または Spatial Analyst が必要
- Advanced: Image Analyst または Spatial Analyst が必要