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

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

Преобразует изменения событий из одной системы измерений на маршруте в другую и записывает их в новую таблицу событий.

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

Преобразование событий позволяет использовать события из одной системы измерений на маршруте с другой системой, имеющей различные идентификаторы маршрута, измерения или и то и другое.
Любое полное или частичное событие, пересекающее целевой маршрут, записывается в новую таблицу событий.
Наилучший результат будет получен, если исходные и целевые маршруты полностью накладываются друг на друга.

Внимание:

Использование большого значения параметра Кластерный допуск для преодоления расхождения между исходным и целевым маршрутами может привести к неожиданным результатам.
Значение Тип события (Точка или Линия) должно соответствовать входному типу события.
Используйте инструмент Создать представление таблицы перед применением этого инструмента, чтобы значительно сократить число событий, которые будут обрабатываться.
Выходная таблица может быть показана на карте с помощью инструмента Создать слой событий на маршруте.

Подпись	Объяснение	Тип данных
Входная таблица событий	Входная таблица событий.	Table View
Свойства таблицы событий	Поля местоположений на маршруте и тип событий во входной таблице событий. Поле идентификатора маршрута—поле, содержащее значения, которые определяют маршрут, на котором находится каждое из событий. Это поле может быть числовым, текстовым или GUID. Тип событий—тип событий в выходной таблице событий (Point или Line). Point—точечные события, происходящие в определенной точке маршрута. Требуется указать только Поле измерения От. Line—линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. Поле измерений От—поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события Point или Line. Если значение Тип события — Point, надпись для этого параметра будет Поле измерений. Поле измерений До—поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события Line.	Route Measure Event Properties
Объекты исходного маршрута	Входные объекты маршрута.	Feature Layer
Поле идентификатора исходного маршрута	Поле, содержащее значения, уникально идентифицирующие каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
Объекты целевого маршрута	Объекты-маршруты, в систему измерений которых.	Feature Layer
Поле идентификатора целевого маршрута	Поле, содержащее значения, которые уникально идентифицируют каждый целевой маршрут. Поле может быть числовым, текстовым или GUID.	Field
Выходная таблица событий	Создаваемая таблица.	Table
Свойства выходной таблицы событий	Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий. Поле идентификатора маршрута—поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий. Поле может быть числовым, текстовым или GUID. Тип событий—тип событий, которые будет содержать выходная таблица событий (Точка или Линия). Point—точечные события, происходящие в определенной точке маршрута. Требуется указать только одно поле измерения. Line—линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. Поле измерений От—поле, в котором будут содержаться значения измерений. Это поле необходимо, если тип события Point или Line. Если значение Тип события — Point, надпись для этого параметра будет Поле измерений. Поле измерений До—поле, в котором будут содержаться значения измерений. Это поле необходимо, если тип события Line.	Route Measure Event Properties
Кластерный допуск	Максимально допустимое расстояние между входными событиями и целевыми маршрутами.	Linear Unit
Включить все поля из входных данных (Дополнительный)	Определяет, будет ли значение параметра Выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов. Отмечено–Значение параметра Выходная таблица событий будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию. Не отмечено–Значение параметра Выходная таблица событий будет содержать только поля местоположения маршрута и поле `ObjectID` из входных объектов.	Boolean

arcpy.lr.TransformRouteEvents(in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})

Имя	Объяснение	Тип данных
in_table	Входная таблица событий.	Table View
in_event_properties	Поля местоположений на маршруте и тип событий во входной таблице событий. Route identifier field—Поле, содержащее значения, которые определяют маршрут, на котором находится каждое из событий. Это поле может быть числовым, текстовым или GUID. Event type—Тип событий в выходной таблице событий (`POINT` или `LINE`). `POINT`—Точечные события, относящиеся к точным местоположениям на маршруте. Требуется указать только Поле измерения От. `LINE`—Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. From-measure field—Поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события `POINT` или `LINE`. To-measure field—Поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события — `LINE`.	Route Measure Event Properties
in_routes	Входные объекты маршрута.	Feature Layer
route_id_field	Поле, содержащее значения, уникально идентифицирующие каждый маршрут. Поле может быть числовым, текстовым или GUID.	Field
target_routes	Объекты-маршруты, в систему измерений которых.	Feature Layer
target_route_id_field	Поле, содержащее значения, которые уникально идентифицируют каждый целевой маршрут. Поле может быть числовым, текстовым или GUID.	Field
out_table	Создаваемая таблица.	Table
out_event_properties	Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий. Route identifier field—Поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий. Поле может быть числовым, текстовым или GUID. Event type—Тип событий, которые будет содержать выходная таблица событий (`POINT` или `LINE`). `POINT`—Точечные события, относящиеся к точным местоположениям на маршруте. Требуется указать только одно поле измерения. `LINE`—Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. From-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `POINT` или `LINE`. To-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `LINE`.	Route Measure Event Properties
cluster_tolerance	Максимально допустимое расстояние между входными событиями и целевыми маршрутами.	Linear Unit
in_fields (Дополнительный)	Определяет, будет ли значение параметра `out_table` кроме информации о маршруте содержать все атрибуты входных объектов. `FIELDS`–Значение параметра `out_table` будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию. `NO_FIELDS`–Значение параметра `out_table` будет содержать только поля местоположения маршрута и поле `ObjectID` из входных объектов.	Boolean

Пример кода

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

Следующее окно скрипта Python демонстрирует использование функции TransformRouteEvents:

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.TransformRouteEvents("pavement.dbf", "route1 LINE begin_mp end_mp",
                              "hwy.shp", "route1", "hwy_new.shp", "route1",
                              "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters")

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

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

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_tbl = "accident"
in_props = "route1 POINT measure"
in_rt = "roads/hwy"               # hwy exists in the roads feature dataset
in_rid = "route1"
target_rt = "roads/hwy_new"       # hwy_new exists in the roads feature dataset
target_rid = "route1"
out_tbl = "trans_out2"
out_props = "route1 POINT mp"
tol = "0.1 meters"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt,
                              target_rid, out_tbl, out_props, tol)

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

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

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc)
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc)
in_rid = "route1"
target_rt = arcpy.ValidateTableName("hwy_new", wkspc)
target_rid = "route1"
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt,
                              target_rid, out_tbl, out_props, tol)

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

Текущая рабочая область, Выходное ключевое слово конфигурации, Временная рабочая область

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

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