集水域ラスタの作成(Watershed) (Spatial Analyst)
使用法
-
各集水域の値は、入力ラスタまたはフィーチャの流出点データのソースの値から取得されます。流出点がラスタ データセットの場合、セル値が使用されます。流出点がポイント フィーチャ データセットの場合、値は指定されたフィールドから取得されます。
-
良い結果を得るには、[流出点のスナップ(Snap Pour Point)] ツールを事前に使用して、累積流量の大きいセルへの流出点を特定します。
入力の流出点の位置をフィーチャ データとして指定する場合、デフォルトのフィールドは有効な最初のフィールドになります。有効なフィールドがない場合は、ObjectID フィールド(たとえば、OID や FID)がデフォルトになります。
構文
パラメータ | 説明 | データ タイプ |
in_flow_direction_raster |
各セルからの流れの方向を示す入力ラスタ。 流向ラスタは [流向ラスタの作成(Flow Direction)] ツールを使用して作成できます。 | Raster Layer |
in_pour_point_data |
入力流出点の位置。 ラスタの場合、これは流出寄与域または集水域を判別するセルを表します。NoData でないすべてのセルがソース セルとして使用されます。 ポイント フィーチャ データセットの場合、これは流出寄与域または集水域を判別する位置を表します。 | Raster Layer | Feature Layer |
pour_point_field (オプション) |
流出点の位置に値を割り当てるために使用するフィールド。 流出点データセットがラスタの場合は、Value フィールドを使用します。 流出点データセットがフィーチャの場合は、数値フィールドを使用します。フィールドが浮動小数点値を含む場合は、切り捨てられて整数値に変換されます。 | Field |
戻り値
名前 | 説明 | データ タイプ |
out_raster |
流出寄与域を示す出力ラスタ。 整数タイプになります。 | Raster |
コードのサンプル
次の例では、流向 GRID ラスタ上にある選択した流出点の位置に対する流出寄与域を判別しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outWatershed = Watershed("flowdir", "pourpoint")
outWatershed.save("C:/sapyexamples/output/outwtrshd01")
次の例では、流向 GRID ラスタ上にある選択した流出点の位置に対する流出寄与域を判別し、集水域を TIFF ラスタとして出力しています。
# Name: Watershed_Ex_02.py
# Description: Determines the contributing area above a set of cells in a
# raster.
# 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
inFlowDirection = "flowdir"
inPourPointData = "pourpoint"
inPourPointField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)
# Save the output
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")