流出点のスナップ(Snap Pour Point) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

指定した距離内で累積流量が最も大きいセルへ流出点をスナップします。

使用法

構文

SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})
パラメータ説明データ タイプ
in_pour_point_data

スナップされる入力の流出点の位置。

ラスタ入力の場合、NoData でない(値を持つ)すべてのセルは流出点と見なされ、スナップされます。

ポイント フィーチャ入力の場合は、スナップされるセルの位置を指定します。

Raster Layer | Feature Layer
in_accumulation_raster

入力累積流量ラスタ。

これは、[累積流量ラスタの作成(Flow Accumulation)] ツールで作成できます。

Raster Layer
snap_distance

累積流量の大きなセルを検索する最大距離(マップ単位)。

Double
pour_point_field
(オプション)

流出点の位置に値を割り当てるために使用するフィールド。

流出点データセットがラスタの場合は、Value フィールドを使用します。

流出点データセットがフィーチャの場合は、数値フィールドを使用します。フィールドが浮動小数点値を含む場合は、切り捨てられて整数値に変換されます。

Field

戻り値

名前説明データ タイプ
out_raster

元の流出点の位置が累積流量の大きい位置にスナップされる、出力の流出点の整数ラスタ。

Raster

コードのサンプル

SnapPourPoint(流出点のスナップ ラスタの作成)の例 1(Python ウィンドウ)

次の例では、指定した距離内で累積流量が最も大きいセルへの流出点をスナップしています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSnapPour = SnapPourPoint("pourpoint", "flowaccumulation.img", 5,"VALUE") 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt01")
SnapPourPoint(流出点のスナップ ラスタの作成)の例 2(スタンドアロン スクリプト)

次の例では、指定した距離内で累積流量が最も大きいセルへの流出点をスナップしています。

# Name: SnapPourPoints_Ex_02.py
# Description: Snaps pour points to the cell of highest 
#              flow accumulation within a specified distance.
# 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
inPourPoint = "pourpoint"
inFlowAccum = "flowaccumulation.img"
tolerance = 5
pourField = "VALUE"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance, 
                            pourField) 

# Save the output 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
9/17/2013