抽出値 → ポイント (Extract Values to Points) (Spatial Analyst)

サマリー

一連のポイント フィーチャに基づいてラスターのセル値を抽出し、その値を出力フィーチャクラスの属性テーブルに記録します。

[複数の抽出値 → ポイント (Extract Multi Values to Points)] ツールにより、機能とパフォーマンスが向上します。

使用法

  • 入力ポイント フィーチャクラスのすべてのフィールドは、出力ポイント フィーチャクラスに引き継がれます。

  • RASTERVALU と呼ばれる新しいフィールドが出力に追加され、抽出された値が格納されます。 入力フィーチャの属性テーブルにこの名前のフィールドがすでに存在する場合、ツールの実行は中止されます。

  • 入力ラスターは、解析環境を反映してリサンプリングされません。 代わりに、値の抽出元であるラスターの空間参照に入力位置を投影変換することで、セル値が入力ラスターから元の座標精度と空間参照で抽出されまます。

    ただし、解析環境は入力位置に適用されます。

  • 入力ラスター内で NoData セルから値を抽出する位置には、出力テーブルで NULL 値が与えられます。 シェープファイルの場合、NULL フィールドはサポートされていないため、NoData セルはテーブル内で代わりに値 -9999 で表されます。

  • シェープファイル形式には、フィールド名の最大長が 10 文字という制限があります。 そのため、デフォルトでは、出力シェープファイルの属性テーブルに追加されるフィールド名は切詰められ、一意になります。 これにより、特に名前が長くて非常に似ている場合は、フィールド間の区別が難しくなる可能性があります。 この場合、ファイル ジオデータベースに出力することをお勧めします。

  • マルチポイント フィーチャを使用して実行すると、このツールは失敗します。 マルチポイント フィーチャを使用して解析を実行するには、この抽出ツールで使用する前に、フィーチャをシングルポイント フィーチャに変換します。 詳細については、「マルチポイント データの処理」をご参照ください。

  • [入力ラスター] (Python では in_raster) の値としてマルチバンド ラスターが指定された場合、最初のバンドのみが使用されます。

    別のバンドを処理するには、使用するバンドを指定します。

    複数のラスターまたはマルチバンド ラスター データセットから値を抽出する場合は、[複数の抽出値 → ポイント (Extract Multi Values To Points)] ツールを使用します。

  • 内挿オプションは、ラスターから値を取得する方法を決定します。 デフォルトのオプションは、入力位置の正確なセル値を抽出します。 共一次内挿法を使用して内挿値を抽出するには、[ポイントの位置で値を内挿] (Python では interpolate_values) オプションをオンにします。

  • 入力ラスター テーブルからすべての属性を追加するには、[すべての入力ラスターの属性情報を出力ポイント フィーチャに追加] オプションをオン (Python では add_attributes パラメーターを ALL) にします。 属性は、同じ値のまま出力ポイント フィーチャに引き継がれます。 記録されるプロパティの特性に応じて、一部の属性値は再計算が必要な場合がありますので注意してください。

  • [出力座標系] 環境が明示的に指定されていない場合、出力フィーチャクラスの空間参照は、入力ポイント フィーチャから生成されます。 ただし、[出力座標系] 環境の指定があってもなくても、フィーチャ データセットに出力が書き込まれる場合、出力空間参照はフィーチャ データセットと同じになります。

  • [マスク] 環境でフィーチャが指定されている場合は、入力ラスターのセル サイズとセルの配置を使用して、内部でラスターに変換されます。

  • このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル説明データ タイプ
入力ポイント フィーチャ

ラスター セル値の抽出元の場所を指定する入力ポイント フィーチャ。

Feature Layer
入力ラスター

値を抽出するラスター データセット。

整数タイプまたは浮動小数点タイプのラスターを指定できます。

Raster Layer
出力ポイント フィーチャ

抽出されたラスター値を含む出力ポイント フィーチャ データセット。

Feature Class
ポイントの位置で値を内挿
(オプション)

内挿を使用するかどうかを指定します。

  • オフ - 内挿は適用されません。セルの中心の値が使用されます。 これがデフォルトです。
  • オン - セルの値は、有効な値を持つ隣接するセルから共一次内挿法を使用して算出されます。 すべての隣接セルが NoData でない限り、内挿で NoData は無視されます。
Boolean
すべての入力ラスターの属性情報を出力ポイント フィーチャに追加
(オプション)

ラスターの属性を出力ポイント フィーチャ データセットに書き込むかどうかを決定します。

  • オフ - 入力ラスターの値だけがポイントの属性に追加されます。 これがデフォルトです。
  • オン - 入力ラスターの (Count を除く) すべてのフィールドがポイントの属性に追加されます。
Boolean

ExtractValuesToPoints(in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})
名前説明データ タイプ
in_point_features

ラスター セル値の抽出元の場所を指定する入力ポイント フィーチャ。

Feature Layer
in_raster

値を抽出するラスター データセット。

整数タイプまたは浮動小数点タイプのラスターを指定できます。

Raster Layer
out_point_features

抽出されたラスター値を含む出力ポイント フィーチャ データセット。

Feature Class
interpolate_values
(オプション)

内挿を使用するかどうかを指定します。

  • NONE内挿は適用されません。セルの中心の値が使用されます。 これがデフォルトです。
  • INTERPOLATE共一次内挿法を使用して、有効な値を持つ隣接セルからセルの値が計算されます。 すべての隣接セルが NoData でない限り、内挿で NoData は無視されます。
Boolean
add_attributes
(オプション)

ラスターの属性を出力ポイント フィーチャ データセットに書き込むかどうかを決定します。

  • VALUE_ONLY入力ラスターの値だけがポイントの属性に追加されます。 これがデフォルトです。
  • ALL入力ラスターの (Count を除く) すべてのフィールドがポイントの属性に追加されます。
Boolean

コードのサンプル

ExtractValuesToPoints の例 1 (Python ウィンドウ)

この例では、ポイント シェープファイルによって指定された位置にあるラスターのセル値を抽出し、その値を持つ出力ポイント フィーチャクラスを作成します。

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")
ExtractValuesToPoints の例 2 (スタンドアロン スクリプト)

この例では、ポイント シェープファイルによって指定された位置にあるラスターのセル値を抽出し、その値を持つ出力ポイント シェープファイルを作成します。

# 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"

# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
                      "INTERPOLATE", "VALUE_ONLY")