流域 (Spatial Analyst ツール)

サマリー

すべての流域の形状を表すラスターを作成します。

使用法

流域は、流域間の尾根線を特定することで、解析ウィンドウ内に描画されます入力流向ラスターは、同じ流域に属する接続された一連のセルを見つけるための解析に使用されます。流域は、解析ウィンドウの端にある流出点 (ラスター内から水が流れ出る場所) やシンクを特定してから、各流出点の流出寄与域を識別することで作成されます。これにより、流域のラスターが作成されます。
D8 入力流向ラスターを作成するには、デフォルトの流向タイプ D8 を使用して流向ツールを実行する必要があります。

このツールによって D8 入力流向ラスターが作成され、エッジにあるセルはすべて外側に流出 オプション (Python では FORCE) が使用されている場合に、最善の結果が得られます。
ラスター内のすべてのセルは、流域が 1 つのセルだけであっても、いずれかの流域に属します。
出力ラスターの形式が .crf の場合、このツールはピラミッドラスター格納環境をサポートします。デフォルトでは、ピラミッドは出力で作成されます。その他の出力形式ではこの環境はサポートされず、ピラミッドは作成されません。
このツールは GPU により処理を加速化できます。つまり、システムで互換性のある GPU (グラフィックス処理装置) を使用可能な場合は、その GPU を使用してツールのパフォーマンスを強化できます。このツールの実行に GPU と CPU のどちらを使用するかを制御するには、解析のターゲットデバイス パラメーター (Python では analysis_target_device) を使用します。

互換性のある GPU、GPU デバイスの構成と操作、トラブルシューティングのヒントの詳細については、Spatial Analyst での GPU 処理をご参照ください。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル説明データタイプ

ラベル	説明	データタイプ
D8 入力流向ラスター	各セルからの流れの方向を示す入力ラスター。流向ラスターは、流向ツールでデフォルトの `D8` 流向タイプを使用して作成できます。	Raster Layer
解析のターゲットデバイス (オプション)	計算の実行に使用するデバイスを指定します。 GPU の後で CPU—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合は、CPU が使用されます。これがデフォルトです。 CPU のみ—計算は CPU でのみ実行されます。 GPU のみ—計算は GPU でのみ実行されます。	String

D8 入力流向ラスター

各セルからの流れの方向を示す入力ラスター。

流向ラスターは、流向ツールでデフォルトの D8 流向タイプを使用して作成できます。

Raster Layer

解析のターゲットデバイス

(オプション)

計算の実行に使用するデバイスを指定します。

GPU の後で CPU—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合は、CPU が使用されます。これがデフォルトです。
CPU のみ—計算は CPU でのみ実行されます。
GPU のみ—計算は GPU でのみ実行されます。

String

戻り値

ラベル	説明	データタイプ
出力ラスター	流域を表す出力ラスター。出力は整数型になります。	Raster

ラベル

説明

データタイプ

出力ラスター

流域を表す出力ラスター。

出力は整数型になります。

Raster

Basin(in_flow_direction_raster, {analysis_target_device})

名前説明データタイプ

名前	説明	データタイプ
in_flow_direction_raster	各セルからの流れの方向を示す入力ラスター。流向ラスターは、流向ツールでデフォルトの `D8` 流向タイプを使用して作成できます。	Raster Layer
analysis_target_device (オプション)	計算の実行に使用するデバイスを指定します。 `GPU_THEN_CPU`—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合は、CPU が使用されます。これがデフォルトです。 `CPU_ONLY`—計算は CPU でのみ実行されます。 `GPU_ONLY`—計算は GPU でのみ実行されます。	String

in_flow_direction_raster

各セルからの流れの方向を示す入力ラスター。

流向ラスターは、流向ツールでデフォルトの D8 流向タイプを使用して作成できます。

Raster Layer

analysis_target_device

(オプション)

計算の実行に使用するデバイスを指定します。

GPU_THEN_CPU—互換性のある GPU が検出された場合、その GPU を使用して計算が実行されます。検出されなかった場合は、CPU が使用されます。これがデフォルトです。
CPU_ONLY—計算は CPU でのみ実行されます。
GPU_ONLY—計算は GPU でのみ実行されます。

String

戻り値

名前	説明	データタイプ
out_raster	流域を表す出力ラスター。出力は整数型になります。	Raster

名前

説明

データタイプ

out_raster

流域を表す出力ラスター。

出力は整数型になります。

Raster

コードのサンプル

Basin 例 1 (Python ウィンドウ)

次の例では、GPU での入力流向 TIFF ラスターの流域を決定しています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBasin = Basin("flowdir.tif", "GPU_ONLY") # to select the GPU_ONLY option 
outBasin.save("C:/sapyexamples/output/outbasin01.tif")

Basin 例 2 (スタンドアロンスクリプト)

次の例では、CPU での入力流向 TIFF ラスターの流域を決定しています。

# Name: Basin_Ex_02.py
# Description: Creates a raster delineating all drainage basins.
# 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
inFlowDirectionRaster = "flowdir.tif"
targetAnalysisDevice = "CPU_ONLY" # to select computation on CPU only 

# Run FlowDirection
outBasin = Basin(inFlowDirectionRaster, targetAnalysisDevice)

# Save the output
outBasin.save("C:/sapyexamples/output/outbasin02.tif")

環境

自動コミット, セルサイズ, セルサイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, GPU ID, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, プロセッサータイプ, ピラミッド, スクラッチワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要

流域 (Spatial Analyst ツール)

サマリー

使用法

パラメーター

戻り値

環境

ライセンス情報

関連トピック