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

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

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

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

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

  • Любое полное или частичное событие, пересекающее целевой маршрут, записывается в новую таблицу событий.

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

    Внимание:

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

  • Значение Тип события (Точка или Линия) должно соответствовать входному типу события.

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

  • Выходная таблица может быть показана на карте с помощью инструмента Создать слой событий на маршруте.

Параметры

ПодписьОписаниеТип данных
Входная таблица событий

Входная таблица событий.

Table View
Свойства таблицы событий

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

  • Поле идентификатора маршрута — поле, содержащее значения, которые определяют маршрут, на котором находится каждое из событий. Это поле может быть числовым или текстовым.
  • Тип событий — тип событий в выходной таблице событий (POINT или LINE).
    • POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только Поле измерения От.
    • LINE – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До.
  • Поле измерений От – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события POINT или LINE. При этом для Типа события POINT этот параметр будет обозначен как Поле измерений.
  • Поле измерений До – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события LINE.
Route Measure Event Properties
Объекты исходного маршрута

Входные объекты маршрута.

Feature Layer
Поле идентификатора исходного маршрута

Поле, содержащее значения, уникально идентифицирующие каждый маршрут.

Field
Объекты целевого маршрута

Объекты-маршруты, в систему измерений которых.

Feature Layer
Поле идентификатора целевого маршрута

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

Field
Выходная таблица событий

Создаваемая таблица.

Table
Свойства выходной таблицы событий

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

  • Поле идентификатора маршрута — поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий.
  • Тип событий — тип событий, будет содержать выходная таблица событий (POINT или LINE).
    • 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

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

  • Поле идентификатора маршрута — поле, содержащее значения, которые определяют маршрут, на котором находится каждое из событий. Это поле может быть числовым или текстовым.
  • Тип событий — тип событий в выходной таблице событий (POINT или LINE).
    • POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только Поле измерения От.
    • LINE – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До.
  • Поле измерений От – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события POINT или LINE. При этом для Типа события POINT этот параметр будет обозначен как Поле измерений.
  • Поле измерений До – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события LINE.
Route Measure Event Properties
in_routes

Входные объекты маршрута.

Feature Layer
route_id_field

Поле, содержащее значения, уникально идентифицирующие каждый маршрут.

Field
target_routes

Объекты-маршруты, в систему измерений которых.

Feature Layer
target_route_id_field

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

Field
out_table

Создаваемая таблица.

Table
out_event_properties

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

  • Поле идентификатора маршрута — поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий.
  • Тип событий — тип событий, будет содержать выходная таблица событий (POINT или LINE).
    • POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только одно поле измерения.
    • LINE – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До.
  • Поле измерений От – поле, в котором будут содержаться значения измерений. Является обязательным для типа событий POINT или LINE. При этом для Типа события POINT этот параметр будет обозначен как Поле измерений.
  • Поле измерений До – поле, в котором будут содержаться значения измерений. Является обязательным для типа событий 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: Да

Связанные разделы