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

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

Создает временный векторный слой объектов с использованием маршрутов и событий.

Если используется временный слой (отображаемый на карте или используемый другим инструментом геообработки), выполняется динамическая сегментация.

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

  • Входная таблица может быть любого типа, который поддерживает ArcGIS.

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

  • Не все типы таблиц имеют поле ObjectID. Если этим инструментом используются подобные таблицы, результирующий слой не будет доступен для выборки и и не сможет быть эффективно использован некоторыми операциями геообработки. Рассмотрите возможность использования инструмента Создать таблицу запроса, прежде чем использовать этот инструмент для добавления виртуального поля ObjectID.

Параметры

ПодписьОписаниеТип данных
Входные объекты-маршруты

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

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

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

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

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

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

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

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

Слой, который будет создан. Этот слой хранится в памяти, поэтому не нужно вводить путь.

Feature Layer
Поле сдвига
(Дополнительный)

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

Field
Создать поле для ошибок определения позиций
(Дополнительный)

Определяет, будет ли добавлено поле с именем LOC_ERROR к созданному временному слою.

  • Не отмечено — не добавлять поле для хранения ошибок местоположения. Используется по умолчанию.
  • Отмечено — добавлять поле для хранения ошибок местоположения.
Boolean
Создать поле угла
(Дополнительный)

Определяет, будет ли добавлено поле с именем LOC_ANGLE к созданному временному слою. Этот параметр доступен только, если тип события POINT.

  • Не отмечено – не добавлять поле для хранения углов местоположения. Используется по умолчанию.
  • Отмечено – добавлять поле для хранения углов местоположения.
Boolean
Расчетный тип угла
(Дополнительный)

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

  • НормальБудет вычислен нормальный (перпендикулярный) угол. Используется по умолчанию.
  • КасательнаяБудет вычислен угол наклона касательной.
String
Записать дополнительный угол в поле угла
(Дополнительный)

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

  • Не отмечено – не записывать дополнительный угол в поле угла. Записывать только вычисляемый угол. Используется по умолчанию.
  • Отмечено – записывать дополнительный угол в поле угла.
Boolean
События с положительным сдвигом будут помещены справа от маршрутов
(Дополнительный)

Определяет, с какой стороны будут помещены события с положительным сдвигом. Этот параметр доступен только, если определено поле сдвига.

  • Не отмечено – события с положительным сдвигом будут помещены слева от маршрута. Сторона маршрута определяется измерениями и не обязательно направление вектора. Используется по умолчанию.
  • Отмечено – события с положительным сдвигом будут помещены справа от маршрута. Сторона маршрута определяется направлением вектора.
Boolean
Точечные события будут созданы как мультиточечные объекты
(Дополнительный)

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

  • Не отмечено – точечные события будут рассматриваться как точечные объекты. Используется по умолчанию.
  • Отмечено – точечные события будут рассматриваться как мультиточечные объекты.
Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})
ИмяОписаниеТип данных
in_routes

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

Feature Layer
route_id_field

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

Field
in_table

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

Table View
in_event_properties

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

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

Слой, который будет создан. Этот слой хранится в памяти, поэтому не нужно вводить путь.

Feature Layer
offset_field
(Дополнительный)

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

Field
add_error_field
(Дополнительный)

Определяет, будет ли добавлено поле с именем LOC_ERROR к созданному временному слою.

  • NO_ERROR_FIELDНе добавлять поле для хранения ошибок местоположения. Используется по умолчанию.
  • ERROR_FIELDДобавлять поле для хранения ошибок местоположения.
Boolean
add_angle_field
(Дополнительный)

Определяет, будет ли добавлено поле с именем LOC_ANGLE к созданному временному слою. Этот параметр доступен только, если тип события POINT.

  • NO_ANGLE_FIELDНе добавлять поле для хранения углов местоположения. Используется по умолчанию.
  • ANGLE_FIELDДобавлять поле для хранения углов местоположения.
Boolean
angle_type
(Дополнительный)

Определяет тип местоположения угла, который будет вычисляться. Параметр доступен только при соблюдении условия add_angle_field = "ANGLE_FIELD".

  • NORMALБудет вычислен нормальный (перпендикулярный) угол. Используется по умолчанию.
  • TANGENTБудет вычислен угол наклона касательной.
String
complement_angle
(Дополнительный)

Определяет, будет ли вычисляться дополнительный угол в поле угла. Параметр доступен только при соблюдении условия add_angle_field = "ANGLE_FIELD".

  • ANGLEНе записывать дополнительный угол в поле угла. Записывать только вычисляемый угол. Используется по умолчанию.
  • COMPLEMENTЗаписать дополнительный угол в поле угла.
Boolean
offset_direction
(Дополнительный)

Определяет, с какой стороны будут помещены события с положительным сдвигом. Этот параметр доступен только, если определено поле сдвига.

  • LEFTСобытия с положительным сдвигом будут помещены слева от маршрута. Сторона маршрута определяется измерениями и не обязательно направление вектора. Используется по умолчанию.
  • RIGHTСобытия с положительным сдвигом будут помещены справа от маршрута. Сторона маршрута определяется направлением вектора.
Boolean
point_event_type
(Дополнительный)

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

  • POINTТочечные события будут рассматриваться как точечные объекты. Используется по умолчанию.
  • MULTIPOINTТочечные события будут рассматриваться как мультиточечные объекты.
Boolean

Пример кода

MakeRouteEventLayer, пример 1 (окно Python)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
MakeRouteEventLayer, пример 2 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer.

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
MakeRouteEventLayer, пример 3 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer.

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
MakeRouteEventLayer, пример 4 (автономный скрипт)

Следующий автономный скрипт Python демонстрирует использование функции MakeRouteEventLayer с данными многопользовательской базы геоданных.

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

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

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

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