目的地までの移動コストパスの決定 (Determine Travel Cost Paths To Destinations) (ラスター解析)—ArcGIS Pro

サマリー

既知のソースから既知の目的地までの特定のパスを計算します。

[最適パス (ラスター) (Optimal Path As Raster)] ツールにより、機能またはパフォーマンスが向上します。

図

[目的地への移動コストパスの決定 (Determine Travel Cost Paths to Destinations)] ツールの図

使用法

このラスター解析ポータルツールは、ArcGIS Enterprise のポータルにサインインすると使用できます。このポータルに、ArcGIS Image Server 用に構成された Raster Analysis があります。ツールを起動すると、ArcGIS Pro がクライアントとしてサービスを提供し、ArcGIS Enterprise とフェデレートされているサーバーで処理が発生します。ポータルツールはポータルから入力としてレイヤーを受け取り、ポータルに出力を作成します。
入力ラスターレイヤーは、ポータルから入力されたレイヤー、イメージサービスへの URI または URL、[Image Server レイヤーの作成 (Make Image Server Layer)] ツールの出力に対応しています。入力フィーチャレイヤーには、ポータルからのレイヤー、フィーチャサービスへの URI または URL を使用できます。このツールは、ローカルのラスターデータまたはレイヤーをサポートしません。このポータルツールへの入力としてはローカルのフィーチャデータとレイヤーを使用できますが、ポータルのレイヤーを入力することをお勧めします。
このツールの応用例として、特定の目的地に到達するまでの移動コストを見つけることが挙げられます。
[目的地への移動コストパスの決定 (Determine Travel Cost Paths to Destinations)] ツールは、選択した位置から累積コストサーフェス上でコスト距離が最も近いソースセルまでの最小コストパスを記録する出力ラスターを作成します。
通常、入力コスト距離とバックリンクイメージサービスを作成するには、移動コストの計算 (Calculate Travel Cost) を実行してから目的地への移動コストパスの決定 (Determine Travel Cost Paths To Destinations) を実行する必要があります。これらは、目的地への移動コストパスの決定 (Determine Travel Cost Paths to Destinations) に必須の入力イメージサービスです。
それぞれの最小コストパスは、処理時に値が割り当てられます。コストパスの元のソース (コスト距離とバックリンクの出力元) の最終セルには 1 が割り当てられ、最初のパスには 3、2 番目のパスには 4 が割り当てられます。値 2 は、共通のコストパスを含むパスの部分をマージするために予約されています。
入力目的地データがイメージサービスの場合、一連の目的地セルは、有効な値を持つ入力イメージサービスまたは目的地フィーチャデータ内にあるすべてのセルから構成されます。値が NoData のセルは、ソースセットには含まれません。値ゼロは、正式な目的地と見なされます。
ソース入力がフィーチャサービスの場合、デフォルトで、最初の有効な利用可能フィールドが使用されます。有効なフィールドがない場合は、ObjectID フィールド (たとえば、OID や FID) が使用されます。
複数のパスがマージされ、ソースに戻る残りの距離が同じルートの場合、2 つのパスが移動するセグメントには値 2 が割り当てられます。マージされた部分は両方のルートに属するため、マージされたパスの部分には、パスの値を割り当てることはできません。
マージされたパスでの [各ゾーン] オプションの例
[目的地への移動コストパスの決定 (Determine Travel Cost Paths to Destinations)] は、[セルサイズ] 環境設定を無視し、出力ラスターの [入力コストバックリンクラスター] のセルサイズを使用します。バックリンクラスターのパターンは、別の解像度にリサンプリングされた場合は、大幅に変化します。混乱を避けるために、このツールを使用するときは、セルサイズを設定しないでください。
[目的地への移動コストパスの決定 (Determine Travel Cost Paths to Destinations)] を使用して、デジタル標高モデル (DEM) で負荷が最小のパスを算出することもできます。この場合、[入力コスト距離ラスター] に DEM、[入力コストバックリンクラスター] に [流向ラスターの作成 (Flow Direction)] ツールからの出力を使用します。有効な流向ラスター値は、1、2、4、8、16、32、64、128 です。バックリンクラスターの有効値は 0 ～ 360 です。これらのイメージサービスはどちらにも使用できます。
入力目的地データがフィーチャの場合、少なくとも 1 つの有効なフィールドがある必要があります。

パラメーター

ラベル	説明	データタイプ
入力目的地ラスターまたはフィーチャ	最小コストのソースまでの最小コストパスが求められるセルを識別するイメージサービスまたはフィーチャサービス。入力がイメージサービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。	Raster Layer; Image Service; Feature Layer; String
入力コスト距離ラスター	目的地の位置からソースまでの最小コストパスを決定するために使用されるコスト距離イメージサービスの名前。コスト距離ラスターは、通常、[移動コストの計算 (Calculate Travel Cost)] ツールで作成されます。コスト距離ラスターは、各セルから一連のソースセルまでのコストサーフェス上での最小累積コスト距離を、セルごとに格納しています。	Raster Layer; Image Service; String
入力コストバックリンクラスター	最小コストパスでソースに戻るパスを決定するために使用するバックリンクラスターの名前。バックリンクラスターの各セルについて、値は、セルから 1 つのソースセルまたは一連のソースセルまでの最小累積コストパス上にある次のセルである近傍を識別します。	Raster Layer; Image Service; String
出力名	出力移動コストパスラスターサービスの名前。デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。レイヤー名がすでに存在する場合は、別の名前を指定するよう求められます。	String
目的地フィールド (オプション)	各目的地を定義する値を保持する目的地レイヤーのフィールド。入力フィーチャサービスには、少なくとも 1 つの有効なフィールドがある必要があります。	String
パスの種類 (オプション)	入力目的地データの値とゾーンを、コストパスの計算の中でどのように解釈するかを定義します。各セルへ—入力目的地データの有効な値を持つ各セルについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、入力目的地データの各セルは別々に扱われ、それぞれの最小コストパスがセルから決定されます。これがデフォルトです。各ゾーンへ—入力目的地データの有効な値を持つ各ゾーンについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、各ゾーンの最小コストパスは、ゾーン内で最低のコスト距離加重を持つセルから開始します。最適な単一パス—入力目的地データのすべてのセルについて、最小コストパスは、ソースセルへの最小コストパスの最小値を使用してセルから求められます。	String

派生した出力

ラベル	説明	データタイプ
出力ラスター	出力ラスター。	Raster Layer

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})

名前	説明	データタイプ
inputDestinationRasterOrFeatures	最小コストのソースまでの最小コストパスが求められるセルを識別するイメージサービスまたはフィーチャサービス。入力がイメージサービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。	Raster Layer; Image Service; Feature Layer; String
inputCostDistanceRaster	目的地の位置からソースまでの最小コストパスを決定するために使用されるコスト距離イメージサービスの名前。コスト距離ラスターは、通常、[移動コストの計算 (Calculate Travel Cost)] ツールで作成されます。コスト距離ラスターは、各セルから一連のソースセルまでのコストサーフェス上での最小累積コスト距離を、セルごとに格納しています。	Raster Layer; Image Service; String
inputCostBacklinkRaster	最小コストパスでソースに戻るパスを決定するために使用するバックリンクラスターの名前。バックリンクラスターの各セルについて、値は、セルから 1 つのソースセルまたは一連のソースセルまでの最小累積コストパス上にある次のセルである近傍を識別します。	Raster Layer; Image Service; String
outputName	出力移動コストパスラスターサービスの名前。デフォルトの名前は、ツール名と入力レイヤー名に基づいて設定されます。レイヤー名がすでに存在する場合は、別の名前を指定するよう求められます。	String
destinationField (オプション)	各目的地を定義する値を保持する目的地レイヤーのフィールド。入力フィーチャサービスには、少なくとも 1 つの有効なフィールドがある必要があります。	String
pathType (オプション)	入力目的地データの値とゾーンを、コストパスの計算の中でどのように解釈するかを定義します。 EACH_CELL—入力目的地データの有効な値を持つ各セルについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、入力目的地データの各セルは別々に扱われ、それぞれの最小コストパスがセルから決定されます。これがデフォルトです。 EACH_ZONE—入力目的地データの有効な値を持つ各ゾーンについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、各ゾーンの最小コストパスは、ゾーン内で最低のコスト距離加重を持つセルから開始します。 BEST_SINGLE—入力目的地データのすべてのセルについて、最小コストパスは、ソースセルへの最小コストパスの最小値を使用してセルから求められます。	String

派生した出力

名前	説明	データタイプ
outputRaster	出力ラスター。	Raster Layer

コードのサンプル

DetermineTravelCostPathsToDestinations (目的地への移動コストパスの決定) の例 1 (Python ウィンドウ)

この例では、目的地への移動コストを計算します。

import arcpy

arcpy.DetermineTravelCostPathstoDestinations_ra(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/backlinkras/ImageServer", 
    "outpath", "destField", "EACH_ZONE")

DetermineTravelCostPathsToDestinations (目的地への移動コストパスの決定) の例 2 (スタンドアロンスクリプト)

この例では、目的地への移動コストを計算します。

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathstoDestinations_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'
inputBackLinkLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backlinkras/ImageServer'
outputName = 'outTravelPathsRaster'
destField = 'dest1'
pathType = 'BEST_SINGLE'

arcpy.DetermineTravelCostPathstoDestinations_ra(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
						destField, pathType)

環境

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

特殊なケース

ライセンス情報

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

サマリー

図

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容