OriginDestinationCostMatrixResult

Сводка

Объект с результатами анализа матрицы Источник-Назначение, который можно использовать для доступа к выходным данным и сообщениям механизма расчета.

Описание

Экземпляры этого класса нельзя создавать напрямую. Но они возвращаются методом solve класса OriginDestinationCostMatrix.

Свойства

ВладениеОбъяснениеТип данных
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 Desktop или в ArcGIS Pro, как запись настроек анализа или для визуализации результатов.

Это метод возвращает исключение RuntimeError, если параметр allowSaveLayerFile объекта-механизма расчета задан как False.

searchCursor (output_type, field_names, {where_clause})

Задает курсор поиска для заданного типа выходных данных. Этот курсор предназначен для считывания строк непосредственно из выходных данных.

solverMessages (severity)

Получает сообщения об ошибках, предупреждениях и информационные сообщения, возвращаемые механизмом расчета.

Методы

count (output_type)
ParameterОбъяснениеТип данных
output_type

Тип подсчитываемых выходных объектов.

Параметр должен быть задан с помощью перечисления OriginDestinationCostMatrixOutputDataType.

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Integer

Число строк.

Не вызывает исключение.

export (output_type, output_features)
ParameterОбъяснениеТип данных
output_type

Тип выходных данных для экспорта.

Параметр должен быть задан с помощью перечисления OriginDestinationCostMatrixOutputDataType.

Object
output_features

Путь каталога к выходному классу объектов или таблице, где будут находиться экспортированные объекты.

String
fieldNames (output_type)
ParameterОбъяснениеТип данных
output_type

Тип выходных данных, для которых возвращается список имен полей.

Параметр должен быть задан с помощью перечисления OriginDestinationCostMatrixOutputDataType.

Object
Значение отраженного сигнала
Тип данныхОбъяснение
String

Список имен полей, поддерживаемых заданным выходным типом.

saveAsLayerFile (file_name)
ParameterОбъяснениеТип данных
file_name

Путь к каталогу выходного файла слоя (.lyr) для записи.

String
searchCursor (output_type, field_names, {where_clause})
ParameterОбъяснениеТип данных
output_type

Тип считываемых выходных данных.

Параметр должен быть задан с помощью перечисления OriginDestinationCostMatrixOutputDataType.

Object
field_names
[field_names,...]

Список имен полей типа выходных данных, значения в которых возвращает курсор. Вы можете получить имена полей, которые поддерживаются выходным типом с помощью метода fieldNames. Помимо обычных полей вы можете выполнять доступ к геометрии выходных данных с использованием одного из токенов геометрии:

  • SHAPE@XYКортеж x, y координат центроида объекта.
  • SHAPE@XYZКортеж x, y, z координат центроида объекта. Этот токен поддерживается, только если для геометрии включена координата z.
  • SHAPE@JSON Строка Esri JSON, представляющая геометрию.
  • SHAPE@WKBСтандартное двоичное (well-known binary, WKB) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов.
  • SHAPE@WKTСтандартное текстовое (well-known text, WKT) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде текстовой строки.
  • SHAPE@Объект geometry (геометрия) для пространственного объекта.

Токены SHAPE@XY и SHAPE@XYZ поддерживаются только точечными выходными типами.

String
where_clause

Возвращается дополнительное выражение, которое ограничивает записи. Более подробно об условиях WHERE и выражениях SQL см. раздел Справочник по SQL для элементов, используемых в выражениях запросов.

(Значение по умолчанию — None)

String
Значение отраженного сигнала
Тип данныхОбъяснение
Object

Объект SolverResultSearchCursor, считывающий строки выходных данных.

solverMessages (severity)
ParameterОбъяснениеТип данных
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".']]