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

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

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

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

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

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

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

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

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

• Временные векторные слои могут отображаться в ArcMap, если указано, что нужно добавить результаты операций геообработки к отображению в меню Геообработка (Geoprocessing) > Опции Геообработки...(Geoprocessing Options...) > Добавить результат операций геообработки к отображению (Add results of geoprocessing operations to the display).

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

Синтаксис

MakeRouteEventLayer_lr (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 (дополнительно)	Определяет тип местоположения угла, который будет вычисляться. Этот параметр доступен только, если указан ANGLE_FIELD. NORMAL —Будет вычислен нормальный (перпендикулярный) угол. Это значение по умолчанию. TANGENT —Будет вычислен угол наклона касательной.	String
complement_angle (дополнительно)	Определяет, будет ли вычисляться дополнительный угол в поле угла. Этот параметр доступен только, если указан ANGLE_FIELD. ANGLE —Не записывать дополнительный угол в поле угла. Записывать только вычисляемый угол. Это значение по умолчанию. COMPLEMENT —Записать дополнительный угол в поле угла.	Boolean
offset_direction (дополнительно)	Определяет, с какой стороны будут помещены события с положительным сдвигом. Этот параметр доступен только, если определено поле сдвига. LEFT —События с положительным сдвигом будут помещены слева от маршрута. Сторона маршрута определяется измерениями и не обязательно направление вектора. Это значение по умолчанию. RIGHT —События с положительным сдвигом будут помещены справа от маршрута. Сторона маршрута определяется направлением вектора.	Boolean
point_event_type (дополнительно)	Определяет, будут ли точечные события рассматриваться в качестве точечных или мультиточечных объектов. POINT —Точечные события будут рассматриваться как точечные объекты. Это значение по умолчанию. МУЛЬТИТОЧКА (MULTIPOINT) —Точечные события будут рассматриваться как мультиточечные объекты.	Boolean

Пример кода

Пример. Создать слой событий на маршруте (MakeRouteEventLayer) (окно Python)

import arcpy
from arcpy import env

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

Пример инструмента MakeRouteEventLayer (автономный скрипт Python)

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

# Name: MakeRouteEventLayer_Example.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.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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")

Пример №2 инструмента MakeRouteEventLayer (автономный скрипт Python)

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

# Name: MakeRouteEventLayer_Example2.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.
# Author: ESRI

# Import system modules 
import arcpy
from arcpy import env

# Set workspace
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")

Пример №3 инструмента MakeRouteEventLayer (автономный скрипт Python)

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

# Name: MakeRouteEventLayer_Example3.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.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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")

Пример №4 инструмента MakeRouteEventLayer (автономный скрипт Python)

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

# 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
from arcpy import env

# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde" 

# Set local variables
ds = gp.QualifyTableName("roads", wkspc)          # the 'roads' feature dataset
fc = gp.QualifyTableName("hwy", wkspc)            # the 'hwy' feature class 
rt = ds + "/" + fc #the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = gp.QualifyTableName("accident", wkspc)
props = "rkey POINT mile"
lyr = "accident_events2" 

# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr)

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

Текущая рабочая область (Current Workspace), Выходное ключевое слово CONFIG (Output CONFIG Keyword), Временная рабочая область (Scratch Workspace)

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

ArcGIS for Desktop Basic: Да

ArcGIS for Desktop Standard: Да

ArcGIS for Desktop Advanced: Да