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

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

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

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

Могут быть выполнены следующие наложения событий: линии на линию, линии на точку, точки на линию и точки на точку.
Входные события и события наложения должны быть основаны на одной системе измерений на маршруте.
Входная таблица может быть любого типа таблиц, который поддерживает 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	Поля местоположений на маршруте и тип событий во входной таблице событий. Route identifier field—Поле, содержащее значения, определяющие маршрут, на котором находится каждое из событий. Это поле может быть числовым, текстовым или GUID. Event type—Тип событий в выходной таблице событий (`POINT` или `LINE`). `POINT`—Точечные события, относящиеся к точным местоположениям на маршруте. Требуется указать только Поле измерения От. `LINE`—Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. From-measure field—Поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события `POINT` или `LINE`. To-measure field—Поле, содержащее значения измерений. Это поле должно быть числовым и является обязательным, если тип события — `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	Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий. Route identifier field—Поле, в котором будут содержаться значения, определяющие маршрут, на котором находится каждое из событий. Поле может быть числовым, текстовым или GUID. Event type—Тип событий, которые будет содержать выходная таблица событий (`POINT` или `LINE`). `POINT`—Точечные события, относящиеся к точным местоположениям на маршруте. Требуется указать только одно поле измерения. `LINE`—Линейные события, затрагивающие участок маршрута. Требуется указать поля измерений От и До. From-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `POINT` или `LINE`. To-measure field—Поле, содержащее значения измерений. Это поле необходимо, если тип события `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 в автономном скрипте Python с данными многопользовательской базы геоданных.

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

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

Текущая рабочая область, Выходное ключевое слово конфигурации, Временная рабочая область

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