移動コスト パスの決定 (ポリライン) (ラスター解析ツール)
サマリー
ソースと目的地の間のポリラインとしての最小コスト パスを計算します。
レガシー:
このツールは非推奨となり、将来のリリースで削除される予定です。
距離累計 ツールと 最適パス (ライン) ツールにより、機能またはパフォーマンスが向上します。
図
使用法
このラスター解析ポータル ツールは、ArcGIS Image Server がラスター解析用に設定されている ArcGIS Enterprise ポータルにサイン インしているときに利用可能です。 このツールを実行すると、ArcGIS Pro がクライアントとしてサービスを提供し、ArcGIS Enterprise とフェデレートされているサーバーで処理が発生します。 ポータル ツールがポータルからレイヤーを入力として受け取り、ポータルに出力を作成します。
入力ラスター レイヤーは、ポータルからのレイヤー、イメージ サーバーの URI または URL、もしくは Image Server レイヤーの作成 ツールからの出力をサポートしています。 入力フィーチャ レイヤーは、ポータルからのレイヤーでも、フィーチャ サービスの URI または URL でもかまいません。 このツールはローカルのラスター データもレイヤーもサポートしていません。 このポータル ツールへの入力としてローカルのフィーチャ データとレイヤーを使用できますが、ポータルのレイヤーを入力することをおすすめします。
移動コスト パスの決定 (ポリライン) ツールでは、ソースから目的地までの最小コストパスの出力フィーチャが生成されます。
ソースまたは目的地の入力がイメージ サービスの場合、ソースまたは目的地ではないセルには NoData 値を割り当てる必要があります。 これらの入力において値 (ゼロを含む) が割り当てられているセルは、有効なソースまたは目的地として使用されます。
入力コスト サーフェスにゼロ値または負の値を設定することはできません。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ソース ラスターまたはフィーチャ
|
目的地までの最小コスト パスが求められるセルを識別するイメージ サービスまたはフィーチャ サービス。
入力がイメージ サービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。
|
Raster Layer; Image Service; Feature Layer; String
|
|
入力コスト ラスター
|
ソースから目的地までの最小コスト パスを決定するために使用されるコスト ラスター イメージ サービスの名前。
各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。 セル内を通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動についても補正します。
コスト ラスターとして、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません (負またはゼロのコストは指定できません)。
|
Raster Layer; Image Service; String
|
|
入力目的地ラスターまたはフィーチャ
|
最小コスト パスが計算されるセルを識別するイメージ サービスまたはフィーチャ サービス。
|
Raster Layer; Image Service; Feature Layer; String
|
|
出力ポリライン名
|
出力ポリライン ネットワーク フィーチャ サービスの名前。
ソースと目的地を結ぶ最適 (最小コスト) パスのポリライン フィーチャ サービス。
各パス (またはライン) には一意の番号が付けられ、DestID という名前の属性テーブルに追加のフィールドが含まれます。このフィールドから目的地ラスターの一意の識別子に接続します。
各パスは、一意のラインで表されるため、パスが同じルートを移動する場所には複数のラインがあります。
|
String
|
|
パスの種類
(オプション)
|
入力目的地データの値とゾーンを、コスト パスの計算の中でどのように解釈するかを指定します。
各セルへ—入力目的地データの有効な値を持つ各セルまたは場所について、最小コスト パスが求められ出力に保存されます。 このオプションを使用すると、入力目的地データの各セルまたは場所は別々に扱われ、それぞれの最小コスト パスがセルから決定されます。
各ゾーンへ—入力目的地データの有効な値を持つ各ゾーンについて、最小コスト パスが求められ出力に保存されます。 このオプションを使用すると、各ゾーンの最小コスト パスは、ゾーン内で最低のコスト距離加重を持つ場所から開始します。
最適な単一パス—入力目的地データのすべての場所について、最小コスト パスは、ソース セルへの最小コスト パスの最小値を使用してセルから求められます。 これがデフォルトです。
|
String
|
|
目的地フィールド
(オプション)
|
目的地の位置の値を取得するために使用するフィールド。
入力フィーチャ データには、少なくとも 1 つの有効な整数フィールドが必要です。
|
Field
|
派生した出力
|
ラベル
|
説明
|
データ タイプ
|
|
出力ポリライン フィーチャ
|
出力ポリライン フィーチャ。
|
Feature Class
|
arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
|
名前
|
説明
|
データ タイプ
|
|
inputSourceRasterOrFeatures
|
目的地までの最小コスト パスが求められるセルを識別するイメージ サービスまたはフィーチャ サービス。
入力がイメージ サービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。
|
Raster Layer; Image Service; Feature Layer; String
|
|
inputCostRaster
|
ソースから目的地までの最小コスト パスを決定するために使用されるコスト ラスター イメージ サービスの名前。
各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。 セル内を通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動についても補正します。
コスト ラスターとして、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません (負またはゼロのコストは指定できません)。
|
Raster Layer; Image Service; String
|
|
inputDestinationRasterOrFeatures
|
最小コスト パスが計算されるセルを識別するイメージ サービスまたはフィーチャ サービス。
|
Raster Layer; Image Service; Feature Layer; String
|
|
outputPolylineName
|
出力ポリライン ネットワーク フィーチャ サービスの名前。
ソースと目的地を結ぶ最適 (最小コスト) パスのポリライン フィーチャ サービス。
各パス (またはライン) には一意の番号が付けられ、DestID という名前の属性テーブルに追加のフィールドが含まれます。このフィールドから目的地ラスターの一意の識別子に接続します。
各パスは、一意のラインで表されるため、パスが同じルートを移動する場所には複数のラインがあります。
|
String
|
|
pathType
(オプション)
|
入力目的地データの値とゾーンを、コスト パスの計算の中でどのように解釈するかを指定します。
EACH_CELL—入力目的地データの有効な値を持つ各セルまたは場所について、最小コスト パスが求められ出力に保存されます。 このオプションを使用すると、入力目的地データの各セルまたは場所は別々に扱われ、それぞれの最小コスト パスがセルから決定されます。
EACH_ZONE—入力目的地データの有効な値を持つ各ゾーンについて、最小コスト パスが求められ出力に保存されます。 このオプションを使用すると、各ゾーンの最小コスト パスは、ゾーン内で最低のコスト距離加重を持つ場所から開始します。
BEST_SINGLE—入力目的地データのすべての場所について、最小コスト パスは、ソース セルへの最小コスト パスの最小値を使用してセルから求められます。 これがデフォルトです。
|
String
|
|
destinationField
(オプション)
|
目的地の位置の値を取得するために使用するフィールド。
入力フィーチャ データには、少なくとも 1 つの有効な整数フィールドが必要です。
|
Field
|
派生した出力
|
名前
|
説明
|
データ タイプ
|
|
outputPolylineFeatures
|
出力ポリライン フィーチャ。
|
Feature Class
|
コードのサンプル
DetermineTravelCostPathAsPolyline の例 1 (Python ウィンドウ)
この例では、目的地への移動コストを計算します。
import arcpy
arcpy.ra.DetermineTravelCostPathAsPolyline(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"https://myserver/rest/services/destination/ImageServer",
"outpath", "BEST_SINGLE")
DetermineTravelCostPathAsPolyline の例 2 (スタンドアロン スクリプト)
この例では、目的地への移動コストを計算します。
#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_Ex_02.py
# Description: Calculates the optimum travel cost path.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputSourceLayer = \
'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer = \
'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDestinationLayer = \
'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'
arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceLayer, inputCostLayer,
inputDestinationLayer, outputName, pathType)
環境
セル サイズ, 範囲, マスク, 出力座標系, スナップ対象ラスター
ライセンス情報
- Basic: ArcGIS Image Server が必要
- Standard: ArcGIS Image Server が必要
- Advanced: ArcGIS Image Server が必要
