ODCostMatrixSolverProperties (arcpy.na)

Краткая информация

Предоставляет доступ к свойствам слоя сетевого анализа матрицы "стоимости" достижения цели (OD). Функция GetSolverProperties используется для получения объекта ODCostMatrixSolverProperties из слоя сетевого анализа матрицы "стоимости" достижения цели.

Обсуждение

Объект ODCostMatrixSolverProperties предоставляет доступ для чтения и записи ко всем свойствам слоя сетевого анализа матрицы "стоимости" достижения цели. Этот объект можно использовать для изменения нужных свойств анализа слоя матрицы "стоимости" достижения цели, а соответствующий слой можно повторно рассчитать для получения необходимых результатов. Новый слой матрицы "стоимости" достижения цели можно создать с помощью инструмента геообработки Создать слой матрицы Источник-Назначение (Make OD Cost Matrix Layer). Получение объекта ODCostMatrixSolverProperties из нового слоя матрицы стоимости OD позволяет повторно использовать существующий слой для последующего анализа, а не создавать новый слой для каждого анализа, что может замедлять работу.

После изменения свойства объекта ODCostMatrixSolverProperties соответствующий слой можно использовать с другими функциями и инструментами геообработки. Обновлять слой для внесения изменения не требуется.

Свойства

СвойствоОбъяснениеТип данных
accumulators
(чтение и запись)

Дает возможность получать или задавать список сетевых атрибутов стоимости, сумма которых подсчитывается в ходе данного анализа. Пустой список ([]) означает, что не подсчитывается сумма ни для каких атрибутов стоимости.

String
attributeParameters
(чтение и запись)

Дает возможность получать или задавать параметризованные атрибуты для использования их в анализе. Это свойство возвращает словарь Python. Ключом в словаре является кортеж двух значений – имени атрибута и имени параметра. Значение каждого элемента в словаре является значением параметра.

Параметризованные сетевые атрибуты используются для моделирования некоторого динамического аспекта значения атрибута. Например, туннель с ограничением высоты 12 футов может быть смоделирован с использованием параметра. В данном случае в качестве значения параметра следует указать высоту транспортного средства в футах. Если транспортное средство выше, чем 12 футов (3,7 м), ограничение будет оценено как верное (true), таким образом, проезд по туннелю будет запрещен. Подобным образом у моста может быть параметр, указывающий ограничение по весу.

Попытка изменить непосредственно свойство attributeParameters не приведет к обновлению значений. Вместо этого следует всегда использовать для установки значений этого свойства новый объект словаря. Различие между этими подходами проиллюстрировано следующими двумя блоками кода.

#Don't attempt to modify the attributeParameters property in place.
#This coding method won't work.

solverProps.attributeParameters[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED"

#Modify the attributeParameters property using a new dictionary object.
#This coding method works. 

params = solverProps.attributeParameters
params[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED"
solverProps.attributeParameters = params
Если слой сетевого анализа не имеет параметризованных атрибутов, это свойство вернет значение None (Нет).

Dictionary
defaultCutoff
(чтение и запись)

Дает возможность получать или задавать значение импеданса по умолчанию, при котором следует прекратить поиск пунктов назначения для данного исходного пункта. Значение None (Нет) указывает, что не следует применять никакого предельного значения.

Double
defaultTargetDestinationCount
(чтение и запись)

Дает возможность получать или задавать количество пунктов назначения, которые следует искать для каждого исходного пункта. Значение None (Нет) указывает, что следует вести поиск всех пунктов назначения.

Integer
impedance
(чтение и запись)

Дает возможность получать или задавать сетевой атрибут стоимости, используемый в качестве импеданса. При определении маршрута между исходными пунктами и пунктами назначения этот атрибут стоимости минимизируется.

String
outputPathShape
(чтение и запись)

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

  • NO_LINES —Между парой пунктов источник-назначение не создается никаких геометрических форм. Это удобно при большом количестве исходных и конечных пунктов, когда необходимо получить только табличные данные (без линий маршрутов).
  • STRAIGHT_LINES —Между каждой парой пунктов источник-назначение создается одна прямая линия.
String
restrictions
(чтение и запись)

Дает возможность получать или задавать список атрибутов ограничения, применяемых в ходе данного анализа. Пустой список ([]) означает, что в ходе анализа не применяются никакие атрибуты ограничения.

String
solverName
(только чтение)

Возвращает имя механизма расчета, на который ссылается слой сетевого анализа, использованный для получения данного объекта свойств механизма расчета. Это свойство всегда возвращает строковое значение OD Cost Matrix Solver (Механизм расчета матрицы Источник-Назначение), если доступ к нему осуществляется из объекта ODCostMatrixSolverProperties.

String
timeOfDay
(чтение и запись)

Дает возможность получать или задавать время и дату отправления из исходного пункта. Значение None (Нет) указывает на то, что дата и время не применяются.

Вместо конкретной даты может быть задан день недели, при помощи следующих условных дат:

  • Сегодня – 30.12.1899
  • Воскресенье – 31.12.1899
  • Понедельник – 01.01.1900
  • Вторник – 02.01.1900
  • Среда – 03.01.1900
  • Четверг – 04.01.1900
  • Пятница – 05.01.1900
  • Суббота – 06.01.1900

К примеру, если маршрут из каждого исходного пункта должен начинаться в 8:00 утра в среду, следует указать значение datetime.datetime(1900, 1, 3, 8,0,0).

Параметр timeZoneUsage определяет, соответствует ли время и дата зоне UTC или часовому поясу, в котором находятся заказы.

DateTime
timeZoneUsage
(чтение и запись)

Указывает часовой пояс параметра timeOfDay.

  • GEO_LOCAL —Значение параметра timeOfDay относится к часовому поясу, в котором находятся начальные точки.
  • UTC —Значения параметра timeOfDay указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если хотите провести анализ для конкретного времени, например текущего, но не знаете, в каком часовом поясе будут находиться начальные точки.

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

String
useHierarchy
(чтение и запись)

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

  • USE_HIERARCHY — Для анализа используется атрибут иерархии. Применение иерархии приводит к предпочтению при расчете ребер высшего порядка по сравнению с ребрами низшего порядка. Расчеты с иерархией выполняются быстрее, и они могут использоваться для моделирования предпочтений водителя, который скорее выберет для проезда автостраду, нежели местную дорогу – даже если это приведет к увеличению длины пути. Эта опция применима только в том случае, если в наборе сетевых данных, на который ссылается слой сетевых данных ArcGIS Network Analyst, имеется атрибут иерархии. Для выбора этого варианта также служит значение True.
  • NO_HIERARCHY —Для анализа атрибут иерархии не используется. Расчет без применения иерархии дает точный маршрут для набора сетевых данных. Для выбора этого варианта также служит значение False.
String
uTurns
(чтение и запись)

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

  • ALLOW_UTURNS —Развороты разрешены в соединениях с любым количеством смежных ребер.
  • NO_UTURNS —Развороты запрещены во всех соединениях, вне зависимости от их валентности. Обратите внимание, что, даже при выборе этого параметра, развороты все же разрешены в сетевых положениях. Чтобы запретить развороты и в положениях сети, можно задать индивидуальное свойство положения CurbApproach.
  • ALLOW_DEAD_ENDS_ONLY —Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Зачастую сети имеют избыточные соединения в середине сегмента дороги. Этот вариант позволяет предотвратить развороты транспортных средств в подобных точках.
String

Пример кода

Пример ODCostMatrixSolverProperties (окно Python)

Скрипт показывает, как обновить слой сетевого анализа матрицы источник-назначение, чтобы найти все цели, находящиеся в пределах пятиминутного значения. Предполагается, что слой матрицы источник-назначение Store Accessibility был создан в новом документе карты на основе учебного набора сетевых данных на территорию города Сан-Франциско. 

#Get the OD cost matrix layer object from a layer named "Store Accessibility" in
#the table of contents
odLayer = arcpy.mapping.Layer("Store Accessibility")

#Get the solver properties object from the OD cost matrix layer
solverProps = arcpy.na.GetSolverProperties(odLayer)

#Update the properties for the OD cost matrix layer using the solver properties
#object
solverProps.defaultCutoff = 5
solverProps.defaultTargetDestinationCount = None

Связанные темы

Анализ матрицы Источник-Назначение
Copyright © 1995-2014 Esri. All rights reserved.
5/10/2014