Преобразование событий на маршруте

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

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

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

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

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

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

  Внимание:

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

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

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

• Выходная таблица может быть отображена в ArcMap при помощи инструмента Создать слой событий на маршруте (Make Route Event Layer) либо при помощи команды Отобразить события на маршруте (Display Route Events) в ArcMap.

Синтаксис

TransformRouteEvents_lr (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) (окно Python)

import arcpy
from arcpy import env

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"  )

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

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

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

# Import system modules
import arcpy
from arcpy import env

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

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

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

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

# Import system modules
import arcpy
from arcpy import env

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

# 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)

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

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

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

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = gp.QualifyTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = gp.QualifyTableName("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)

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

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

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

• ArcGIS for Desktop Basic: Да
• ArcGIS for Desktop Standard: Да
• ArcGIS for Desktop Advanced: Да

Отзыв по этому разделу?