ポイントで抽出 (Spatial Analyst ツール)
サマリー
座標ポイントに基づいてラスターのセルを抽出します。
レガシー:
このツールは非推奨 となり、将来のリリースで削除される予定です。
マスクで抽出 ツールにより、機能とパフォーマンスが向上します。
図
OutRas = ExtractByPoints(InRas1, [Point(1.5,0.5),Point(1.5,4.5),Point(4.5,4.5),Point(4.5,0.5)], "INSIDE")
使用法
入力ラスターからの追加属性がある場合は、そのまま出力ラスター属性テーブルに引き継がれます。 記録されるプロパティに応じて、一部の属性値は再計算が必要な場合があります。
入力ラスター (Python では in_raster) の値としてマルチバンド ラスターが指定された場合、すべてのバンドが使用されます。
マルチバンド ラスターから選択したバンドを処理するには、まず、コンポジット バンド ツールを使用して、それら特定のバンドから構成されるラスター データセットを作成します。 次に、その結果を 入力ラスター (Python では in_raster) の値として使用します。
デフォルトの出力形式は、ジオデータベース ラスターです。 出力形式として Esri Grid スタックを指定した場合、スタックの名前を数字で開始したり、名前にスペースを使用したり、9 文字を超える名前にしたりすることはできません。
選択されていないセル位置には、値 NoData が割り当てられます。
入力ラスターが整数の場合、出力ラスターも整数になります。 入力が浮動小数点値である場合、出力も浮動小数点値になります。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
ラベル
説明
データ タイプ
入力ラスター
セルを抽出する入力ラスター。
Raster Layer
入力ポイント
ラスターから値を抽出するポイント。
ポイントは、入力ラスターと同じマップ単位で、X,Y 座標の組として指定されます。
Point
抽出エリア
(オプション)
指定したポイント位置に基づいてセルを抽出するか (内部)、ポイント位置の外のセルを抽出するか (外部) 識別します。
String
戻り値
ラベル
説明
データ タイプ
出力ラスター
入力ラスターから抽出したセル値が格納される出力ラスター。
Raster
ExtractByPoints(in_raster, points, {extraction_area})
名前
説明
データ タイプ
in_raster
セルを抽出する入力ラスター。
Raster Layer
points
[point,...]
Point クラス オブジェクトの Python リストは、値をラスターから抽出する位置を表します。
ポイント オブジェクトは、入力ラスターと同じマップ単位で、X,Y 座標のリストで指定されます。
オブジェクトの形式:
[point(x1,y1), point(x2,y2),...]
Point
extraction_area
(オプション)
指定したポイント位置に基づいてセルを抽出するか (内部)、ポイント位置の外のセルを抽出するか (外部) 識別します。
String
戻り値
名前
説明
データ タイプ
out_raster
入力ラスターから抽出したセル値が格納される出力ラスター。
Raster
コードのサンプル
ExtractByPoints 例 1 (Python ウィンドウ)
次の例では、指定したポイント座標に基づいてラスターからセルを抽出しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pointList = [arcpy.Point(743050, 4321275), arcpy.Point(743100, 4321200),
arcpy.Point(734500,4322000)]
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")
outPointExtract.save("c:/sapyexamples/output/pntextract")
ExtractByPoints 例 2 (スタンドアロン スクリプト)
次の例では、指定したポイント座標に基づいてラスターからセルを抽出しています。
# Name: ExtractByPoints_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
inRaster = "soil"
pointList = [arcpy.Point(743050, 4321275),
arcpy.Point(743100, 4321200),
arcpy.Point(743500, 4322000),
arcpy.Point(742900, 4321800)]
# Run ExtractByPoints
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")
# Save the output
outPointExtract.save("c:/sapyexamples/output/pntext")
環境
自動コミット , セル サイズ , セル サイズ投影法 , 圧縮 , 現在のワークスペース , 範囲 , 地理座標系変換 , マスク , 出力データのコンフィグレーション キーワード , 出力座標系 , スクラッチ ワークスペース , スナップ対象ラスター , タイル サイズ
ライセンス情報
Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要