确定最佳行程成本网络 (栅格分析)

摘要

计算一组输入区域的最佳成本网络。

旧版本:

此工具已弃用,并将从未来的版本中移除。

最佳区域连接工具提供了增强的功能或性能。

插图

确定最佳行程成本网络工具图示

使用情况

  • 当您登录到已针对 Raster Analysis 配置 ArcGIS Image ServerArcGIS Enterprise 门户时,可以使用此栅格分析门户工具。 工具运行时,ArcGIS Pro 将充当客户端,并且处理将在与 ArcGIS Enterprise 联合的服务器中进行。 门户工具接受来自门户的图层作为输入,并在门户中创建输出。

    输入栅格图层支持门户中的图层、影像服务的 URI 或 URL 或者创建影像服务器图层工具的输出。 输入要素图层可以是门户中的图层或要素服务的 URI 或 URL。 此工具不支持本地栅格数据或图层。 虽然可以使用本地要素数据和图层作为此门户工具的输入,但是最佳做法是使用门户中的图层作为输入。

  • 此工具的示例应用之一是查找急救车辆的最佳网络。

  • 在栅格中,区域是含有相同值且彼此相连(邻近)的一组像元。 输入区域由栅格识别时,如果有任何区域(具有相同值的像元)由多个区域组成,首先请对数据进行预处理,以便向每个区域分配唯一值。

  • 输入成本栅格数据中含有 NoData 的像元位置充当障碍。

  • 输入成本栅格不能包含零值,因为该算法是乘法过程。 如果成本栅格中的确包含表示成本最低区域的零值,则请在运行确定最佳行程成本网络前,将零值更改为较小的正值(如 0.01)。

  • 对于输出邻域网络,邻域并非通过欧氏距离进行识别,而是通过成本距离进行识别。 因此,距某个区域最近的邻域指的是出行成本最低的区域,而不是距离上最近的区域。

参数

标注说明数据类型
输入区域栅格或要素

要通过最低成本网络连接的输入区域。

区域可以通过影像服务或要素服务来定义。

如果区域输入为栅格,则区域将通过值相同的连续(邻近)像元组进行定义。 每个区域必须具有唯一的编号。 不属于任何区域的像元一定是 NoData。 栅格类型必须为整型,值可正可负。

如果区域输入为要素,则其可以是面、线或点。 面要素区域不能包含多部分面。

Raster Layer; Image Service; Feature Layer; String
输入成本栅格

定义以平面测量的经过每个像元所需的阻抗或成本。

每个像元位置上的值表示经过像元时移动每单位距离所需的成本。 每个像元位置值乘以像元分辨率,同时也会补偿对角线移动来获取经过像元的总成本。

成本栅格的值可以是整型或浮点型,但不可以为负值或零(不存在负成本或零成本)。

Raster Layer; Image Service; String
输出最佳网络名称

输出最佳网络要素服务的名称。

最佳(成本最低)路径网络的折线要素服务需要连接每个输入区域。

每条路径(或线)都是唯一标识的,同时属性表中的其他字段用于存储有关路径的特定信息。 这些字段包括:

  • PATHID- 路径的唯一标识符
  • PATHCOST- 路径的总累计成本
  • REGION1- 该路径连接的第一个区域
  • REGION2- 该路径连接的另一个区域

该信息有助于您深入分析网络内的路径。

由于每条路径都是由唯一的线所表示,因此多条路径经过同一路线的位置会存在多条线。

String
输出邻域网络名称
(可选)

输出邻域网络要素服务的名称。

该折线要素服务用于标识从每个区域到其每个最近成本邻域的所有路径。

每条路径(或线)都是唯一标识的,同时属性表中的其他字段用于存储有关路径的特定信息。 这些字段包括:

  • PATHID- 路径的唯一标识符
  • PATHCOST- 路径的总累计成本
  • REGION1- 该路径连接的第一个区域
  • REGION2- 该路径连接的另一个区域

该信息有助于深入分析网络内的路径,而且对于决定应该移除哪条路径尤其有用(如有必要)。

由于每条路径都是由唯一的线所表示,因此多条路径经过同一路线的位置会存在多条线。

String

派生输出

标注说明数据类型
输出最佳网络要素

输出最佳网络要素。

Raster Layer
输出邻域网络要素

输出邻域网络要素。

Feature Class

arcpy.ra.DetermineOptimumTravelCostNetwork(inputRegionsRasterOrFeatures, inputCostRaster, outputOptimumNetworkName, {outputNeighborNetworkName})
名称说明数据类型
inputRegionsRasterOrFeatures

要通过最低成本网络连接的输入区域。

区域可以通过影像服务或要素服务来定义。

如果区域输入为栅格,则区域将通过值相同的连续(邻近)像元组进行定义。 每个区域必须具有唯一的编号。 不属于任何区域的像元一定是 NoData。 栅格类型必须为整型,值可正可负。

如果区域输入为要素,则其可以是面、线或点。 面要素区域不能包含多部分面。

Raster Layer; Image Service; Feature Layer; String
inputCostRaster

定义以平面测量的经过每个像元所需的阻抗或成本。

每个像元位置上的值表示经过像元时移动每单位距离所需的成本。 每个像元位置值乘以像元分辨率,同时也会补偿对角线移动来获取经过像元的总成本。

成本栅格的值可以是整型或浮点型,但不可以为负值或零(不存在负成本或零成本)。

Raster Layer; Image Service; String
outputOptimumNetworkName

输出最佳网络要素服务的名称。

最佳(成本最低)路径网络的折线要素服务需要连接每个输入区域。

每条路径(或线)都是唯一标识的,同时属性表中的其他字段用于存储有关路径的特定信息。 这些字段包括:

  • PATHID- 路径的唯一标识符
  • PATHCOST- 路径的总累计成本
  • REGION1- 该路径连接的第一个区域
  • REGION2- 该路径连接的另一个区域

该信息有助于您深入分析网络内的路径。

由于每条路径都是由唯一的线所表示,因此多条路径经过同一路线的位置会存在多条线。

String
outputNeighborNetworkName
(可选)

输出邻域网络要素服务的名称。

该折线要素服务用于标识从每个区域到其每个最近成本邻域的所有路径。

每条路径(或线)都是唯一标识的,同时属性表中的其他字段用于存储有关路径的特定信息。 这些字段包括:

  • PATHID- 路径的唯一标识符
  • PATHCOST- 路径的总累计成本
  • REGION1- 该路径连接的第一个区域
  • REGION2- 该路径连接的另一个区域

该信息有助于深入分析网络内的路径,而且对于决定应该移除哪条路径尤其有用(如有必要)。

由于每条路径都是由唯一的线所表示,因此多条路径经过同一路线的位置会存在多条线。

String

派生输出

名称说明数据类型
outputOptimumNetworkFeatures

输出最佳网络要素。

Raster Layer
outputNeighborNetworkFeatures

输出邻域网络要素。

Feature Class

代码示例

DetermineOptimumTravelCostNetwork 示例 1(Python 窗口)

此示例将计算最佳行程成本网络。

import arcpy

arcpy.ra.DetermineOptimumTravelCostNetwork(
    "https://myserver/rest/services/sources/ImageServer", 
	"https://myserver/rest/services/costsurface/ImageServer", 
    "outoptimumnetwork1")
DetermineOptimumTravelCostNetwork 示例 2(独立脚本)

此示例将计算最佳行程成本网络。

#-------------------------------------------------------------------------------
# Name: DetermineOptimumTravelCostNetwork_Ex_02.py
# Description: Calculates the optimum travel cost network.
# 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'
outputOptimumNetworkName = 'outNetworkRaster'
outputNeighborName = 'outNeighborRaster'

arcpy.ra.DetermineOptimumTravelCostNetwork(inputSourceLayer, zoneField, inputCostLayer,
                               outputOptimumNetworkName, outputNeighborName)

许可信息

  • Basic: 需要 ArcGIS Image Server
  • Standard: 需要 ArcGIS Image Server
  • Advanced: 需要 ArcGIS Image Server

相关主题