抽出値 → ポイント (Spatial Analyst ツール)
サマリー
一連のポイント フィーチャに基づいてラスターのセル値を抽出し、その値を出力フィーチャクラスの属性テーブルに記録します。
複数の抽出値 → ポイント ツールにより、機能とパフォーマンスが向上します。
使用法
入力ポイント フィーチャクラスのすべてのフィールドは、出力ポイント フィーチャクラスに引き継がれます。
RASTERVALUと呼ばれる新しいフィールドが出力に追加され、抽出された値が格納されます。 入力フィーチャの属性テーブルにこの名前のフィールドがすでに存在する場合、ツールの実行は中止されます。入力ラスターは、解析環境を反映してリサンプリングされません。 代わりに、値の抽出元であるラスターの空間参照に入力位置を投影変換することで、セル値が入力ラスターから元の座標精度と空間参照で抽出されまます。
ただし、解析環境は入力位置に適用されます。
入力ラスターの NoData セルから値を抽出する位置には、出力テーブルで <null> 値が割り当てられます。 シェープファイルの場合、NULL フィールドはサポートされていないため、NoData セルはテーブル内で代わりに値 -9999 で表されます。
シェープファイル形式には、フィールド名の最大長が 10 文字という制限があります。 そのため、デフォルトでは、出力シェープファイルの属性テーブルに追加されるフィールド名は切詰められ、一意になります。 これにより、特に名前が長くて非常に似ている場合は、フィールド間の区別が難しくなる可能性があります。 この場合、ファイル ジオデータベースに出力することをお勧めします。
マルチポイント フィーチャを使用して実行すると、このツールは失敗します。 マルチポイント フィーチャを使用して解析を実行するには、この抽出ツールで使用する前に、フィーチャをシングルポイント フィーチャに変換します。 詳細については、マルチポイント データの処理をご参照ください。
入力ラスター (Python では
in_raster) の値としてマルチバンド ラスターが指定された場合、最初のバンドのみが使用されます。別のバンドを処理するには、使用するバンドを指定します。
複数のラスターまたはマルチバンド ラスター データセットから値を抽出する場合は、複数の抽出値 → ポイント ツールを使用します。
内挿オプションは、ラスターから値を取得する方法を決定します。 デフォルトのオプションは、入力位置の正確なセル値を抽出します。 共一次内挿法を使用して内挿値を抽出するには、ポイントの位置で値を内挿 (Python では
interpolate_values) オプションをオンにします。入力ラスター テーブルからすべての属性を追加するには、すべての入力ラスターの属性情報を出力ポイント フィーチャに追加 オプションをオン (Python では
add_attributesパラメーターをALL) にします。 属性は、同じ値のまま出力ポイント フィーチャに引き継がれます。 記録されるプロパティの特性に応じて、一部の属性値は再計算が必要な場合がありますので注意してください。出力座標系 環境が明示的に指定されていない場合、出力フィーチャクラスの空間参照は、入力ポイント フィーチャから生成されます。 ただし、出力座標系 環境の指定があってもなくても、フィーチャ データセットに出力が書き込まれる場合、出力空間参照はフィーチャ データセットと同じになります。
マスク 環境でフィーチャが指定されている場合は、入力ラスターのセル サイズとセルの配置を使用して、内部でラスターに変換されます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力ポイント フィーチャ |
ラスター セル値の抽出元の場所を指定する入力ポイント フィーチャ。 |
Feature Layer |
|
入力ラスター |
値を抽出するラスター データセット。 整数タイプまたは浮動小数点タイプのラスターを指定できます。 |
Raster Layer |
|
出力ポイント フィーチャ |
抽出されたラスター値を含む出力ポイント フィーチャ データセット。 |
Feature Class |
|
ポイントの位置で値を内挿 (オプション) |
内挿を使用するかどうかを指定します。
|
Boolean |
|
すべての入力ラスターの属性情報を出力ポイント フィーチャに追加 (オプション) |
ラスターの属性を出力ポイント フィーチャ データセットに書き込むかどうかを決定します。
|
Boolean |
環境
自動コミット, 現在のワークスペース, 出力データのデフォルト Z 値, 範囲, 地理座標系変換, マスク, M 座標精度, M 許容値, 出力データのコンフィグレーション キーワード, 出力座標系, 出力データに M 値を含む, 出力データに Z 値を含む, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, 完全に記述したフィールド名を保持, スクラッチ ワークスペース, フィールド ドメインの説明の転送, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値
ライセンス情報
- Basic: Spatial Analyst が必要
- Standard: Spatial Analyst が必要
- Advanced: Spatial Analyst が必要