| ラベル | 説明 | データ タイプ |
入力サーフェス ラスター | 入力サーフェス ラスター。 | Raster Layer |
出力窪地ポリゴン | 特定された窪地が格納される出力フィーチャクラス。 各窪地ポリゴンには一意の番号が付きます。 属性テーブルの追加フィールドには、その窪地に関する詳細情報が格納されます。 これらのフィールドには次のようなものがあります。
| Feature Class |
入力道路ラスターまたはフィーチャ (オプション) | 道路を定義するオプションのラスターまたはフィーチャ データセット。 道路は、整数または浮動小数点ラスターで定義するか、ポイント、ライン、またはポリゴン フィーチャで定義することができます。 | Raster Layer; Feature Layer |
出力接続ポイント (オプション) | 窪地内の最低標高ポイントと対応する下流接続ポイントを定義する、オプションの出力ポイント。 下流接続は、窪地内の最低標高セルより標高が低い最寄りのセルとして定義されます。 各ポイントには一意の番号が付きます。 属性テーブルの追加フィールドには、そのポイントに関する詳細情報が格納されます。 これらのフィールドには次のようなものがあります。
| Feature Class |
最小深さ (オプション) | 窪地と見なされる最小深さ。 最大深さがこの値未満である窪地は最終出力に含まれません。 デフォルトは 0.05 メートル、または指定されている Z 単位でこれに相当する長さです。 | Linear Unit |
Z 単位 (オプション) | 鉛直方向の Z 値に使用する距離単位を指定します。 存在する場合は、鉛直座標系によって定義されます。 鉛直座標系が存在しない場合、正しい測地線の計算を実現するために、単位リストを使用して Z 単位を定義します。 デフォルトはメートルです。
| String |
最小面積 (オプション) | 窪地と見なされる最小面積。 面積とは、窪地の表面の面積のことです。 面積がこの値未満である窪地は最終出力に含まれません。 デフォルトは、3 つのセルの合計面積、または [入力サーフェス ラスター] パラメーター値の空間参照のマップ平方単位でこれに相当する面積です。 | Areal Unit |
接続までの最大距離 (オプション) | 窪地のエッジから下流接続ポイントまでの最大許容距離。 下流接続は、窪地内の最低標高セルより標高が低い最寄りのセルとして定義されます。 下流接続までの距離がこの値より大きい場合、その窪地は最終出力に含まれません。 デフォルトは、30 メートル、または [入力サーフェス ラスター] パラメーター値の空間参照のマップ単位でこれに相当する値です。 | Linear Unit |
道路までの最大距離 (オプション) | 窪地のエッジから最寄りの道路までの最大許容距離。 道路から窪地までの距離がこの値より大きい場合、その窪地は最終出力に含まれません。 このパラメーターは、[入力道路ラスターまたはフィーチャ] パラメーターの値が設定されている場合にのみ使用できます。 デフォルトは、30 メートル、または [入力サーフェス ラスター] パラメーター値の空間参照のマップ単位でこれに相当する値です。 | Linear Unit |
Spatial Analyst のライセンスで利用可能。
使用法
[入力サーフェス ラスター] (Python では in_surface_raster) パラメーターの値として数値標高モデル (DEM) を指定できます。 内部で、窪地は平滑化済み DEM と元の DEM の差に基づいて特定されます。
オプションの解析パラメーターで設定した要件をすべて満たす窪地のみが [出力窪地ポリゴン] (Python では out_depressions_polygons) パラメーター値に格納されます。
[出力接続ポイント] (Python では out_connection_points) パラメーター値には、[出力窪地ポリゴン] パラメーター値に格納されているすべての窪地について、その窪地内の最低標高ポイント、および下流接続ポイントが格納されます。
[Z 単位] (Python では z_unit) パラメーター値を指定することで、窪地の深さが適切に計算されます。
入力サーフェス ラスターの鉛直座標系に Z 単位がある場合、それが自動的に適用されます。 入力ラスターの Z 単位がない場合は定義することをおすすめします。 Z 単位の指定には、[投影法の定義 (Define Projection)] ツールを使用できます。 値を指定しなかった場合、デフォルトでメートルが使用されます。
[接続までの最大距離] (Python では max_connection_distance) パラメーターでは、窪地内の最低標高セルより標高が低い、最寄りのセルへの下流接続が考慮されます。 これらの条件を満たすセルが複数存在する場合、最初に見つかったセルが返されます。
[道路までの最大距離] (Python では max_road_distance) パラメーターは、[入力道路ラスターまたはフィーチャ] (Python では in_road_data) パラメーターが指定されている場合にのみ適用できます。
[入力サーフェス ラスター] パラメーター値の空間参照のマップ単位を使用して、[最小面積]、[接続までの最大距離]、[道路までの最大距離] パラメーターのデフォルト単位が設定されます。 [入力サーフェス ラスター] パラメーター値で指定されている単位が、使用可能な面積単位および距離単位の両方と一致していない場合、それらのパラメーターは、デフォルトで、それぞれ [平方メートル] および [メートル] に設定されます。
このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサや、複数のコアを持つプロセッサーが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。 「Spatial Analyst による並列処理」ヘルプ トピックには、この機能と設定方法の詳細が記載されています。
デフォルトでは、このツールは使用可能なコアの最大 50% を使用します。 並列処理ファクター環境で、ツールが使用するコアの数を制御できます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
パラメーター
LocateDepressions(in_surface_raster, out_depressions_polygons, {in_road_data}, {out_connection_points}, {min_depth}, {z_unit}, {min_area}, {max_connection_distance}, {max_road_distance})| 名前 | 説明 | データ タイプ |
in_surface_raster | 入力サーフェス ラスター。 | Raster Layer |
out_depressions_polygons | 特定された窪地が格納される出力フィーチャクラス。 各窪地ポリゴンには一意の番号が付きます。 属性テーブルの追加フィールドには、その窪地に関する詳細情報が格納されます。 これらのフィールドには次のようなものがあります。
| Feature Class |
in_road_data (オプション) | 道路を定義するオプションのラスターまたはフィーチャ データセット。 道路は、整数または浮動小数点ラスターで定義するか、ポイント、ライン、またはポリゴン フィーチャで定義することができます。 | Raster Layer; Feature Layer |
out_connection_points (オプション) | 窪地内の最低標高ポイントと対応する下流接続ポイントを定義する、オプションの出力ポイント。 下流接続は、窪地内の最低標高セルより標高が低い最寄りのセルとして定義されます。 各ポイントには一意の番号が付きます。 属性テーブルの追加フィールドには、そのポイントに関する詳細情報が格納されます。 これらのフィールドには次のようなものがあります。
| Feature Class |
min_depth (オプション) | 窪地と見なされる最小深さ。 最大深さがこの値未満である窪地は最終出力に含まれません。 デフォルトは 0.05 メートル、または指定されている Z 単位でこれに相当する長さです。 | Linear Unit |
z_unit (オプション) | 鉛直方向の Z 値に使用する距離単位を指定します。 存在する場合は、鉛直座標系によって定義されます。 鉛直座標系が存在しない場合、正しい測地線の計算を実現するために、単位リストを使用して Z 単位を定義します。 デフォルトはメートルです。
| String |
min_area (オプション) | 窪地と見なされる最小面積。 面積とは、窪地の表面の面積のことです。 面積がこの値未満である窪地は最終出力に含まれません。 デフォルトは、3 つのセルの合計面積、または in_surface_raster パラメーター値の空間参照のマップ平方単位でこれに相当する面積です。 | Areal Unit |
max_connection_distance (オプション) | 窪地のエッジから下流接続ポイントまでの最大許容距離。 下流接続は、窪地内の最低標高セルより標高が低い最寄りのセルとして定義されます。 下流接続までの距離がこの値より大きい場合、その窪地は最終出力に含まれません。 デフォルトは、30 メートル、または in_surface_raster パラメーター値の空間参照のマップ単位でこれに相当する値です。 | Linear Unit |
max_road_distance (オプション) | 窪地のエッジから最寄りの道路までの最大許容距離。 道路から窪地までの距離がこの値より大きい場合、その窪地は最終出力に含まれません。 このパラメーターは、in_road_data パラメーターの値が指定されている場合にのみ使用できます。 デフォルトは、30 メートル、または in_surface_raster パラメーター値の空間参照のマップ単位でこれに相当する値です。 | Linear Unit |
コードのサンプル
この例は、Locate Depressions を使用して、事前に窪地の平滑化が行われていない入力サーフェス ラスターから窪地を特定する方法を示しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
outDepressions = LocateDepressions("elevation", "outdepressions01.shp", "",
"outpoints01.shp", "", "", "", "", "")この例では、事前に窪地の平滑化が行われていない、実際の窪地から成る入力サーフェスから窪地を特定しています。
# Name: LocateDepressions_standalone.py
# Description: Locates depressions that meet the specified criteria.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"
# Execute the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
inZUnit, inMinArea, inMaxConnectionDist,
inMaxRoadDist)
# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst