Spatial Analyst のライセンスで利用可能。
サマリ
各セルから最も急な降下傾斜となる近傍セルへのフロー (流れ) の方向を示すラスターを作成します。
図
![[流向ラスターの作成 (Flow Direction)] の図](GUID-0AC2EB59-B9AD-4656-93D7-64B99505A76C-web.png "[流向ラスターの作成 (Flow Direction)] の図")
使用法
[流向ラスターの作成 (Flow Direction)] ツールの出力は、1 〜 255 の値を持つ整数ラスターです。中心からのそれぞれの方向の値は、次のようになります。
![[流向ラスターの作成 (Flow Direction)] のコード](GUID-DC135A95-CADF-468F-BF6E-E94BB724EB17-web.gif "[流向ラスターの作成 (Flow Direction)] のコード")
たとえば、降下傾斜が最も急な方向がある処理セルの左側である場合、フロー方向は 16 とコード化されます。
あるセルが 8 つの近傍セルより低い場合、そのセルには近傍セルの最低値が与えられ、フローはこのセルの方向に定義されます。複数の近傍セルが最低値を持つ場合、セルにはこの値が与えられますが、フローは以下で説明する 2 つの方法のいずれかを使用して定義されます。これは、1 セルの窪地 (シンク) をフィルターするために使用され、ノイズと見なされます。
セルが複数の方向で同じ Z 値の変化を持ち、そのセルが窪地 (シンク) の一部である場合、フロー方向は未定義と見なされます。このような場合、出力流向ラスターのセルの値は、それらの方向の合計となります。たとえば、Z 値の変化が右 (フロー方向 = 1) と下 (フロー方向 = 4) で同じ場合、そのセルのフロー方向は 1 + 4 = 5 になります。未定義のフロー方向を持つセルは、[窪地の抽出 (Sink)] ツールを使用して、窪地 (シンク) としてフラグを付けることができます。
セルが複数の方向で同じ Z 値の変化を持ち、窪地 (シンク) の一部でない場合、フロー方向は可能性が最も高い方向を定義するルックアップ テーブルを使用して割り当てられます。「Greenlee (1987) 」をご参照ください。
出力降下率ラスターは、Z 値の差をセルの中心間のパス長で除算したもので、パーセンテージで表されます。隣接セルの場合、これは、セル間の傾斜角 (パーセント) に似ています。平らな エリアでは、距離は標高が低い最も近いセルまでの距離になります。結果は、各セルからの降下傾斜が最も急激なパスのパーセント高低差のマップになります。
平らなエリアで降下率ラスターを計算する場合、対角線上の隣接セルへの距離 (1.41421 * cell size) は、性能を改善するために 1.5 * cell size で近似されます。
[エッジにあるセルはすべて外側に流出] パラメーターをデフォルトのオフの設定 (Python では NORMAL) にした場合、サーフェス ラスターのエッジにあるセルは、Z 値の降下率が最も高く、セルの内部に向かって流れます。降下がゼロ以下の場合、セルはサーフェス ラスターの外に流れ出ます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
FlowDirection (in_surface_raster, {force_flow}, {out_drop_raster})| パラメータ | 説明 | データ タイプ |
in_surface_raster | 連続サーフェスを表す入力ラスター。 | Raster Layer |
force_flow (オプション) | エッジ セルが常に外向きに流れるか、通常のフロー規則に従うかを指定します。
| Boolean |
out_drop_raster (オプション) | オプションの出力降下率ラスター。 降下率ラスターは、フロー方向の各セルの標高の最大変化と、セルの中心間のパス長の比率をパーセントで返します。 出力は浮動小数点型になります。 | Raster Dataset |
戻り値
| 名前 | 説明 | データ タイプ |
| out_flow_direction_raster | 各セルから最も急な降下傾斜となる近傍セルへのフロー方向を示す出力ラスター。 出力は整数型になります。 | Raster |
コードのサンプル
FlowDirection (流向ラスターの作成) の例 1 (Python ウィンドウ)
次の例では、入力 Grid 標高サーフェス ラスターから、流向ラスターを作成しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowDirection = FlowDirection("elevation", "NORMAL")
outFlowDirection.save("C:/sapyexamples/output/outflowdir01")
FlowDirection (流向ラスターの作成) の例 2 (スタンドアロン スクリプト)
次の例では、入力 Grid 標高サーフェス ラスターから、流向ラスターを作成しています。
# Name: FlowDirection_Example.py
# Description: Creates a raster of flow direction from each cell to its
# steepest downslope neighbor.
# 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
inSurfaceRaster = "elevation"
outDropRaster = "C:/sapyexamples/output/dropraster"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outFlowDirection = FlowDirection(inSurfaceRaster, "FORCE", outDropRaster)
# Save the output
outFlowDirection.save("C:/sapyexamples/output/outflowdir02")
環境
ライセンス情報
- ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
- ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
- ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst