ServiceAreaSolverProperties (arcpy.na)

Резюме

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

Обсуждение

Объект ServiceAreaSolverProperties предоставляет доступ для чтения и записи ко всем свойствам слоя сетевого анализа областей обслуживания. Этот объект можно использовать для изменения нужных свойств анализа слоя ServiceAreaSolverProperties, а соответствующий слой можно повторно рассчитать для получения необходимых результатов. Новый слой областей обслуживания можно создать с помощью инструмента геообработки Создать слой области обслуживания (Make Service Area Layer). Получение объекта ServiceAreaSolverProperties из нового слоя областей обслуживания позволяет повторно использовать существующий слой для последующего анализа, а не создавать новый слой для каждого анализа, что может замедлять работу.

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

Свойства

Свойство	Объяснение	Тип данных
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
defaultBreaks (чтение и запись)	Дает возможность получать или задавать значения импеданса, определяющие экстент области обслуживания для расчета. Для создания концентрических областей можно использовать несколько полигональных границ. Например, чтобы определить области обслуживания для одного пункта обслуживания со временами 2, 3 и 5 минут, следует указать значение [2,3, 5].	Double
excludeSources (чтение и запись)	Дает возможность получать или задавать список сетевых источников, исключаемых в процессе создания полигонов. Геометрия используемых элементов от исключенных источников не включается в полигоны. Пустой список ([]) означает, что никакие сетевые источники не будут исключены.	String
impedance (чтение и запись)	Дает возможность получать или задавать сетевой атрибут стоимости, используемый в качестве импеданса. Этот атрибут стоимости суммируется при определении области обслуживания.	String
includeNetworkSourceFields (чтение и запись)	Определяет, будут ли к линиям областей обслуживания добавлены дополнительные поля из исходных пространственных объектов, используемых в анализе. Список возможных значений следующий: LINES_SOURCE_FIELDS — Добавляет к линиям областей обслуживания поля SourceID, SourceOID, FromPosition и ToPosition для хранения сведений об исходных пространственных объектах, используемых в анализе. Это помогает объединять результаты линий области обслуживания с исходными данными. Для выбора этого варианта также служит значение True. NO_LINES_SOURCE_FIELDS —Не добавляет к линиям областей обслуживания поля SourceID, SourceOID, FromPosition и ToPosition. Для выбора этого варианта также служит значение False.	String
lineOverlap (чтение и запись)	Определяет, будут ли при расчете линий областей обслуживания создаваться перекрывающиеся линии. Список возможных значений следующий: OVERLAP — Включать отдельные линейные объекты для каждого пункта обслуживания, если пункты обслуживания имеют совпадающие области обслуживания. Для выбора этого варианта также служит значение True. NON_OVERLAP — Включать каждую линию области обслуживания один раз и связывать её с ближайшим пунктом обслуживания (имеющим наименьший импеданс). Для выбора этого варианта также служит значение False.	String
lineType (чтение и запись)	Дает возможность получать или задавать тип линий областей обслуживания, создаваемых в ходе анализа. Список возможных значений следующий: NO_LINES —Не создавать линии. TRUE_LINES —Линии создаются без измерений. TRUE_LINES_WITH_MEASURES —Линии создаются с размерами. Значения размеров генерируются на основе значений импеданса для каждой границы; при этом промежуточные значения интерполируются. Не используйте этот параметр, если вам необходимо ускорить расчеты.	String
polygonMerge (чтение и запись)	Определяет, необходимо ли объединять полигоны, имеющие общие граничные значения. Этот параметр применяется только при создании полигонов для нескольких пунктов обслуживания. Список возможных значений следующий: NO_MERGE —Создает отдельные полигоны для каждого пункта обслуживания. Полигоны могут накладываться друг на друга. NO_OVERLAP —Создает отдельные полигоны для каждого пункта обслуживания. Полигоны могут не накладываются друг на друга. MERGE — Объединяет полигоны нескольких пунктов обслуживания с общими граничными значениями.	String
polygonNesting (чтение и запись)	Определяет вид концентрических полигонов областей обслуживания – сплошные диски или кольца. Этот параметр применяется только при задании нескольких граничных значений для пунктов обслуживания. Список возможных значений следующий: RINGS —Не включает область с меньшим граничным значением. Создает полигоны между соседними граничными значениями. Этот параметр можно использовать для поиска областей между граничными значениями. Для выбора этого варианта также служит значение True. DISKS — Используется для создания полигонов от пункта обслуживания до граничного значения. Например, при создании 5- и 10-минутных областей обслуживания 10-минутная область будет включать 5-минутную. Этот параметр можно использовать для определения всей области между пунктом обслуживания и граничным значением. Для выбора этого варианта также служит значение False.	String
polygonType (чтение и запись)	Дает возможность получать или задавать тип создаваемых полигонов. Список возможных значений следующий: SIMPLE_POLYS —Создает генерализованные полигоны, построение которых осуществляется быстрее, но края таких полигонов могут не иметь нужной точности. DETAILED_POLYS —Создает детализированные полигоны, которые точно моделируют линии областей обслуживания и могут содержать островки недоступных областей. Этот вариант требует гораздо больше времени на вычисление, чем генерализованные полигоны. NO_POLYS —Выключает создание полигонов в случаях, когда желательно использовать линейное отображение областей обслуживания.	String
restrictions (чтение и запись)	Дает возможность получать или задавать список атрибутов ограничения, применяемых в ходе данного анализа. Пустой список ([]) означает, что в ходе анализа не применяются никакие атрибуты ограничения.	String
solverName (только чтение)	Возвращает имя механизма расчета, на который ссылается слой сетевого анализа, использованный для получения данного объекта свойств механизма расчета. Это свойство всегда возвращает строковое значение Service Area Solver (Механизм расчета области обслуживания), если доступ к нему осуществляется из объекта ServiceAreaSolverProperties.	String
splitLinesAtBreaks (чтение и запись)	Определяет, разбивать ли линии областей обслуживания при пересечении граничного значения. Список возможных значений следующий: SPLIT —Делить каждую линию между двумя границами на две линии – по одной для каждой области. Этот параметр необходим для обозначения линий области обслуживания разрывами. В противном случае используйте параметр NO_SPLIT. Это повысит производительность вычислений. NO_SPLIT —Линии не делятся на границах областей обслуживания.	String
timeOfDay (чтение и запись)	Дает возможность получать или задавать время отправления или прибытия в пункты обслуживания. Интерпретация этого значения зависит от того, какое направление движения задано – от пункта обслуживания или к нему. Оно представляет собой время отправления, когда свойство travelDirection имеет значение TRAVEL_FROM, и время прибытия, когда свойство travelDirection имеет значение TRAVEL_TO. Значение None (Нет) указывает на то, что дата и время не применяются. Вместо конкретной даты может быть задан день недели, при помощи следующих условных дат: Сегодня – 12/30/1899 Воскресенье – 12/31/1899 Понедельник – 1/1/1900 Вторник – 1/2/1900 Среда – 1/3/1900 Четверг – 1/4/1900 Пятница – 1/5/1900 Суббота – 1/6/1900 К примеру, если отправление из пункта обслуживания должно происходить в 8:00 в пятницу, следует указать значение datetime.datetime(1900, 1, 5, 8,0,0).	DateTime
travelDirection (чтение и запись)	Определяет направление, в котором суммируется импеданс в ходе анализа области обслуживания. Список возможных значений следующий: TRAVEL_FROM —Область обслуживания создается в направлении от пункта обслуживания. TRAVEL_TO —Область обслуживания создается в направлении к пункту обслуживания.	String
trimDistance (чтение и запись)	Дает возможность получать или задавать расстояние, в пределах которого происходит сокращение полигонов областей обслуживания. Значение свойства состоит из численного значения и единицы измерения расстояния, разделенных пробелом. К примеру, если расстояние для сокращения равно 100 метрам, следует указать значение "100 Meters".	String
trimPolygons (чтение и запись)	Определяет, следует ли сокращать полигоны областей обслуживания. Список возможных значений следующий: TRIM_POLYS —Обрезает полигоны до области в пределах заданного расстояния от границ. Это может быть необходимо для предотвращения охвата областей, не содержащих пространственных объектов. Для выбора этого варианта также служит значение True. NO_TRIM_POLYS —Не обрезать полигоны. Для выбора этого варианта также служит значение False.	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

Пример кода

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

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

#Get the service area layer object from a layer named "Store Trade Areas" in
#the table of contents
saLayer = arcpy.mapping.Layer("Store Trade Areas")

#Get the solver properties object from the service area layer
solverProps = arcpy.na.GetSolverProperties(saLayer)

#Update the properties for the service area layer using the solver properties
#object
solverProps.defaultBreaks = [5, 10, 15]
solverProps.useHierarchy = "USE_HIERARCHY"