コスト バック リンク(Cost Back Link) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

最も近いソースへの最小累積コスト パス上で、次のセルである近傍を定義します。

[コスト距離(Cost Distance)] ツールの仕組みの詳細

Cost Back Link illustration
Cost_BackLink = CostBacklink(Source_Ras, Cost_Ras)

使用法

構文

CostBackLink (in_source_data, in_cost_raster, {maximum_distance}, {out_distance_raster})
パラメータ説明データ タイプ
in_source_data

入力ソース位置。

これは、あらゆる出力セル位置について最小累積コスト距離の計算対象となるセルまたは位置を特定するラスタ データセットまたはフィーチャ データセットです。

ラスタの場合、入力タイプは整数または浮動小数点数です。

Raster Layer | Feature Layer
in_cost_raster

各セル内を平面的に通過するときにかかるインピーダンスまたはコストを定義するラスタ。

各セル位置の値は、そのセル上を通過するための単位距離あたりのコストを表します。セル内を通過する総コストを取得するために、各セル位置の値にセル解像度を乗算して、対角移動についても補正します。

コスト ラスタとして、整数値または浮動小数点値を使用できますが、負の値や 0 は使用できません(負またはゼロのコストは指定できません)。

Raster Layer
maximum_distance
(オプション)

累積コスト値が超えることのできない閾値を定義します。

累積コスト距離がこの値を超える場合、セル位置の出力値は NoData になります。最大距離は、累積コスト距離を計算する範囲を定義します。

デフォルトは出力ラスタのエッジまでです。

Double
out_distance_raster
(オプション)

出力コスト距離ラスタ。

コスト距離ラスタは、特定されたソース位置までのコスト サーフェス上での最小累積コスト距離を、セルごとに特定します。

ソースは、セル、セル セット、または 1 つ以上のフィーチャ位置です。

出力ラスタのタイプは浮動小数点数です。

Raster Dataset

戻り値

名前説明データ タイプ
out_backlink_raster

出力コスト バック リンク ラスタ。

バック リンク ラスタは 0 ~ 8 の値を含みます。この値は方向を定義します。つまり、セルから最小コスト ソースまでの最小累積コスト パスに沿った次の隣接セルを特定します。

パスが右の隣接セルに進む場合、その隣接セルには値 1 が、右下のセルには値 2 が割り当てられ、これが時計回りに続きます。値 0 はソース セル用とされています。

バック リンク位置
Raster

コードのサンプル

CostBackLink(コスト バック リンク)の例 1(Python ウィンドウ)

次の Python ウィンドウ スクリプトで、CostBackLink(コスト バック リンク)ツールの使用方法を示します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBacklink = CostBackLink("observers","costraster", 100000, 
                           "c:/sapyexamples/output/distRast")
outBacklink.save("c:/sapyexamples/output/backlink")
CostBackLink(コスト バック リンク)の例 2(スタンドアロン スクリプト)

最小累積コスト パス解析で次のセルの方向を定義するバック リンク ラスタを作成します。

# Name: CostBackLink_Ex_02.py
# Description: Defines the neighbor that is the next cell on 
#              the least accumulative cost path to the nearest 
#              source.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSource = "observers.shp"
inCostRaster = "costraster"
inMaxDist = 100000
outDistRast = "c:/sapyexamples/output/distRast"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute CostBackLink
outBacklink = CostBackLink(inSource,inCostRaster, inMaxDist,
                           outDistRast)

# Save the output 
outBacklink.save("c:/sapyexamples/output/backlink.tif")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
9/17/2013