距離の計算 (ラスター解析ツール)

サマリー

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

レガシー:

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

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

図

Calculate Distance tool illustration

使用法

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

入力ラスターレイヤーは、ポータルからのレイヤー、イメージサーバーの URI または URL、もしくは Image Server レイヤーの作成 ツールからの出力をサポートしています。入力フィーチャレイヤーは、ポータルからのレイヤーでも、フィーチャサービスの 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

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"

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

環境

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

ライセンス情報

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

距離の計算 (ラスター解析ツール)

サマリー

レガシー:

図

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック