距離の計算 (Calculate Distance) (ラスター解析)

サマリー

単一のソースまたは一群のソースから、ユークリッド距離を計算します。

レガシー:

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

[距離累計 (Distance Accumulation)] ツールまたは [距離アロケーション (Distance Allocation)] ツールにより、機能またはパフォーマンスが向上します。

図

使用法

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

  入力ラスター レイヤーは、ポータルからのレイヤー、イメージ サーバーの URI または URL、もしくは Image Server レイヤーの作成 (Make Image Server Layer) ツールからの出力をサポートしています。 入力フィーチャ レイヤーは、ポータルからのレイヤーでも、フィーチャ サービスの URI または URL でもかまいません。 このツールはローカルのラスター データもレイヤーもサポートしていません。 このポータル ツールへの入力としてローカルのフィーチャ データとレイヤーを使用できますが、ポータルのレイヤーを入力することをお勧めします。

• このツールの応用例として、任意の場所から最寄りの街までの距離の計算が挙げられます。

• 入力ソース データがイメージ サービスの場合、一連のソース セルは、ソース ラスター内にある有効な値を持つすべてのセルから構成されます。 値が NoData のセルは、ソース セットには含まれません。 値 0 (ゼロ) は、正当なソースと見なされます。

• 入力ソース データがフィーチャ サービスの場合、解析を実行する前に内部でソースの位置がラスターに変換されます。 ラスターの解像度は [出力セル サイズ] パラメーターまたは [セル サイズ] 環境で制御できます。 デフォルトの解像度は、入力空間参照において、入力フィーチャの範囲の幅または高さ (どちらか短い方) を 250 で割った値になります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ソース ラスターまたはフィーチャ	距離を計算するソースを定義するレイヤー。 レイヤーは、イメージ サービスでもフィーチャ サービスでもかまいません。 イメージ サービスの場合、入力タイプは整数または浮動小数点数です。 フィーチャ サービスの場合、入力はポイント、ライン、ポリゴンです。	Raster Layer; Image Service; Feature Layer; String
出力距離名	出力距離ラスター サービスの名前	String
最大距離 (オプション)	計算の最大距離。 単位の値は、[キロメートル]、[メートル]、[法定マイル]、[国際ヤード]、[国際フィート]、[米国測量マイル]、[米国測量ヤード]、[米国測量フィート] です。 デフォルトの単位はメートルです。	Linear Unit
出力セル サイズ (オプション)	出力ラスターのセル サイズと単位を設定します。 単位の値は、[キロメートル]、[メートル]、[法定マイル]、[国際ヤード]、[国際フィート]、[米国測量マイル]、[米国測量ヤード]、[米国測量フィート] です。 デフォルトの単位はメートルです。	Linear Unit
出力距離名 (オプション)	出力方向ラスター サービスの名前	String
出力アロケーション名 (オプション)	出力アロケーション ラスター サービスの名前	String
アロケーション フィールド (オプション)	各ソースを定義した値が保持されるソース入力上のフィールド。 整数タイプでなければなりません。	String
距離方法 (オプション)	距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。 平面—距離計算は、2 次元直交座標系を使用して投影された平面で実行されます。 これがデフォルトです。 測地線—距離は楕円形に基づいて計算されます。 したがって、入力または出力投影に関係なく、結果は変わりません。	String
入力バリア ラスターまたはフィーチャ (オプション)	バリアを定義するデータセット。 バリアは、整数ラスター、浮動小数点ラスター、またはフィーチャ レイヤーによって定義できます。	Raster Layer; Image Service; Feature Layer; String
出力バック方向名 (オプション)	出力バック方向ラスター サービスの名前。	String

派生した出力

ラベル	説明	データ タイプ
出力距離ラスター	出力距離ラスター。	Raster Layer
出力方向ラスター	出力方向ラスター。	Raster Layer
出力バック方向ラスター	出力バック方向ラスター。	Raster Layer
出力アロケーション ラスター	出力アロケーション ラスター。	Raster Layer

Python

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})

名前	説明	データ タイプ
inputSourceRasterOrFeatures	距離を計算するソースを定義するレイヤー。 レイヤーは、イメージ サービスでもフィーチャ サービスでもかまいません。 イメージ サービスの場合、入力タイプは整数または浮動小数点数です。 フィーチャ サービスの場合、入力はポイント、ライン、ポリゴンです。	Raster Layer; Image Service; Feature Layer; String
outputDistanceName	出力距離ラスター サービスの名前	String
maximumDistance (オプション)	計算の最大距離。 単位の値は、Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards、Feet です。 デフォルトの単位はメートルです。	Linear Unit
outputCellSize (オプション)	出力ラスターのセル サイズと単位を設定します。 単位の値は、Kilometers、Meters、MilesInt、YardsInt、FeetInt、Miles、Yards、Feet です。 デフォルトの単位はメートルです。	Linear Unit
outputDirectionName (オプション)	出力方向ラスター サービスの名前	String
outputAllocationName (オプション)	出力アロケーション ラスター サービスの名前	String
allocationField (オプション)	各ソースを定義した値が保持されるソース入力上のフィールド。 整数タイプでなければなりません。	String
distanceMethod (オプション)	距離を平面 (平面地球) と測地線 (楕円体) のどちらの方法を用いて計算するかを指定します。 Planar—距離計算は、2 次元直交座標系を使用して投影された平面で実行されます。 これがデフォルトです。 Geodesic—距離は楕円形に基づいて計算されます。 したがって、入力または出力投影に関係なく、結果は変わりません。	String
inputBarrierRasterOrFeatures (オプション)	バリアを定義するデータセット。 バリアは、整数ラスター、浮動小数点ラスター、またはフィーチャ レイヤーによって定義できます。	Raster Layer; Image Service; Feature Layer; String
outputBackDirectionName (オプション)	出力バック方向ラスター サービスの名前。	String

派生した出力

名前	説明	データ タイプ
outputDistanceRaster	出力距離ラスター。	Raster Layer
outputDirectionRaster	出力方向ラスター。	Raster Layer
outputBackDirectionRaster	出力バック方向ラスター。	Raster Layer
outputAllocationRaster	出力アロケーション ラスター。	Raster Layer

コードのサンプル

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

この例では、単一ソースからのユークリッド距離を計算します。

import arcpy
arcpy.ra.CalculateDistance('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           "outDistance", "5000", "10", "outDirection", "outAllocation", "siting")

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

この例では、複数ソースからのユークリッド距離を計算します。

# Name: CalculateDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance, direction and allocation
#              to the nearest source.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSourceData = 'https://MyPortal.esri.com/server/rest/services/Hosted/reccenter/ImageServer'
outDistanceName = "eucdistance"
maxDistance = "4000"
cellSize = "10"
outDirectionName = "eucdirect"
outAllocationName = "eurallocation"
allocationField = "dataid"


# Execute EucDistance
arcpy.ra.CalculateDistance(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
                           outAllocationName, allocationField)

環境

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

ライセンス情報

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