Краткая информация
Этот инструмент преобразует изменения событий из одной системы измерений на маршруте в другую и записывает их в новую таблицу событий.
Использование
Преобразование событий позволяет использовать события из одной системы измерений на маршруте с другой системой, имеющей различные идентификаторы маршрута и/или измерения.
Любое полное или частичное событие, пересекающее целевой маршрут, записывается в новую таблицу событий.
Наилучший результат будет получен, если исходные и целевые маршруты полностью накладываются друг на друга.
-
Выходной тип события (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 | Параметр, состоящий из полей, определяющих местоположения на маршруте и типа событий во входной таблице событий.
| 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 | Параметр, состоящий из полей, определяющих местоположения на маршруте, и типа событий, которые будут записаны в выходную таблицу событий.
| Route Measure Event Properties |
cluster_tolerance | Максимально допустимое расстояние между входными событиями и целевыми маршрутами. | Linear Unit |
in_fields (Дополнительный) | Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов.
| 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)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да