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

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

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

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

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

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

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

    Внимание:

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

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

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

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

Параметры

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

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

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

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

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

Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов.

  • FIELDSВыходная таблица событий будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию.
  • NO_FIELDSВыходная таблица событий будет содержать только поля с информацией о маршруте и поле идентификаторов ObjectID входных объектов.
Boolean

Пример кода

TransformRouteEvents, пример 1 (окно Python)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.TransformRouteEvents_lr("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 (автономный скрипт)

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

# 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"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)
TransformRouteEvents, пример 3 (автономный скрипт)

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

# 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"  
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

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

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

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