Создать слой событий на маршруте

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

Создает временный векторный слой объектов с использованием маршрутов и событий.

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

Использование

• Входная таблица может быть любого типа, который поддерживает ArcGIS.

• Используйте инструмент Создать векторный слой для маршрутов и/или инструмент Создать представление таблицы для событий перед запуском этого инструмента, чтобы уменьшить количество обрабатываемых событий и маршрутов.

• Не все типы таблиц имеют поле ObjectID. Если этим инструментом используются подобные таблицы, результирующий слой не будет доступен для выборки и и не сможет быть эффективно использован некоторыми операциями геообработки. Рассмотрите возможность использования инструмента Создать таблицу запроса, прежде чем использовать этот инструмент для добавления виртуального поля ObjectID.

• Временные слои хранятся в памяти и могут быть использованы в качестве входных данных для других функций геообработки в текущем сеансе ArcCatalog или ArcMap.

• Временные векторные слои могут отображаться в ArcMap, если указано, что нужно добавить результаты операций геообработки к отображению в меню Геообработка > Опции Геообработки... > Добавить результат операций геообработки к отображению.

• После завершения работы ArcCatalog или ArcMap, временные векторные слои будут удалены из памяти. Для сохранения временного слоя на диске используйте инструменты Сохранить в файл слоя или Копировать объекты.

Синтаксис

MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})

Параметр	Объяснение	Тип данных
in_routes	Объекты-маршруты, на которых будут расположены события.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут.	Field
in_table	Таблица, строки которой будут расположены вдоль маршрутов.	Table View
in_event_properties	Параметр, состоящий из полей, определяющих местоположения на маршруте и типа событий во входной таблице событий. Поле идентификатора маршрута – поле, содержащее значения, определяющие, к какому маршруту относится каждое из событий. Это поле может быть числовым или текстовым. Тип события – Тип события во входной таблице события (POINT или LINE). POINT – Точечное событие происходит в определенной точке маршрута. Требуется указать только Поле измерения "От ". LINE – Линейное событие затрагивает участок маршрута. Требуется указать поля измерений "От " и "До ". Поле измерений "От " – Поле, содержащее значения измерений. Является обязательным для точечных и линейных событий. При этом для события типа POINT этот параметр будет обозначен как Поле измерений. Поле измерений "До " – Поле, содержащее значения измерений. Это поле должно быть цифровым и обязательным, если выбран тип событий LINE.	Route Measure Event Properties
out_layer	Слой, который будет создан. Этот слой хранится в памяти, поэтому не нужно вводить путь.	Feature Layer
offset_field (Дополнительный)	Поле, содержащее значения, используемые для сдвига событий с их основного маршрута. Это поле должно быть числовым.	Field
add_error_field (Дополнительный)	Определяет, будет ли добавлено поле с именем LOC_ERROR к созданному временному слою. NO_ERROR_FIELD —Не добавлять поле для хранения ошибок местоположения. Используется по умолчанию. ERROR_FIELD —Добавлять поле для хранения ошибок местоположения.	Boolean
add_angle_field (Дополнительный)	Определяет, будет ли добавлено поле с именем LOC_ANGLE к созданному временному слою. Этот параметр доступен только, если тип события POINT. NO_ANGLE_FIELD —Не добавлять поле для хранения углов местоположения. Используется по умолчанию. ANGLE_FIELD —Добавлять поле для хранения углов местоположения.	Boolean
angle_type (Дополнительный)	Определяет тип местоположения угла, который будет вычисляться. Параметр доступен только при соблюдении условия add_angle_field = "ANGLE_FIELD". NORMAL —Будет вычислен нормальный (перпендикулярный) угол. Используется по умолчанию. TANGENT —Будет вычислен угол наклона касательной.	String
complement_angle (Дополнительный)	Определяет, будет ли вычисляться дополнительный угол в поле угла. Параметр доступен только при соблюдении условия add_angle_field = "ANGLE_FIELD". ANGLE —Не записывать дополнительный угол в поле угла. Записывать только вычисляемый угол. Используется по умолчанию. COMPLEMENT —Записать дополнительный угол в поле угла.	Boolean
offset_direction (Дополнительный)	Определяет, с какой стороны будут помещены события с положительным сдвигом. Этот параметр доступен только, если определено поле сдвига. LEFT —События с положительным сдвигом будут помещены слева от маршрута. Сторона маршрута определяется измерениями и не обязательно направление вектора. Используется по умолчанию. RIGHT —События с положительным сдвигом будут помещены справа от маршрута. Сторона маршрута определяется направлением вектора.	Boolean
point_event_type (Дополнительный)	Определяет, будут ли точечные события рассматриваться в качестве точечных или мультиточечных объектов. POINT —Точечные события будут рассматриваться как точечные объекты. Используется по умолчанию. MULTIPOINT —Точечные события будут рассматриваться как мультиточечные объекты.	Boolean

Пример кода

MakeRouteEventLayer, пример 1 (окно Python)

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")

MakeRouteEventLayer, пример 2 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer.

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")

MakeRouteEventLayer, пример 3 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer.

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")

MakeRouteEventLayer, пример 4 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer с данными многопользовательской базы геоданных.

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

MakeRouteEventLayer, пример 5 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer с данными персональной базы геоданных.

# Name: MakeRouteEventLayer_Example5.py
# Description: Make a LINE event layer. Routes and events are in a personal geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.mdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")

Параметры среды

• Текущая рабочая область
• Выходное ключевое слово CONFIG
• Временная рабочая область

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да