Преобразование событий на маршруте (Системы линейных координат)
Резюме
Этот инструмент преобразует изменения событий из одной системы измерений на маршруте в другую и записывает их в новую таблицу событий.
Использование
-
Преобразование событий позволяет использовать события из одной системы измерений на маршруте с другой системой, имеющей различные идентификаторы маршрута и/или измерения.
-
Любое полное или частичное событие, пересекающее целевой маршрут, записывается в новую таблицу событий.
-
Наилучший результат будет получен, если исходные и целевые маршруты полностью накладываются друг на друга.
Внимание:Использование большого кластерного допуска для преодоления расхождения между исходным и целевым маршрутами может привести к неожиданным результатам.
-
Выходной тип события (POINT или LINE) должен соответствовать входному.
-
Используйте инструмент Создать представление таблицы (Make Table View) перед применением этого инструмента, чтобы значительно сократить число событий, которые будут обрабатываться.
-
Выходная таблица может быть отображена в ArcMap при помощи инструмента Создать слой событий на маршруте (Make Route Event Layer) либо при помощи команды Отобразить события на маршруте (Display Route Events) в ArcMap.
Синтаксис
| Параметр | Объяснение | Тип данных |
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 |
Пример кода
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" )
Ниже показан порядок использования функции TransformRouteEvents в автономном скрипте Python с файловыми базами геоданных:
# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)
# Author: ESRI
# 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)
Ниже показан порядок использования функции TransformRouteEvents в автономном скрипте Python с персональными базами геоданных:
# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in a personal geodatabase)
# Author: ESRI
# 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)
Ниже показан порядок использования функции TransformRouteEvents в автономном скрипте Python с данными ArcSDE:
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Author: ESRI
# 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)