Сводка
Вычисляет пересечение входных объектов (точек, линий или полигонов) и объектов-маршрутов и записывает информацию о маршруте и измерениях в новую таблицу событий.
Использование
Выходная таблица может быть файлом dBASE или таблицей базы геоданных.
Тип события должен быть Точка , если Входные объекты – точки и Линия , если входные объекты – линии или полигоны.
Вы достигнете наилучших результатов в случае, если исходные и целевые маршруты полностью накладываются друг на друга.
Внимание:
Не используйте большой кластерный допуск, чтобы попытаться преодолеть расхождения между исходным и целевым маршрутами, т. к. это может привести к неожиданным результатам.
Для уменьшения количества входных объектов, которые будут обрабатываться этим инструментом, можно ввести слои с выборками.
-
Выходная таблица может быть показана на карте с помощью инструмента Создать слой событий на маршруте.
Синтаксис
arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})| Parameter | Объяснение | Тип данных |
in_features | Входные точечные, линейные или полигональные объекты. | Feature Layer |
in_routes | Маршруты, с которыми будут пересекаться входные объекты. | Feature Layer |
route_id_field | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Это поле может быть числовым или текстовым. | Field |
radius_or_tolerance | Если в качестве входных используются точечные объекты, радиус поиска представляет собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск соответствующего маршрута. Если в качестве входных используются линейные объекты, радиус поиска представляет максимальное допустимое расстояние между линией и соответствующим маршрутом. Если в качестве входных используются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется. | Linear Unit |
out_table | Создаваемая таблица. | Table |
out_event_properties | Параметр, состоящий из полей, определяющих местоположения на маршруте, и типа событий, которые будут записаны в выходную таблицу событий.
| Route Measure Event Properties |
route_locations (Дополнительный) | При размещении точек вдоль маршрута, возможно в пределы радиуса поиска вокруг какой-либо точки попадает более одного маршрута. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
distance_field (Дополнительный) | Определяет, будет ли добавлено поле DISTANCE к выходной таблице событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
zero_length_events (Дополнительный) | При размещении полигонов вдоль маршрутов, возможно создание события, для которого измерение От равно измерению До. Параметр не учитывается при размещении точек или линий вдоль маршрутов.
| Boolean |
in_fields (Дополнительный) | Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов.
| Boolean |
m_direction_offsetting (Дополнительный) | Указывает, будут ли расстояния смещения рассчитаны исходя из направления М, или из оцифрованных направлений. Расстояния включаются в выходную таблицу событий, если distance_field="DISTANCE".
| Boolean |
Пример кода
Следующий пример скрипта Python демонстрирует использование функции LocateFeaturesAlongRoutes в окне Python
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.LocateFeaturesAlongRoutes_lr("rail_segments.shp", "rail_routes.shp",
"rkey", "0.5 Feet", "locate_lines",
"rkey LINE fmp tmp")Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes.
# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, tol, tbl, props)Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes с данными файловой базы геоданных.
# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate personal geodatabase points along file geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings" # crossings is in the rail feature dataset
rts = "rail/routes" # routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, rad, tbl, props)Следующий автономный скрипт Python демонстрирует использование функции LocateFeaturesAlongRoutes с данными многопользовательской базы геоданных.
# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc) # standalone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # standalone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Execute LocateFeaturesAlongRoutes
arcpy.LocateFeaturesAlongRoutes_lr(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да