VehicleRoutingProblemSolverProperties

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

Предоставляет доступ к свойствам из слоя задачи выбора маршрута транспорта Network Analyst. Функция GetSolverProperties используется для получения объекта VehicleRoutingProblemSolverProperties из слоя задачи выбора маршрута транспорта Network Analyst.

Описание

Объект VehicleRoutingProblemSolverProperties предоставляет доступ для чтения и записи ко всем свойствам слоя задачи выбора маршрута транспорта Network Analyst. Этот объект можно использовать для изменения нужных свойств анализа слоя задачи выбора маршрута транспорта, а соответствующий слой можно повторно рассчитать для получения необходимых результатов. Новый слой задачи выбора маршрута транспорта можно создать с помощью инструмента геообработки Создать слой задачи выбора маршрута транспорта (Make Vehicle Routing Problem Layer). Получение объекта VehicleRoutingProblemSolverProperties из нового слоя задачи выбора маршрута транспорта позволяет повторно использовать существующий слой для последующего анализа, а не создавать новый слой для каждого анализа, что может замедлять работу.

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

Свойства

Свойство	Объяснение	Тип данных
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
capacityCount (чтение и запись)	Дает возможность получать или задавать число измерений для ограничений ёмкости, необходимое для описания соответствующих лимитов транспортных средств.	Integer
defaultDate (чтение и запись)	Дает возможность получать или задавать дату, принимаемую для тех полей временных значений, в которых указано только время. Если поле времени для какого-либо объекта заказов, например, поле TimeWindowStart1, имеет значение времени без даты, принимается дата по умолчанию из свойства defaultDate. Например, если для параметра TimeWindowStart1 задано 9:00, а defaultDate установлена на datetime.date(2012, 3, 6), то все значение времени будет иметь вид 9:00 A.M., March 6, 2012. Дата по умолчанию не влияет на значения в поле времени, для которых указана дата. Также в качестве даты по умолчанию можно указать день недели, при помощи следующих условных дат: Сегодня – 30.12.1899 Воскресенье – 31.12.1899 Понедельник – 01.01.1900 Вторник – 02.01.1900 Среда – 03.01.1900 Четверг – 04.01.1900 Пятница – 05.01.1900 Суббота – 06.01.1900 Например, если в качестве неявной даты для полей времени должен выступать день недели – вторник, следует указать для этого свойства значение 1/2/1900.	DateTime
distanceAttribute (чтение и запись)	Дает возможность получать или задавать атрибут стоимости расстояния, используемый для определения длин элементов сети.	String
distanceFieldUnits (чтение и запись)	Дает возможность получать или задавать единицы расстояния, используемые в полях расстояния подслоев и таблиц слоя анализа (классов сетевого анализа). Эти единицы не обязательно должны совпадать с единицами сетевого атрибута стоимости, указанного в свойстве timeAttribute. Список возможных значений следующий: Сантиметры Дециметры Футы Дюймы Километры Метры Мили Миллиметры Морские мили Ярды	String
excessTransitTimeImportance (чтение и запись)	Дает возможность получать или задавать степень важности уменьшения избыточного времени в пути. Избыточное время в пути – это затрачиваемое сверх необходимого время для перемещения от одного заказа к другому. Лишнее время может возникать по причине перерывов или возвращения в гараж между вызовами. Список возможных значений следующий: High —Механизм расчета пытается найти решение с минимальным лишним временем между вызовами за счет увеличения общего времени в пути. Имеет смысл использовать этот параметр при необходимости перевозки людей между парами заказов, и вы хотите сократить их время в пути. Эта опция подходит для такси. Medium —Программа расчета будет стремиться найти компромиссное решение с одновременным сокращением избыточного времени и обеспечением минимальных общих затрат. Low —Программа расчета пытается найти решение, минимизирующее общие затраты, независимо от избыточного времени в пути. Этот параметр обычно используется курьерской службой. Поскольку курьерская служба перевозит грузы, а не людей, ей не нужно особенно заботиться о времени в пути. Значение Low позволяет курьерской службе обрабатывать два вызова в должной очередности с минимальными общими затратами.	String
outputPathShape (чтение и запись)	Дает возможность получать или задавать тип формы для объектов маршрута, получаемых в результате расчета. Список возможных значений следующий: TRUE_LINES_WITH_MEASURES —Полученные маршруты будут иметь точную форму лежащих ниже источников сети. Более того, в состав результатов будут входить также измерения маршрута в системе линейных координат. Эти измерения отсчитываются от первой остановки и записывают накапливаемый импеданс для достижения данного положения. TRUE_LINES_WITHOUT_MEASURES —Полученные маршруты будут иметь точную форму лежащих в основе источников сети. STRAIGHT_LINES —Форма итогового маршрута – прямые линии, соединяющие заказы и посещения станции с учетом последовательности маршрута. NO_LINES —Для выходных маршрутов форма не создается. Вы также не сможете создавать направления движения.	String
restrictions (чтение и запись)	Дает возможность получать или задавать список атрибутов ограничения, применяемых в ходе данного анализа. Пустой список, [], означает, что в ходе анализа не применяются никакие атрибуты ограничения.	String
solverName (только чтение)	Возвращает название механизма расчета, на который ссылается слой Network Analyst, использующийся для получения объекта свойств механизма расчета. Это свойство всегда возвращает строковое значение Vehicle Routing Problem Solver при обращении к нему из объекта VehicleRoutingProblemSolverProperties.	String
streetDirectionsProperties (чтение и запись)	Обеспечивает доступ на чтение и запись к StreetDirectionsProperties, позволяя настраивать выходные данные слоя выбора маршрута транспорта.	Object
timeAttribute (чтение и запись)	Дает возможность получать или задавать атрибут стоимости на основе времени, используемый для определения времени пути по элементам сети. При решении задачи этот атрибут стоимости сводится к минимуму.	String
timeFieldUnits (чтение и запись)	Дает возможность получать или задавать единицы измерения времени, используемые во временных полях подслоев и таблиц слоя анализа (классов сетевого анализа). Эти единицы не обязательно должны совпадать с единицами сетевого атрибута стоимости, указанного в свойстве timeAttribute. Список возможных значений следующий: Дни Часы Минуты Секунды	String
timeWindowViolationImportance (чтение и запись)	Дает возможность получать или задавать степень значимости временных окон в анализе. Нарушение временного окна происходит в случае прибытия транспортного средства по вызову, в гараж или на остановку после своего временного окна. Нарушение – это интервал времени между моментом окончания временного окна и моментом прибытия. Список возможных значений следующий: High —Механизм расчета пытается найти решений с минимальным нарушением временных окон путем увеличения общего времени в пути. Выберите этот вариант, если прибытие на заказы вовремя важнее, чем сокращение общей стоимости в анализе. Это может быть необходимо, если вы встречаетесь с клиентами по вашей просьбе и не хотите создавать им неудобства в случае опоздания (альтернативным вариантом является использование жесткого временного окна, которое нельзя нарушить).При наличии других ограничений задачи выбора маршрута транспорта может быть невозможно посетить все заказы в пределах выделенных для них временных окон. В этом случае могут возникнуть превышения временных окон даже с использованием этого варианта. Medium —Механизм расчета будет стремиться найти компромиссное решение с одновременным соблюдением временных окон и обеспечением минимальной общей стоимости решения. Low —Механизм расчета пытается найти решений с минимальным временем в пути независимо от временных окон. Выберите этот вариант, если соблюдение временных окон не столь важно, как сокращение общей стоимости в анализе. Этот параметр также можно использовать при накоплении отставания в обработке заказов. Для обработки как можно большего количества заказов в день и сокращения невыполненных заказов можно выбрать этот вариант, несмотря на то, что клиенты будут испытывать неудобства из-за позднего прибытия транспортных средств.	String
timeZoneUsageForTimeFields (чтение и запись)	Устанавливает часовой пояс полей даты-времени во входных данных, в том числе полей, которые используются для временных окон. GEO_LOCAL —Значения даты и времени для окон времени заказа заданы по времени часового пояса, в котором расположен этот заказ. UTC —Значения даты и времени для окон времени заказов указаны по универсальному глобальному времени (UTC).	String
useHierarchy (чтение и запись)	Отвечает за использование атрибута иерархии при проведении анализа. Список возможных значений следующий: USE_HIERARCHY — Для анализа используется атрибут иерархии. Применение иерархии приводит при расчете к предпочтению ребер высшего порядка по сравнению с ребрами низшего порядка. Расчеты с иерархией выполняются быстрее, и они могут использоваться для моделирования предпочтений водителя, который скорее выберет для проезда автостраду, нежели местную дорогу – даже если это приведет к увеличению длины пути. Эта опция применима только в том случае, если в наборе сетевых данных, на который ссылается слой сетевых данных Network Analyst, имеется атрибут иерархии. Для выбора этой опции также может использоваться значение True. NO_HIERARCHY —Для анализа атрибут иерархии не используется. Расчет без применения иерархии дает точный маршрут для набора сетевых данных. Для выбора этой опции также может использоваться значение False.	String
uTurns (чтение и запись)	Дает возможность получать или задавать политику работы с разворотами в соединениях, которые могут возникать в ходе прохода по сети между остановками. Список возможных значений следующий: ALLOW_UTURNS —Развороты разрешены в соединениях с любым количеством смежных ребер. NO_UTURNS —Развороты запрещены во всех соединениях, вне зависимости от их валентности. Обратите внимание, что, даже при выборе этой опции развороты в сетевых положениях по-прежнему разрешены. Запретить развороты в отдельных сетевых положениях можно с помощью свойства местоположения CurbApproach. ALLOW_DEAD_ENDS_ONLY —Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик). ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.	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.

Пример кода

VehicleRoutingProblemSolverProperties, пример 1

Скрипт демонстрирует, как обновить следующие свойства существующего слоя задачи выбора маршрута транспорта в таблице содержания ArcMap: Атрибут расстояния (Distance Attribute), Дата по умолчанию (Default Date), Развороты в соединениях (U-Turns at Junctions) и Тип выходной геометрии (Output Shape Type). Предполагается, что слой выбора маршрута транспорта Store Delivery Routes был создан в новом документе карты на основе учебного набора сетевых данных на территорию города Сан-Франциско.

#Get the vehicle routing problem layer object from a layer named
#"Store Delivery Routes" in the table of contents
vrpLayer = arcpy.mapping.Layer("Store Delivery Routes")

#Get the solver properties object from the vehicle routing problem layer
solverProps = arcpy.na.GetSolverProperties(vrpLayer)

#Update the properties for the vehicle routing problem layer using the 
#solver properties object
solverProps.distanceAttribute = "Meters"
#Set the default date to be Monday
solverProps.defaultDate = datetime.date(1900,1,1)
solverProps.uTurns = "NO_UTURNS"
solverProps.outputPathShape = "STRAIGHT_LINES"

ApplyTravelMode пример 2 (рабочий процесс)

Этот скрипт показывает, как находить маршруты для группы грузовых автомобилей, используя режим передвижения Время в пути грузового транспорта.

#Import modules
import os
import arcpy

#Define variables
workspace = "C:/data/SanDiego.gdb"
output_folder = "C:/data/output"
nds = os.path.join(workspace, "Transportation", "Streets_ND")
orders = os.path.join(workspace, "Orders")
depots = os.path.join(workspace, "TruckDepots")
routes = os.path.join(workspace, "Drivers")
analysis_layer_name = "TruckRoutes"

#Set environment variables
arcpy.env.overwriteOutput = True

#Check out the network analyst extension
arcpy.CheckOutExtension("network")

#Create a new closest facility analysis layer
make_layer_result = arcpy.na.MakeVehicleRoutingProblemLayer(nds, analysis_layer_name,
                                                            "TravelTime")
analysis_layer = make_layer_result.getOutput(0)

#Add orders, depots and routes to the analysis layer using default field mappings         
sub_layer_names = arcpy.na.GetNAClassNames(analysis_layer)
order_layer_name = sub_layer_names["Orders"]
depot_layer_name = sub_layer_names["Depots"]
route_layer_name = sub_layer_names["Routes"]
arcpy.na.AddLocations(analysis_layer, order_layer_name, orders, "#", "#")
arcpy.na.AddLocations(analysis_layer, depot_layer_name, depots, "#", "#")
arcpy.na.AddLocations(analysis_layer, route_layer_name, routes, "#", "#")

#Get the Trucking Time travel mode from the network dataset
travel_modes = arcpy.na.GetTravelModes(nds)
trucking_mode = travel_modes["Trucking Time"]

#Apply the travel mode to the analysis layer
solver_properties = arcpy.na.GetSolverProperties(analysis_layer)
solver_properties.applyTravelMode(trucking_mode)

#Solve the analysis layer skipping any invalid orders and save the result as a layer file          
arcpy.na.Solve(analysis_layer, "SKIP")

output_layer = os.path.join(output_folder, analysis_layer_name + ".lyr")
arcpy.management.SaveToLayerFile(analysis_layer, output_layer, "RELATIVE")

arcpy.AddMessage("Completed")