最小コストパス (AllSource ツール)

サマリー

コストサーフェスの始点と終点間で最短パスを検索します。

使用法

入力始点 と 入力終点 パラメーター値は、入力コストサーフェス パラメーター値の範囲内に存在する必要があります。サーフェスの範囲外にあるポイントを使用すると、エラーが発生します。
入力始点 の値として複数のポイントを使用すると、処理時間が大幅に長くなります。
入力終点 の値として複数のポイントを使用すると、3 つ以上の出力ラインフィーチャが生成される場合があります。
入力コストサーフェス パラメーター値内の NoData 値はバリアと見なされ、生成されるパスはこれらのエリアを迂回します。コストサーフェス内にある NoData のセルの周辺にパスが見つからない場合、解が見つからないことがあります。その場合は、追加の手順を実行して、コストサーフェスを変更する必要があります。
ツールは、UTM (ユニバーサル横メルカトル図法) など、投影座標系の 入力コストサーフェス パラメーターの値を使用して実行します。
ゼロコストの処理方法 パラメーターの 小さい正の値 オプションは、入力コストラスターのサイズと、パス計算アルゴリズムの精度の制限と比較した最大コスト値によって推定されます。これは、出力パスの作成中に行き止まりが発生する機会を減らすために行われます。小さい正の値は次のように推定されます。

\(max(height\_of\_cost\_raster、\space width\_of\_cost\_raster) \space * \space max\_cost\_value \space / \space 100000\)
新しい StartID および DestID フィールドが、出力パスフィーチャクラス パラメーター値に追加されます。これらのフィールドは、ラインが移動する始点と終点を表します。
始点と終点は出力場所にコピーされ、出力パスフィーチャクラス の値に _start と _end が付いた名前になります。

ラベル	説明	データタイプ
入力コストサーフェス	始点から終点までの移動コストの判定に使用する入力ラスター。 NoData 値は、通過できません。	Raster Layer
入力始点	入力始点フィーチャ。複数の始点を使用すると、処理時間が大幅に長くなります。	Feature Set
入力終点	入力終点フィーチャ。複数の終点を使用すると、出力ラインの数が増え、生成されるパスが別々のパスに分岐します。	Feature Set
出力パスフィーチャクラス	出力パスフィーチャクラス。	Feature Class
ゼロコストの処理方法 (オプション)	入力コストサーフェスパラメーター値のゼロ値および負の値の処理方法を指定します。小さい正の値—すべてのゼロおよび負の値は、小さい正の値に変更されます。これにより、セルが通過可能になります。これがデフォルトです。 No data—すべてのゼロおよび負の値は、NULL 値に変更されます。セルはバリアと見なされ、通過できず、迂回されます。	String

派生した出力

ラベル	説明	データタイプ
出力始点	シンボル表示された始点。	Feature Class
出力終点	シンボル表示された終点。	Feature Class

arcpy.intelligence.LeastCostPath(in_cost_surface, in_start_point, in_end_point, out_path_feature_class, {handle_zeros})

名前	説明	データタイプ
in_cost_surface	始点から終点までの移動コストの判定に使用する入力ラスター。 NoData 値は、通過できません。	Raster Layer
in_start_point	入力始点フィーチャ。複数の始点を使用すると、処理時間が大幅に長くなります。	Feature Set
in_end_point	入力終点フィーチャ。複数の終点を使用すると、出力ラインの数が増え、生成されるパスが別々のパスに分岐します。	Feature Set
out_path_feature_class	出力パスフィーチャクラス。	Feature Class
handle_zeros (オプション)	`in_cost_surface` パラメーター値のゼロ値および負の値の処理方法を指定します。 `SMALL_POSITIVE`—すべてのゼロおよび負の値は、小さい正の値に変更されます。これにより、セルが通過可能になります。これがデフォルトです。 `NO_DATA`—すべてのゼロおよび負の値は、NULL 値に変更されます。セルはバリアと見なされ、通過できず、迂回されます。	String

派生した出力

名前	説明	データタイプ
out_start_point	シンボル表示された始点。	Feature Class
out_end_point	シンボル表示された終点。	Feature Class

コードのサンプル

LeastCostPath の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードで LeastCostPath 関数を使用する方法を示しています。

import arcpy
import os
arcpy.intelligence.LeastCostPath(r"c:\workspace\terrain.gdb\mob_cost_surf",
                                 r"c:\workspace\startinglocation.shp",
                                 r"c:\workspace\endinglocation.shp",
                                 os.path.join(arcpy.env.scratchWorkspace, "bestpath"),
                                 "SMALL_POSITIVE")

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

次の Python スクリプトは、スタンドアロンスクリプトで LeastCostPath 関数を使用する方法を示しています。

# Name: LeastCostPath_Example2.py
# Description: Generate the least cost path between an input and output point
#              based on a cost surface.

# Import system modules
import arcpy
import os

# Set local variables
in_cost_surface = r"c:\workspace\terrain.gdb\mob_cost_surf"
in_start_point = r"c:\workspace\startinglocation.shp"
in_end_point = r"c:\workspace\endinglocation.shp"
out_path_feature_class = os.path.join(arcpy.env.scratchWorkspace, "bestpath")
handle_zeros = "SMALL_POSITIVE"

# Run LeastCostPath
arcpy.intelligence.LeastCostPath(in_cost_surface, in_start_point,
                                 in_end_point, out_path_feature_class,
                                 handle_zeros)

# Report status
if arcpy.Exists(out_path_feature_class):
    print("Path segments {}".format(arcpy.management.GetCount(out_path_feature_class)[0]))
else:
    print("Empty output")

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

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

最小コスト パス (AllSource ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

最小コストパス (AllSource ツール)