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

サマリー

1 つ以上のラスターから、ポイント フィーチャクラスで指定された位置にあるセル値を抽出し、その値をポイント フィーチャクラスの属性テーブルに記録します。

使用法

  • このツールは、入力ポイント フィーチャを変更し、ObjectID、FID、または OID という名前の内部フィーチャ ID を変更することができます。 解析を実行する前に、属性テーブルに一意の ID フィールドを含めることをお勧めします。

  • セル値は、各位置にあるすべての入力ラスターから抽出されます。 各入力ラスターのセル値を含む新しいフィールドが入力ポイント フィーチャクラスに追加されます。

  • 入力ラスター テーブルからの追加属性 (存在する場合) は、入力ポイント フィーチャに追加されません。

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

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

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

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

  • [入力ポイント フィーチャ] (Python では in_point_features) の値の定義に XY イベント レイヤーが使用されている場合は、基になるイベント テーブルが直接更新されます。 基になるテーブルが読み取り専用の場合は、ツールが正常に実行されません。

  • [入力ポイント フィーチャ] の値が、空間インデックスを含まないポイント フィーチャクラスの場合は、警告が表示されます。 入力に多数のポイントが含まれている場合にツールのパフォーマンスを向上させるには、空間インデックスを作成します。 詳細については、[空間インデックスの追加 (Add Spatial Index)] ツールをご参照ください。

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

  • [入力ラスター] (Python では in_rasters) パラメーターには、任意のラスターの組み合わせ (シングル バンドまたはマルチバンド) を指定できます。

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

    入力マルチバンド ラスターから選択したバンドを処理するには、まず、[コンポジット バンド (Composite Bands)] ツールを使用して、それら特定のバンドから構成されるラスター データセットを作成します。 次にその結果を入力ラスターのリストで使用します。

  • 入力がマルチバンド ラスターの場合、すべてのバンドのフィールドが追加され、出力フィールドの名前にバンド数を表す「b1_, b2_, …bn」という接頭辞が追加されます。

  • デフォルトでは、入力ラスターの名前から出力フィールド名が作成されます。ラスター値を格納する各フィールドに一意の名前を使用することもできます。

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

  • マスク環境でフィーチャが指定されている場合は、入力ラスターの最小セル サイズを使用して内部ラスターが作成されます。 抽出時に、この内部マスク ラスターが各入力ラスターのセル サイズに従って再度リサンプリングされます。

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

パラメーター

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

ラスター値が追加される入力ポイント フィーチャ。

Feature Layer
入力ラスター

入力ポイント フィーチャの位置に基づいて抽出される入力ラスターの値。

オプションで、ラスター値を格納するフィールドの名前を指定できます。 デフォルトでは、入力ラスターのデータセット名に基づいて、一意のフィールド名が作成されます。

Extract Values
ポイントの位置で値を共一次内挿
(オプション)

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

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

派生した出力

ラベル説明データ タイプ
更新されたポイント フィーチャ

更新されたポイント フィーチャ。

Feature Class

ExtractMultiValuesToPoints(in_point_features, in_rasters, {bilinear_interpolate_values})
名前説明データ タイプ
in_point_features

ラスター値が追加される入力ポイント フィーチャ。

Feature Layer
in_rasters
[Raster, {Output Field Name}]

入力ポイント フィーチャの位置に基づいて抽出される入力ラスターの値。

オプションで、ラスター値を格納するフィールドの名前を指定できます。 デフォルトでは、入力ラスターのデータセット名に基づいて、一意のフィールド名が作成されます。

Extract Values
bilinear_interpolate_values
(オプション)

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

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

派生した出力

名前説明データ タイプ
out_point_features

更新されたポイント フィーチャ。

Feature Class

コードのサンプル

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

複数のラスターからポイント シェープファイル フィーチャクラスの属性にセル値を抽出します。

import arcpy
from arcpy.sa import *
from arcpy import env 
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"], 
                           ["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
ExtractMultiValuesToPoints の例 2 (スタンドアロン スクリプト)

内挿を使用して、複数のラスターからポイント シェープファイル フィーチャクラスの属性にセル値を抽出します。

# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
#    an output point feature class.  This example takes a multiband IMG
#    and two GRID files as input.
# 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 = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"], 
                ["redmin", "focalmin"]]

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")

関連トピック