求解 (Network Analyst)

摘要

基于网络位置和属性求解网络分析图层问题。

使用情况

  • 求解失败时,警告和错误消息可提供有关失败原因的有用信息。

  • 运行此工具前,请确保为网络分析图层指定了求解问题所需的所有参数。

  • 网络分析图层引用 ArcGIS Online 作为网络数据源时,该工具将消耗配额。有关详细信息,请参阅服务配额概述

参数

标注说明数据类型
输入网络分析图层

要进行分析计算的网络分析图层。

Network Analyst Layer
忽略无效的位置
(可选)

指定是否忽略无效的输入位置。

  • 选中 - 求解程序将跳过未定位的网络位置而仅根据有效的网络位置来求解分析图层。如果这些位置位于不可遍历的元素上或有其他错误,求解程序仍会继续求解。如果您知道您的网络位置并不完全正确,但是想对有效的网络位置求解,此选项很有用。这是默认设置。
  • 未选中 - 如果存在无效位置,则不进行求解。随后您可对这些无效位置进行调整,然后重新运行分析。
Boolean
因求解出错而终止
(可选)

指定在求解过程中遇到错误时是否应终止工具执行。

  • 选中 - 该工具在求解程序遇到错误时将无法执行操作。这是默认设置。
  • 未选中 - 即使求解程序遇到错误,该工具也不停止,而是继续执行操作。求解程序返回的所有错误消息都将转换为警告消息。如果在应用程序中启用了后台处理,则应使用该选项。
Boolean
简化容差
(可选)

容差确定输出几何的简化程度。如果已指定了容差,容差必须大于零。可以选择首选单位;默认单位为十进制度。

指定简化容差会减少渲染路径或服务区的时间。但缺点是,简化几何移除了折点,这样会降低以更大比例输出的空间精确度。

由于带两个折点的线不能再简化,所以此参数对单一线段输出的绘制时间没有影响,例如直线路线、 OD 成本矩阵线和位置分配线。

Linear Unit
覆盖
(可选)

求解网络分析问题时,指定可影响求解程序行为的其他设置。

需要在 JavaScript 对象表示法 (JSON) 中指定此参数的值。例如,有效值的格式如下:{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。覆盖设置名称始终以双引号括起。该值可以是数字、布尔值或字符串。

此参数的默认值为无值,表示不覆盖任何求解程序设置。

覆盖是高级设置,应仅在谨慎分析应用设置前后得到的结果之后使用。要获得每个求解程序支持的覆盖设置及其可接受值的列表,请联系 Esri 技术支持。

String

派生输出

标注说明数据类型
网络分析图层

已求解的网络分析图层。

网络分析图层
求解成功

指示求解是否成功的布尔值。

布尔型

arcpy.na.Solve(in_network_analysis_layer, {ignore_invalids}, {terminate_on_solve_error}, {simplification_tolerance}, {overrides})
名称说明数据类型
in_network_analysis_layer

要进行分析计算的网络分析图层。

Network Analyst Layer
ignore_invalids
(可选)

指定是否忽略无效的输入位置。

  • SKIP求解程序将跳过未定位的网络位置而仅根据有效的网络位置来求解分析图层。如果这些位置位于不可遍历的元素上或有其他错误,求解程序仍会继续求解。如果您知道您的网络位置并不完全正确,但是想对有效的网络位置求解,此选项很有用。这是默认设置。
  • HALT如果存在无效位置,则不执行求解。随后您可对这些无效位置进行调整,然后重新运行分析。
Boolean
terminate_on_solve_error
(可选)

指定在求解过程中遇到错误时是否应终止工具执行。

  • TERMINATE该工具将在求解程序遇到错误时无法执行操作。这是默认设置。使用该选项时,如果工具因求解程序遇到错误而无法执行操作,则不创建任何 Result 对象。您应通过 ArcPy 对象获取地理处理消息。
  • CONTINUE即使求解程序遇到错误,该工具也不停止,而是继续执行操作。求解程序返回的所有错误消息都将转换为警告消息。使用该选项时,即使求解程序遇到错误,也始终创建 Result 对象,并将 maxSeverity 对象的 Result 属性设置为 1。将 Result 对象的 getOutput 方法和索引值 1 结合使用可确定求解程序是否成功。
Boolean
simplification_tolerance
(可选)

容差确定输出几何的简化程度。如果已指定了容差,容差必须大于零。可以选择首选单位;默认单位为十进制度。

指定简化容差会减少渲染路径或服务区的时间。但缺点是,简化几何移除了折点,这样会降低以更大比例输出的空间精确度。

由于带两个折点的线不能再简化,所以此参数对单一线段输出的绘制时间没有影响,例如直线路线、 OD 成本矩阵线和位置分配线。

Linear Unit
overrides
(可选)

求解网络分析问题时,指定可影响求解程序行为的其他设置。

需要在 JavaScript 对象表示法 (JSON) 中指定此参数的值。例如,有效值的格式如下:{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。覆盖设置名称始终以双引号括起。该值可以是数字、布尔值或字符串。

此参数的默认值为无值,表示不覆盖任何求解程序设置。

覆盖是高级设置,应仅在谨慎分析应用设置前后得到的结果之后使用。要获得每个求解程序支持的覆盖设置及其可接受值的列表,请联系 Esri 技术支持。

String

派生输出

名称说明数据类型
output_layer

已求解的网络分析图层。

网络分析图层
solve_succeeded

指示求解是否成功的布尔值。

布尔型

代码示例

Solve 示例 1(Python 窗口)

使用所有参数执行工具。

arcpy.na.Solve("Route", "HALT", "TERMINATE", "10 Meters")
Solve 示例 2(工作流)

以下独立 Python 脚本演示了如何使用 Solve 工具执行最近设施点分析并将结果保存到图层文件中。

# Name: Solve_Workflow.py
# Description: Solve a closest facility analysis to find the closest warehouse
#              from the store locations and save the results to a layer file on
#              disk.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
    if arcpy.CheckExtension("network") == "Available":
        arcpy.CheckOutExtension("network")
    else:
        raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
    
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/Paris.gdb"
    network = os.path.join(input_gdb, "Transportation", "ParisMultimodal_ND")
    layer_name = "ClosestWarehouse"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "Warehouses")
    incidents = os.path.join(input_gdb, "Analysis", "Stores")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new closest facility analysis layer.
    result_object = arcpy.na.MakeClosestFacilityAnalysisLayer(network,
                                            layer_name, travel_mode,
                                            "TO_FACILITIES",
                                            number_of_facilities_to_find=1)

    #Get the layer object from the result object. The closest facility layer can
    #now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the closest facility layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    incidents_layer_name = sublayer_names["Incidents"]

    #Load the warehouses as Facilities using the default field mappings and
    #search tolerance
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            facilities, "", "")

    #Load the stores as Incidents. Map the Name property from the NOM field
    #using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    incidents_layer_name)
    field_mappings["Name"].mappedFieldName = "NOM"
    arcpy.na.AddLocations(layer_object, incidents_layer_name, incidents,
                          field_mappings, "")

    #Solve the closest facility layer
    arcpy.na.Solve(layer_object)

    #Save the solved closest facility layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    print("Script completed successfully")

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print("An error occurred on line %i" % tb.tb_lineno)
    print(str(e))

环境

特殊情况

许可信息

  • Basic: 受限
  • Standard: 受限
  • Advanced: 受限

相关主题