抽出値 → ポイント（Extract Values to Points） (Spatial Analyst)
サマリ
一連のポイント フィーチャに基づいてラスタのセル値を抽出し、その値を出力フィーチャクラスの属性テーブルに記録します。
使用法
出力ポイント フィーチャクラスは、入力ポイント フィーチャのすべてのフィールドを含みます。
-
出力フィーチャクラスには、RASTERVALU という名前の新しいフィールドが追加されます。
注意:このフィールドは、まだ入力フィーチャの属性テーブルに存在することはできません。存在すると、エラーになります。元の情報を保持しておきたい場合は、[抽出値 → ポイント（Extract Values to Points）] を実行する前に、新しいフィールド（RASVAL1 など）を属性テーブルに追加し、値をそのフィールドに算入した後で、元の RASTERVALUE フィールドを削除します。
-
マルチバンド ラスタで [抽出値 → ポイント（Extract Values to Points）] を使用すると、RASTERVALU フィールドに入力ラスタの最後のバンドの値が入ります。複数のラスタまたはマルチバンド ラスタ データセットから値を抽出する場合は、[複数の抽出値 → ポイント（Extract Multi Values To Points）] ツールを使用します。
-
ラスタの値が NoData のセルについては、属性テーブルの RASTERVALU フィールドに値 -9999 が与えられます。
-
内挿オプションは、ラスタから値を取得する方法を決定します。デフォルト オプションでは、サンプリング中のセルの中央にある値を使用します。内挿オプションでは、共一次内挿法を使用してセル中心の値が内挿されます。
-
入力ラスタが浮動小数点タイプの場合、出力ポイント データセットには、入力フィーチャ データの属性と、内挿オプションによって得られたセルの値のみが入ります。
-
入力ラスタから属性を追加するときに、出力ポイント フィーチャ データセットがシェープファイルの場合は、名前の長さが 10 文字を超えるフィールドが入力ラスタにあってはなりません。そのようなフィールドがあるときは、ツールを使用する前に名前を変更する必要があります。
マルチポイント データセットは、入力としてサポートされていません。
構文
| パラメータ | 説明 | データ タイプ |
in_point_features |
ラスタ セル値の抽出元の場所を指定する入力ポイント フィーチャ。 | Feature Layer |
in_raster |
値を抽出するラスタ データセット。 整数タイプまたは浮動小数点タイプのいずれのラスタでも構いません。 | Raster Layer |
out_point_features |
抽出されたラスタ値を含む出力ポイント フィーチャ データセット。 | Feature Class |
interpolate_values (オプション) |
内挿を使用するかどうかを指定します。
| Boolean |
add_attributes (オプション) |
ラスタの属性を出力ポイント フィーチャ データセットに書き込むかどうかを決定します。
| Boolean |
コードのサンプル
この例では、ポイント シェープファイルによって指定された位置にあるラスタのセル値を抽出し、その値を持つ出力ポイント フィーチャクラスを作成します。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ExtractValuesToPoints("rec_sites.shp", "elevation",
"C:/sapyexamples/output/outValPnts","INTERPOLATE",
"VALUE_ONLY")
この例では、ポイント シェープファイルによって指定された位置にあるラスタのセル値を抽出し、その値を持つ出力ポイント シェープファイルを作成します。
# Name: ExtractValuesToPoints_Ex_02.py
# Description: Extracts the cells of a raster based on 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
inPointFeatures = "rec_sites.shp"
inRaster = "elevation"
outPointFeatures = "C:/sapyexamples/output/extractvaluespts.shp"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")