移動コストパスの決定 (ポリライン) (Determine Travel Cost Path As Polyline) (ラスター解析)—ArcGIS Pro

サマリー

ソースと目的地の間の最小コストパス (ポリライン) を計算します。

ヒント:

[距離累計 (Distance Accumulation)] ツールと [最適パス (ライン) (Optimal Path As Line)] ツールにより、機能またはパフォーマンスが向上します。

図

使用法

このラスター解析ポータルツールは、ArcGIS Enterprise のポータルにサインインすると使用できます。このポータルに、ArcGIS Image Server 用に構成されたラスター解析があります。ツールを起動すると、ArcGIS Pro がクライアントとしてサービスを提供し、ArcGIS Enterprise とフェデレートされているサーバーで処理が発生します。ポータルツールはポータルから入力としてレイヤーを受け取り、ポータルに出力を作成します。
入力ラスターレイヤーは、ポータルから入力されたレイヤー、イメージサービスへの URI または URL、[Image Server レイヤーの作成 (Make Image Server Layer)] ツールの出力に対応しています。入力フィーチャレイヤーには、ポータルからのレイヤー、フィーチャサービスへの URI または URL を使用できます。このツールは、ローカルのラスターデータまたはレイヤーをサポートしません。このポータルツールへの入力としてはローカルのフィーチャデータとレイヤーを使用できますが、ポータルのレイヤーを入力することをお勧めします。
[移動コストパスの決定 (ポリライン)(Determine Travel Cost Path As Polyline)] ツールでは、ソースから目的地までの最小コストパスの出力フィーチャが生成されます。
ソースまたは目的地の入力がイメージサービスの場合、ソースまたは目的地ではないセルには 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.DetermineTravelCostPathAsPolyline_ra(
    "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.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

環境

セルサイズ, 範囲, マスク, 出力座標系, スナップ対象ラスター

特殊なケース

ライセンス情報

Basic: 次のものが必要 ArcGIS Image Server
Standard: 次のものが必要 ArcGIS Image Server
Advanced: 次のものが必要 ArcGIS Image Server

サマリー

ヒント:

図

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容