コストパス (ポリライン) (ラスター解析ツール)

サマリー

ソースから目的地までの最小コストパスをラインフィーチャとして算出します。

レガシー:

このツールは非推奨となり、将来のリリースで削除される予定です。

最適パス (ライン) ツールにより、機能またはパフォーマンスが向上します。

最小コストパスの作成の詳細

図

Cost Path As Polyline tool illustration

使用法

このラスター解析ポータルツールは、ArcGIS Image Server がラスター解析用に設定されている ArcGIS Enterprise ポータルにサインインしているときに利用可能です。このツールを実行すると、ArcGIS Pro がクライアントとしてサービスを提供し、ArcGIS Enterprise とフェデレートされているサーバーで処理が発生します。ポータルツールがポータルからレイヤーを入力として受け取り、ポータルに出力を作成します。

入力ラスターレイヤーは、ポータルからのレイヤー、イメージサーバーの URI または URL、もしくは Image Server レイヤーの作成 ツールからの出力をサポートしています。入力フィーチャレイヤーは、ポータルからのレイヤーでも、フィーチャサービスの URI または URL でもかまいません。このツールはローカルのラスターデータもレイヤーもサポートしていません。このポータルツールへの入力としてローカルのフィーチャデータとレイヤーを使用できますが、ポータルのレイヤーを入力することをおすすめします。
コストパス (ポリライン) ツールは、累積コストサーフェスまたはユークリッド距離サーフェス内の最も近い目的地によって定義された、ソースからの最小コストパスを記録する出力ポリラインフィーチャサービスを作成します。
目的地フィーチャがある場合は、フィーチャのラスター化ラスター関数を使用してそれらのフィーチャをイメージサービスに変換できます。既存の コスト距離ラスター を、このラスター化関数の ラスター 入力として使用します。これにより、フィーチャが確実に、同じセルサイズ、範囲、および空間参照を使用してイメージサービスに正しく変換されるようになります。
目的地ラスター 内に存在する NoData 値は、関数の有効な値として含まれません。値 0 (ゼロ) は、目的地ラスター内の正当な値と見なされます。
コストパス (ポリライン) を実行するには、2 つの入力イメージサービスが必要です。これらの入力を生成する方法は、実行する解析のタイプによって決まります。
コスト解析は、コストパスを生成します。コストバックリンクおよびコスト距離ラスター関数を実行して、必要な入力を生成します。
ユークリッド解析は、直線のパスおよびバリアの周囲のパスを生成します。 距離の計算 ツールを実行して、ユークリッド逆方向およびユークリッド距離を生成します。または、ユークリッドバック方向およびユークリッド距離ラスター関数を実行します。
フロー解析は、フローパスを生成します。 D8 オプションを使用して流向ラスター関数を実行します。 D8 流向ラスターを、 入力コストバックリンクラスター の入力として使用します。 入力コスト距離ラスター も指定する必要があります。 入力コスト距離ラスター はパスの決定に使用されません。定数ラスターまたは数値標高モデル (DEM) のどちらを使用しても、パスは同じになります。パス上の属性値のみが変化します。
出力フィーチャサービスには、各ラインの目的地を識別する DestID というフィールドがあります。
ほとんどの他のラスター解析ツールとは異なり、 コストパス (ポリライン) は、環境設定の出力座標系、範囲、セルサイズ、スナップ対象ラスターを無視します。バックリンクラスターのパターンは、リサンプリングまたは再投影された場合は、大幅に変化し、パスが正しくなくなります。

ラベル	説明	データタイプ
入力目的地ラスターまたはフィーチャ	最小コストのソースまでの最小コストパスが求められる位置を識別するイメージサービスまたはフィーチャサービス。入力がイメージサービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。	Raster Layer; Image Service; Feature Layer; String
入力コスト距離ラスターまたはユークリッド距離ラスター	ソースから目的地までの最小コストパスを決定するために使用される入力コスト距離ラスターまたはユークリッド距離ラスター。	Raster Layer; Image Service; String
入力コストバックリンクラスター、バック方向ラスター、または流向ラスター	最小コストパスまたは最短パスでソースに戻るパスを決定するために使用するラスターの名前。バックリンクラスターまたは距離ラスターの各セルについて、値は、セルからソースセルまでのパス上にある次のセルである近傍を識別します。	Raster Layer; Image Service; String
出力ポリライン名	最小コストパスを含む出力フィーチャサービス。	String
パスの種類 (オプション)	入力目的地データの値とゾーンを、コストパスの計算の中でどのように解釈するかを指定します。最適な単一パス—入力目的地データのすべてのセルについて、最小コストパスは、ソースセルへの最小コストパスの最小値を使用してセルから求められます。各ゾーン—入力目的地データの有効な値を持つ各ゾーンについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、各ゾーンの最小コストパスは、ゾーン内で最低のコスト距離加重を持つセルから開始します。各セル—入力目的地データの有効な値を持つ各セルについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、入力目的地データの各セルは別々に扱われ、それぞれの最小コストパスがセルから決定されます。	String
目的地フィールド (オプション)	目的地の位置の値を取得するために使用するフィールド。	Field

派生した出力

ラベル	説明	データタイプ
出力ポリラインフィーチャ	ポリラインフィーチャ。	Feature Layer

arcpy.ra.CostPathAsPolyline(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputPolylineName, {pathType}, {destinationField})

名前	説明	データタイプ
inputDestinationRasterOrFeatures	最小コストのソースまでの最小コストパスが求められる位置を識別するイメージサービスまたはフィーチャサービス。入力がイメージサービスの場合、入力は有効な値 (ゼロは有効値) を持つセルから構成され、残りのセルには NoData を割り当てる必要があります。	Raster Layer; Image Service; Feature Layer; String
inputCostDistanceRaster	ソースから目的地までの最小コストパスを決定するために使用される入力コスト距離ラスターまたはユークリッド距離ラスター。	Raster Layer; Image Service; String
inputCostBacklinkRaster	最小コストパスまたは最短パスでソースに戻るパスを決定するために使用するラスターの名前。バックリンクラスターまたは距離ラスターの各セルについて、値は、セルからソースセルまでのパス上にある次のセルである近傍を識別します。	Raster Layer; Image Service; String
outputPolylineName	最小コストパスを含む出力フィーチャサービス。	String
pathType (オプション)	入力目的地データの値とゾーンを、コストパスの計算の中でどのように解釈するかを指定します。 `BEST_SINGLE`—入力目的地データのすべてのセルについて、最小コストパスは、ソースセルへの最小コストパスの最小値を使用してセルから求められます。 `EACH_ZONE`—入力目的地データの有効な値を持つ各ゾーンについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、各ゾーンの最小コストパスは、ゾーン内で最低のコスト距離加重を持つセルから開始します。 `EACH_CELL`—入力目的地データの有効な値を持つ各セルについて、最小コストパスが求められ出力ラスターに保存されます。このオプションを使用すると、入力目的地データの各セルは別々に扱われ、それぞれの最小コストパスがセルから決定されます。	String
destinationField (オプション)	目的地の位置の値を取得するために使用するフィールド。	Field

派生した出力

名前	説明	データタイプ
outputPolylineFeatures	ポリラインフィーチャ。	Feature Layer

コードのサンプル

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

次の Python ウィンドウスクリプトは、CostPathAsPoyline 関数の使用方法を示しています。

import arcpy

arcpy.ra.CostPathAsPolyline(
    "https://myserver/rest/services/destination/ImageServer",
    "https://myserver/rest/services/costsurface/ImageServer",
    "https://myserver/rest/services/direction/ImageServer",
    "outpath", "BEST_SINGLE")

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

ソースから目的地までの最小コストパスを計算します。

#-------------------------------------------------------------------------------
# Name: CostPathAsPolyline_Ex_02.py
# Description: Calculates the least-cost path from a source to a destination.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputDestinationLayer = \
    'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputCostLayer = \
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDirectionLayer = \
    'https://MyPortal.esri.com/server/rest/services/Hosted/direction/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.ra.CostPathAsPolyline(inputDestinationLayer, inputCostLayer,
                            inputDirectionLayer, outputName, pathType)

環境

出力座標系

ライセンス情報

Basic: ArcGIS Image Server が必要
Standard: ArcGIS Image Server が必要
Advanced: ArcGIS Image Server が必要

コスト パス (ポリライン) (ラスター解析ツール)

サマリー

レガシー:

図

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

コストパス (ポリライン) (ラスター解析ツール)