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

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

Выполняет наложение таблиц событий и создает выходную таблицу событий, представляющую из себя объединение или пересечение входных объектов.

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

  • Могут быть выполнены следующие наложения событий: линии на линию, линии на точку, точки на линию и точки на точку.

  • Входные события и события наложения должны быть основаны на одной системе измерений на маршруте.

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

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

  • Если свойства входных событий и событий наложения имеют тип Точка, свойства выходного события также должны быть типа Точка.

  • Если свойства входных событий и событий наложения имеют тип Линия, свойства выходного события также должны быть типа Линия.

  • Если у свойств входных событий или событий наложения тип Точка, свойства выходного события также должны быть типа Точка, если значение параметра Тип наложения - Пересечение. Свойства выходных событий должны быть типа Линия, если значение параметра Тип наложения - Объединение.

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

  • Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (dynamic segmentation). Если вы будете использовать значение параметра Выходная таблица событий для динамической сегментации, рекомендуется создать атрибутивный индекс.

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

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

Параметры

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

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

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

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

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

Таблица наложения событий.

Table View
Свойства таблицы наложения событий

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

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

Тип события - тип событий в выходной таблице наложения событий (Point или Line).

  • Point – точечные события, происходящие в определенной точке маршрута. Требуется указать только Поле измерения От.
  • Line – линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До.

Поле измерений От – поле, содержащее значения измерений От. Это поле должно быть числовым и является обязательным, если тип события Point или Line. Если Типом события является Point, надпись для этого параметра будет Поле измерений.

Поле измерений До – поле, содержащее значения измерений До. Это поле должно быть числовым и является обязательным, если тип события Line.

Route Measure Event Properties
Тип наложения

Указывает тип наложения, которое будет выполняться.

  • ПересечениеВ выходную таблицу событий будут записаны только накладывающиеся события. Это значение по умолчанию
  • ОбъединениеВсе события будут записаны в выходную таблицу. Линейные события будут разбиты в местах пересечений.
String
Выходная таблица событий

Создаваемая таблица.

Table
Свойства выходной таблицы событий

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

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

Указывает, будут ли добавляться линейные события нулевой длины к значению параметра Выходная таблица событий. Параметр доступен, если тип выходного события — Line.

  • Отмечено – линейное событие нулевой длины будет добавлено. Это значение по умолчанию
  • Не отмечено – линейное событие нулевой длины не будет добавлено.
Boolean
Включить все поля из входных данных
(Дополнительный)

Указывает, будут ли все поля из входных таблиц и таблиц наложений событий включаться в значение параметра Выходная таблица событий.

  • Отмечено - все поля из входных таблиц будут включены в выходную таблицу. Это значение по умолчанию
  • Не отмечено - все поля из входных таблиц не будут включены в выходную таблицу. Будут включены только поле ObjectID и поля местоположения маршрута.
Boolean
Построить индекс
(Дополнительный)

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

  • Отмечено - будет создан атрибутивный индекс. Это значение по умолчанию
  • Не отмечено - атрибутивных индекс не создается.
Boolean

arcpy.lr.OverlayRouteEvents(in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})
ИмяОписаниеТип данных
in_table

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

Table View
in_event_properties

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

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

Таблица наложения событий.

Table View
overlay_event_properties

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

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

Тип событий - тип событий в выходной таблице наложения событий (POINT или LINE).

  • POINT – точечные события, происходящие в определенной точке маршрута. Требуется указать только Поле измерения От.
  • LINE – Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До.

Поле измерений От – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события POINT или LINE.

Поле измерений До – поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события - LINE.

Route Measure Event Properties
overlay_type

Указывает тип наложения, которое будет выполняться.

  • INTERSECTВ выходную таблицу событий будут записаны только накладывающиеся события. Это значение по умолчанию
  • UNIONВсе события будут записаны в выходную таблицу. Линейные события будут разбиты в местах пересечений.
String
out_table

Создаваемая таблица.

Table
out_event_properties

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

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

Указывает, будут ли добавляться линейные события нулевой длины к значению параметра out_table. Параметр доступен, если тип выходного события — LINE.

  • ZEROЛинейное событие нулевой длины будет добавлено. Это значение по умолчанию
  • NO_ZEROЛинейное событие нулевой длины не будет добавлено.
Boolean
in_fields
(Дополнительный)

Указывает, будут ли все поля из входных таблиц и таблиц наложений событий включаться в значение параметра out_table.

  • FIELDSВсе поля из входных таблиц будут включены в выходную таблицу. Это значение по умолчанию
  • NO_FIELDSВсе поля из входных таблиц не будут включены в выходную таблицу. Будут включены только поле ObjectID и поля местоположения маршрута.
Boolean
build_index
(Дополнительный)

Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в значение параметра out_table.

  • INDEXБудет создан атрибутивный индекс. Это значение по умолчанию
  • NO_INDEXНе будет создан атрибутивный индекс.
Boolean

Пример кода

OverlayRouteEvents, пример 1 (окно Python)

Пример скрипта в окне Python для использования функции OverlayRouteEvents.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.OverlayRouteEvents("accident.dbf", "rkey POINT mile", "pavecond.dbf", 
                            "rkey LINE fmp tmp", "INTERSECT", "accpav", 
                            "rkey POINT mile" )
OverlayRouteEvents, пример 2 (автономный скрипт)

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

# Description: Point-on-line INTERSECT overlay (both tables are dBASE)

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile"  # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, in_props)
OverlayRouteEvents, пример 3 (автономный скрипт)

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

# Description: Line-on-line UNION overlay (both tables are in a file 
#              geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype" 

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, in_props, "UNION", 
                            out_tbl, in_props, "NO_ZERO")
OverlayRouteEvents, пример 4 (автономный скрипт)

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

# Description: Point-on-line INTERSECT overlay (both tables are 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 = "rkey POINT mile"  
ov_tbl = arcpy.ValidateTableName("pavecond", wkspc) 
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost"  # names are changed for out table

# Run OverlayRouteEvents
arcpy.lr.OverlayRouteEvents(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, out_props)

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

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

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