Краткая информация
Предоставляет доступ к свойствам слоя сетевого анализа маршрута. Функция GetSolverProperties используется для получения объекта RouteSolverProperties из слоя сетевого анализа маршрута.
Обсуждение
Объект RouteSolverProperties предоставляет доступ для чтения и записи ко всем свойствам анализа для слоя сетевого анализа маршрута. Этот объект можно использовать для изменения нужных свойств анализа слоя маршрута, а соответствующий слой можно повторно рассчитать для получения необходимых результатов. Новый слой маршрутов можно создать с помощью инструмента геообработки Создать слой маршрута. Получение объекта RouteSolverProperties из нового слоя маршрута позволяет повторно использовать существующий слой для последующего анализа, а не создавать слой для каждого анализа, что может замедлить процесс работы.
После изменения свойств объекта RouteSolverProperties, соответствующий слой можно немедленно использовать с другими функциями и инструментами геообработки. Обновлять слой для внесения изменения не требуется.
Свойства
Свойство | Описание | Тип данных |
accumulators (чтение и запись) | Дает возможность получать или задавать список сетевых атрибутов стоимости, сумма которых подсчитывается в ходе данного анализа. Пустой список, [], означает, что не подсчитывается сумма ни для каких атрибутов стоимости. | String |
attributeParameters (чтение и запись) | Дает возможность получать или задавать параметризированные атрибуты для использования их в анализе. Это свойство возвращает словарь Python. Ключом в словаре является кортеж двух значений – имени атрибута и имени параметра. Значение каждого элемента в словаре является значением параметра. Параметризованные сетевые атрибуты используются для моделирования некоторого динамического аспекта значения атрибута. Например, туннель с ограничением высоты 12 футов может быть смоделирован с использованием параметра. В этом случае высоту транспорта в футах нужно указать как значение параметра. Если транспортное средство выше 12 футов (3,7 м), то это ограничение будет оценено как True, ограничивающее, таким образом, проезд по туннелю. Аналогично у моста может быть параметр, указывающий ограничение по весу. Попытка изменить непосредственно свойство attributeParameters не приведет к обновлению значений. Вместо этого следует всегда использовать для установки значений этого свойства новый объект словаря. Различие между этими подходами проиллюстрировано следующими двумя блоками кода. Не стоит изменять свойство attributeParameters на месте; этот метод кодировки не будет работать. Измените свойство attributeParameters используя новый объект словарь. | Dictionary |
findBestSequence (чтение и запись) | Определяет, следует ли изменять порядок остановок для получения оптимальных маршрутов. Список возможных значений следующий:
| String |
impedance (чтение и запись) | Дает возможность получать или задавать сетевой атрибут стоимости, используемый в качестве импеданса. При определении оптимального маршрута этот атрибут стоимости минимизируется. | String |
orderingType (чтение и запись) | Определяет порядок остановок, если свойство findBestSequence имеет значение FIND_BEST_ORDER. Список возможных значений следующий:
| String |
outputPathShape (чтение и запись) | Дает возможность получать или задавать тип формы для объектов маршрута, получаемых в результате расчета. Список возможных значений следующий:
| String |
restrictions (чтение и запись) | Дает возможность получать или задавать список атрибутов ограничения, применяемых в ходе данного анализа. Пустой список, [], означает, что в ходе анализа не применяются никакие атрибуты ограничения. | String |
solverName (только чтение) | Возвращает имя механизма расчета, на который ссылается слой сетевого анализа, использованный для получения данного объекта свойств механизма расчета. Это свойство всегда возвращает строковое значение Route Solver при обращении к нему из объекта RouteSolverProperties. | String |
streetDirectionsProperties (чтение и запись) | Обеспечивает доступ на чтение и запись к StreetDirectionsProperties, позволяя настраивать выходные данные направлений из слоя маршрута. | Object |
timeOfDay (чтение и запись) | Дает возможность получать или задавать время и дату начала маршрута. Время начала маршрута в основном используется для поиска маршрутов на основе такого атрибута импеданса, который изменяется в течение суток. Например, время начала, равное 9 часам утра, может применяться для поиска маршрута с учетом дорожного движения в час пик. Значение None указывает на то, что дата и время не должны использоваться. Вместо конкретной даты может быть задан день недели, при помощи следующих условных дат:
К примеру, если маршрут должен начаться во вторник в 17:00, следует указать значение datetime.datetime(1900, 1, 2, 17,0,0). Параметр timeZoneUsage определяет, какому часовому поясу соответствуют эти время и дата: UTC или часовому поясу, в котором находится первая остановка. | DateTime |
timeZoneUsage (чтение и запись) | Указывает часовой пояс параметра timeOfDay.
При выполнении анализа маршрута, охватывающего несколько часовых поясов, в котором указывается начальное время, параметр orderingType не может иметь значение PRESERVE_NONE. Начальное местоположение и часовой пояс должны быть фиксированными. | String |
timeZoneUsageForTimeFields (чтение и запись) | Устанавливает часовой пояс полей даты-времени во входных данных, в том числе полей, которые используются для временных окон.
| String |
travelMode (только чтение) | Доступ к режиму движения устанавливается для слоя сетевого анализа как объект arcpy.na.TravelMode. | Object |
uTurns (чтение и запись) | Дает возможность получать или задавать политику работы с разворотами в соединениях, которые могут возникать в ходе прохода по сети между остановками. Список возможных значений следующий:
| String |
useHierarchy (чтение и запись) | Отвечает за использование атрибута иерархии при проведении анализа. Список возможных значений следующий:
| String |
useTimeWindows (чтение и запись) | Определяет необходимость использования для остановок временных окон. Список возможных значений следующий:
Примечание:Это свойство поддерживалось для обратной совместимости, но оно игнорируется в ArcGIS Pro. Слои маршрутов в ArcGIS Pro всегда будут использовать временные окна, если эти временные окна содержат значения | String |
Обзор метода
Метод | Описание |
applyTravelMode (travel_mode) | Обновляет свойства анализа слоя network analyst на основе объекта режима передвижения. После этого обновленный слой network analyst может быть рассчитан для завершения анализа. |
Методы
applyTravelMode (travel_mode)
Параметр | Описание | Тип данных |
travel_mode | Переменная, ссылающаяся на объект режима передвижения, который был получен на основе слоя сетевых данных. Список объектов режима передвижения можно получить, вызвав функцию arcpy.na.GetTravelModes. | Object |
При создании слоя network analyst он получит значения по умолчанию для всех своих свойств анализа. Отдельные свойства анализа можно обновлять с помощью объекта свойств механизма расчета, полученного из слоя network analyst. Режим перемещения сохраняет предопределенный набор настроек анализа, который помогает выполнять определенные виды анализа – например, режим передвижения пешком сохраняет настройки анализа, необходимые для выполнения по-временного анализа передвижения пешим ходом.
Используя метод applyTravelMode, за один раз могут применяться сразу все настройки анализа, заданные для режима передвижения. После того, как свойства анализа будут обновлены, слой network analyst может быть рассчитан для завершения анализа.
Если при обновлении свойств механизма расчета, например – когда режим передвижения ссылается на свойства, которые не существуют в текущем наборе сетевых данных, или же ссылается на свойства, которые уже не применяются к набору сетевых данных, использовавшемуся для создания слоя network analyst, соответствующего объекту свойств механизма расчета, исключительных ситуаций не возникает. Этот метод будет с успехом работать, но вы получите ошибки при попытке расчёта такого слоя network analyst.
Если параметр travel_mode не привязан к объекту режима передвижения или строке, возникает исключительная ситуация TypeError. Если параметр travel_mode привязан к строке, но строка не может быть внутренне конвертирована в строковое представление объекта режима передвижения, возникает исключительная ситуация ValueError.
Пример кода
В данном скрипте показано, как найти самый быстрый маршрут между остановками в два разных времени суток. Время передвижения на маршруте будет разным в силу изменяющейся загруженности дорог. В скрипте показано, как создать только один экземпляр слоя маршрутов, и изменить свойство timeOfDay с помощью объекта RouteSolverProperties для достижения желаемых результатов.
Прежние версии:
Функцию GetNASublayer можно использовать для извлечения подслоев слоя сетевого анализа. Она была введена в ArcGIS Pro 2.7. В предыдущих версиях программного обеспечения лучший способ получить объект подслоя слоя сетевого анализа заключался в использовании метода listLayers объекта Layer сетевого анализа с использованием имени подслоя в качестве подстановочного знака.
# Name: RouteSolverProperties_workflow_01.py
# Description: Find the fastest route at two different times of day. The travel
# time is different because of traffic conditions. Use the
# RouteSolverProperties object to update an existing Route layer
# before re-running the analysis.
# 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/SanFrancisco.gdb"
network = os.path.join(input_gdb, "Transportation", "Streets_ND")
stops = os.path.join(input_gdb, "Analysis", "Stores")
route_0830 = os.path.join(output_dir, "Output.gdb", "Route_MorningRush")
route_1100 = os.path.join(output_dir, "Output.gdb", "Route_MidMorning")
# Make a new route layer using travel time as impedance to determine fastest
# route
route_layer = arcpy.na.MakeRouteAnalysisLayer(network, "StoresRoute",
"Driving Time",
time_of_day="8:30 AM").getOutput(0)
# Get the network analysis class names from the route layer
na_classes = arcpy.na.GetNAClassNames(route_layer)
# Load stops
arcpy.na.AddLocations(route_layer, na_classes["Stops"], stops)
# Solve the route layer
arcpy.na.Solve(route_layer)
# Get the routes sublayer from the route layer
routes_sublayer = arcpy.na.GetNASublayer(route_layer, "Routes")
# Save the resulting route as a feature class. This route was solved at 8:30
# AM, morning rush hour.
arcpy.management.CopyFeatures(routes_sublayer, route_0830)
# Get the RouteSolverProperties object from the route layer to modify the
# timeOfDay property of the route layer.
solver_props = arcpy.na.GetSolverProperties(route_layer)
# Set the impedance property to "Meters" to determine the shortest route.
solver_props.timeOfDay = "11:00 AM"
# Re-solve the route layer
arcpy.na.Solve(route_layer)
# Save the resulting route as a feature class. This route was solved at 11:00
# AM, mid-morning when traffic is probably lighter.
arcpy.management.CopyFeatures(routes_sublayer, route_1100)
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 occured on line %i" % tb.tb_lineno)
print(str(e))
В этом скрипте показано, как использовать режим передвижения TruckingTime для существующего слоя.
#Get the route layer object from a layer named "Route" in the map
doc = arcpy.mp.ArcGISProject('current')
map_obj = doc.listMaps()[0]
route_layer = map_obj.listLayers('Route')[0]
#Get the Trucking Time travel mode from the network dataset
desc = arcpy.Describe(route_layer)
travel_modes = arcpy.na.GetTravelModes(desc.network.catalogPath)
trucking_mode = travel_modes["Trucking Time"]
#Apply the travel mode to the analysis layer
solver_properties = arcpy.na.GetSolverProperties(route_layer)
solver_properties.applyTravelMode(trucking_mode)