ブリーチラインの生成 (Spatial Analyst ツール)

サマリー

水流の局所的な障害を突破するラインを作成します。

使用法

窪地とは、周囲の土地より地形的に低いエリアです。ここで水の流れが途絶えます。 ブリーチラインの生成 ツールは、水文学的な連続性を確保するために、窪地を下流のポイントに接続するブリーチラインを検出します。
出力ブリーチライン パラメーター値は、水文学的な連続性を確保するために、各窪地ポリゴンをブリーチする線を表します。 入力窪地ポリゴン (Python では in_depression_polygons) パラメーター値は、ブリーチする各窪地ポリゴンを表します。
入力接続ポイント (Python では in_connection_points) パラメーター値は、ブリーチラインが接続する始点と終点を表します。これは、窪地の特定ツールを使用して作成できます。
入力接続ポイント フィーチャレイヤーは 2 つのフィールドを持つことが期待されます。最初のフィールド DEP_ID は、そのポイントが属する窪地の ID です。バイナリーフィールド POINT_TYPE は、そのポイントが生成するラインの始点 (値 0) か終点 (値 1) かを示します。
出力フィーチャレイヤーのブリーチラインは、常に窪地内のポイントから始まり、水が流れるように標高が低いセルの位置で終わります。このツールは、このパスを部分的にカバーするラインは作成しません。つまり、部分的または不完全なラインは作成されません。
各窪地ポリゴンに対して、出力ブリーチラインは窪地内の最小標高ポイントから始まります。ラインの終点は、トレース方法 (Python では trace_method) パラメーター値に指定されたオプションによって異なります。
トレース方法 パラメーター値に 最短パス (Python では SHORTEST_PATH) オプションが指定されている場合、各窪地の 入力接続ポイント パラメーター値に始点と終点の両方が存在する必要があります。
トレース方法に 最小ブリーチコスト (Python では MIN_BREACHING_COST) オプションが指定されている場合、出力ブリーチラインは Lindsay and Dhun (2015) に従ってパスのブリーチコストを最小化するパスを表します。ブリーチコストは、窪地と標高の低い別のセル位置とを結び、水の流れを確保するために、地盤を削り下げるか、あるいは切り開いて水路を形成するために必要な標高差に等しくなります。
マスク環境設定が指定されている場合、ツールは始点 (窪地内) がマスクエリア内にある場合にのみブリーチラインを生成します。窪地エリアはマスクエリア内の全域または一部に含まれることがあります。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
入力窪地ポリゴン	窪地エリアを定義するポリゴンが含まれている入力フィーチャレイヤー。窪地とは、周囲の土地より地形的に低いエリアです。ここで水の流れが途絶えます。	Feature Layer
入力サーフェスラスター	入力サーフェスラスター。	Raster Layer
出力ブリーチライン	窪地と下流セルを接続し、水文接続を確保するラインが含まれる出力フィーチャクラス。各ラインには一意の番号が付きます。属性テーブルの追加フィールドには、そのポイントに関する詳細情報が格納されます。これらのフィールドには次のようなものがあります。 `LENGTH`—メートル単位で計測されたブリーチラインの長さ。 `DEP_ID`—ラインに関連付けられている窪地の識別子。 `START_X`—ブリーチラインの始点の X 座標。 `START_Y`—ブリーチラインの始点の Y 座標。 `END_X`—ブリーチラインの終点の X 座標。 `END_Y`—ブリーチラインの終点の Y 座標。 4 つの座標フィールドの値は出力空間参照にあります。	Feature Class
入力接続ポイント (オプション)	窪地内の最低標高ポイントと対応する下流接続ポイントを定義する、オプションの入力ポイント。この入力は、トレース方法パラメーター値に最短パスが指定されている場合に必要です。属性テーブルで想定されるフィールドは以下のとおりです。 `DEP_ID`—そのポイントに関連付けられている窪地の識別子。 `POINT_TYPE`—ポイントが窪地内の最低標高ポイントであるか (値 0)、下流接続ポイントであるか (値 1) を示す Boolean フィールド。	Feature Layer
トレース方法 (オプション)	ブリーチラインの作図方法を指定します。使用可能な方法は以下のとおりです。最小ブリーチコスト—ラインは、ブリーチコストを最小限に抑えるパスに従います。これがデフォルトです。最短パス—始点と終点の間の距離が最短のパス。入力接続ポイントパラメーター値に、始点と終点の両方が必要です。パスは、水流の局所的な障害を突破する最短のラインです。最小標高変化—ラインは標高変化を最小限に抑えるパスに従います。	String
最大長 (オプション)	ブリーチラインで許可されている最大長。潜在的なブリーチラインがこの限度を超える場合、そのラインは出力ブリーチラインフィーチャクラスに含まれません。デフォルトは、50 メートル、または解析の空間参照のマップ単位でこれに相当する値です。	Linear Unit

GenerateBreachLines(in_depression_polygons, in_surface_raster, out_breach_lines, {in_connection_points}, {trace_method}, {max_length})

名前	説明	データタイプ
in_depression_polygons	窪地エリアを定義するポリゴンが含まれている入力フィーチャレイヤー。窪地とは、周囲の土地より地形的に低いエリアです。ここで水の流れが途絶えます。	Feature Layer
in_surface_raster	入力サーフェスラスター。	Raster Layer
out_breach_lines	窪地と下流セルを接続し、水文接続を確保するラインが含まれる出力フィーチャクラス。各ラインには一意の番号が付きます。属性テーブルの追加フィールドには、そのポイントに関する詳細情報が格納されます。これらのフィールドには次のようなものがあります。 `LENGTH`—メートル単位で計測されたブリーチラインの長さ。 `DEP_ID`—ラインに関連付けられている窪地の識別子。 `START_X`—ブリーチラインの始点の X 座標。 `START_Y`—ブリーチラインの始点の Y 座標。 `END_X`—ブリーチラインの終点の X 座標。 `END_Y`—ブリーチラインの終点の Y 座標。 4 つの座標フィールドの値は出力空間参照にあります。	Feature Class
in_connection_points (オプション)	窪地内の最低標高ポイントと対応する下流接続ポイントを定義する、オプションの入力ポイント。この入力は、`trace_method` パラメーター値に `SHORTEST_PATH` が指定されている場合に必要です。属性テーブルで想定されるフィールドは以下のとおりです。 `DEP_ID`—そのポイントに関連付けられている窪地の識別子。 `POINT_TYPE`—ポイントが窪地内の最低標高ポイントであるか (値 0)、下流接続ポイントであるか (値 1) を示す Boolean フィールド。	Feature Layer
trace_method (オプション)	ブリーチラインの作図方法を指定します。使用可能な方法は以下のとおりです。 `MIN_BREACHING_COST`—ラインは、ブリーチコストを最小限に抑えるパスに従います。これがデフォルトです。 `SHORTEST_PATH`—始点と終点の間の距離が最短のパス。 `in_connection_points` パラメーター値に開始点と終了点の両方が存在する必要があります。パスは、水流の局所的な障害を突破する最短のラインです。 `MIN_ELEV`—ラインは標高変化を最小限に抑えるパスに従います。	String
max_length (オプション)	ブリーチラインで許可されている最大長。潜在的なブリーチラインがこの限度を超える場合、そのラインは出力ブリーチラインフィーチャクラスに含まれません。デフォルトは、50 メートル、または解析の空間参照のマップ単位でこれに相当する値です。	Linear Unit

コードのサンプル

GenerateBreachLines 例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。この例では、デフォルトのパラメーター値を使用して、始点と終点の接続ポイントを接続する窪地ポリゴンをブリーチする最短距離ラインを生成します。

from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapy/examples/data"
GenerateBreachLines("inputDepressionPolygons.shp", "inputSurfaceRaster.tif", "C:/sapyexamples/output/streams.shp", "", "", "", "")

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

この例では、最小標高パスに従い、最大長 50 メートルで窪地ポリゴンをブリーチするラインを生成します。

# Name: GenerateBreachLines_standalone.py
# Description: Generates lines that breach depression polygons following the 
#              minimum elevation path and a maximum length of 50 meters.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set the analysis environments
env.workspace = "C:/sapyexamples/data"

# Set the local variables
in_depression_polygons = "depressions.shp",
in_surface_raster = "inSurfaceRaster.tif"
out_breach_lines = "C:/sapyexamples/output/breachlines.shp"
in_connection_points= None
trace_method = "MIN_BREACHING_COST"
max_length = "50 Meters"


# Run Generate Breach Lines
GenerateBreachLines(in_depression_polygons, 
                    in_surface_raster,
                    out_breach_lines,
                    in_connection_points,
                    trace_method,
                    max_length)

環境

範囲, マスク, 自動コミット, 現在のワークスペース, 出力データのデフォルト Z 値, 地理座標系変換, M 座標精度, M 許容値, 出力データのコンフィグレーションキーワード, 出力座標系, 出力データに M 値を含む, 出力データに Z 値を含む, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, スクラッチワークスペース, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

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

参考情報

"Lindsay J, Dhun K. 2015. Modelling surface drainage patterns in altered landscapes using LiDAR. International Journal of Geographical Information Science, 29: 1-15. DOI: 10.1080/13658816.2014.975715"

ブリーチ ラインの生成 (Spatial Analyst ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

参考情報

関連トピック

ブリーチラインの生成 (Spatial Analyst ツール)