OriginDestinationCostMatrixResult

描述

包含起点 - 目的地成本矩阵分析结果的对象,可用于访问输出和求解程序消息。

讨论

此类实例无法直接创建, 而是由 OriginDestinationCostMatrix 类的 solve 方法返回。

属性

属性说明数据类型
isPartialSolution
(只读)

如果求解程序产生了部分解决方案,则将返回 True,这意味着并非所有输入都包含在结果中。如果其中一个输入未定位并且求解程序类的 ignoreInvalidLocations 属性被设置为 True,则会发生这种情况。

Boolean
solveSucceeded
(只读)

如果求解程序成功执行,则将返回 True

Boolean

方法概述

方法说明
count (output_type)

返回输出类型的行数。

export (output_type, output_features)

输出要素将在用于分析的网络数据集的空间参考中创建。如果已设置 arcpy.env.outputCoordinateSystem 环境,则将使用指定的坐标系创建输出要素。

将分析结果导出到要素类或表。

fieldNames (output_type)

返回指定输出类型支持的字段名称列表。

saveAsLayerFile (file_name)

将分析结果和设置保存到图层文件或图层包。可以在 ArcGIS Pro 中将图层文件或包作为分析设置记录打开或用于可视化结果。也可以在 ArcGIS Desktop 中打开图层文件。

如果分析引用门户服务作为网络数据源,则无法保存图层包。

如果求解程序对象上的 allowSaveLayerFile 属性设置为 False,该方法将返回 RuntimeError 异常。

searchCursor (output_type, field_names, {where_clause})

在指定的输出类型上建立搜索光标。此游标可用于直接从输出读取行。

solverMessages (severity)

获取求解程序返回的错误、警告和信息性消息。

方法

count (output_type)
参数说明数据类型
output_type

用于计数的输出要素类型。

应使用 OriginDestinationCostMatrixOutputDataType 枚举设置此参数。

Object
返回值
数据类型说明
Integer

行数。

不引发任何异常。

export (output_type, output_features)
参数说明数据类型
output_type

要导出的输出类型。

应使用 OriginDestinationCostMatrixOutputDataType 枚举设置此参数。

请参阅每种输出类型中包含的字段的描述

Object
output_features

包含导出要素的输出要素类或表的目录路径。

String
fieldNames (output_type)
参数说明数据类型
output_type

要返回其字段名称列表的输出类型。

应使用 OriginDestinationCostMatrixOutputDataType 枚举设置此参数。

请参阅每种输出类型中包含的字段的描述

Object
返回值
数据类型说明
String

指定输出类型支持的字段名称列表。

saveAsLayerFile (file_name)
参数说明数据类型
file_name

要写入的输出图层文件 (.lyr) 或图层包 (.lpkx) 的目录路径。

String
searchCursor (output_type, field_names, {where_clause})
参数说明数据类型
output_type

要读取的输出类型。

应使用 OriginDestinationCostMatrixOutputDataType 枚举设置此参数。

Object
field_names
[field_names,...]

游标将返回其值的输出类型的字段名称列表。您可以使用 fieldNames 方法获取输出类型支持的字段名称。

请参阅每种输出类型中包含的字段的描述

除常规字段外,还可以使用以下几何令牌之一访问输出的几何:

  • SHAPE@XY一组要素的质心 x,y 坐标。
  • SHAPE@XYZ一组要素的质心 x,y,z 坐标。
  • SHAPE@JSON 表示几何的 Esri JSON 字符串。
  • SHAPE@WKBOGC 几何的熟知二进制 (WKB) 制图表达。该存储类型将几何值表示为不间断的字节流形式。
  • SHAPE@WKTOGC 几何的熟知文本 (WKT) 制图表达。其将几何值表示为文本字符串。
  • SHAPE@要素的几何对象。

基于点的输出类型仅支持 SHAPE@XYSHAPE@XYZ 令牌。在使用 SHAPE@XYSHAPE@XYZ 令牌时返回的 x、y 和 z 值位于用于分析的网络数据源的空间参考中。

String
where_clause

用于限制所返回的记录的可选表达式。有关 WHERE 子句和 SQL 语句的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考

(默认值为 None)

String
返回值
数据类型说明
Object

从输出读取行的 SolverResultSearchCursor 对象。

solverMessages (severity)
参数说明数据类型
severity

要返回的消息类型。

应使用 MessageSeverity 枚举指定此参数。

Object
返回值
数据类型说明
List

返回的消息为由 列表组成的列表。内部列表包含两个值;第一个值为表示消息代码的数字,第二个值为消息文本。

从失败的起点 - 目的地成本矩阵分析返回的消息列表的示例。

[[-2147200995, '0 location(s) in "Destinations" are valid.  Need at least 1 valid location(s).'],
 [30024, 'Solve returned a failure.'],
 [-2147200995, 'Insufficient number of valid locations in "Origins" or "Destinations".']]