Подпись | Описание | Тип данных |
Входные объекты | Входные точечные, линейные или полигональные объекты. | Feature Layer |
Входные объекты-маршруты | Маршруты, с которыми будет пересекаться значение параметра Входные объекты. | Feature Layer |
Поле идентификатора маршрута | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID. | Field |
Радиус поиска | Если значением параметра Входные объекты являются точечные объекты, радиус поиска будет представлять собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск целевого маршрута. Если значением параметра Входные объекты являются линии, радиусом поиска будет кластерный допуск, который представляет собой числовое значение, представляющее максимально допустимое расстояние между входными линиями и целевыми маршрутами. Если значением параметра Входные объекты являются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется. | Linear Unit |
Выходная таблица событий | Создаваемая таблица. | Table |
Свойства выходной таблицы событий | Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий.
| Route Measure Event Properties |
Сохранять только ближайшее местоположение маршрута (Дополнительный) | Указывает, будет ли в значение параметра Выходная таблица событий записываться только ближайшее местоположение маршрута или каждое местоположение маршрута в пределах радиуса поиска. При размещении точек вдоль маршрута в радиусе поиска любой точки может быть несколько маршрутов. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
Включить поле расстояний для выходной таблицы (Дополнительный) | Указывает, будет ли поле DISTANCE добавлено к значению параметра Выходная таблица событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
Хранить нулевую длину линейных событий (Дополнительный) | Определяет, будут ли записываться в выходные данные линейные события нулевой длины. При обнаружении полигонов вдоль маршрутов могут быть созданы события, в которых значение "От" равно значению "До". Параметр не учитывается при размещении точек или линий вдоль маршрутов.
| Boolean |
Включить все поля из входных данных (Дополнительный) | Указывает, будет ли значение параметра Выходная таблица событий содержать поля местоположения маршрута и все атрибуты из значения параметра Входные объекты.
| Boolean |
Использовать сдвиг по направлению M (Дополнительный) | Указывает, будут ли расстояния смещения рассчитаны исходя из направления m или из оцифрованных направлений. Расстояния включаются в значение параметра Выходная таблица событий, если отмечен параметр Включить поле расстояний в выходную таблицу.
| Boolean |
Краткая информация
Вычисляет пересечение входных объектов (точек, линий или полигонов) и объектов-маршрутов и записывает информацию о маршруте и измерениях в новую таблицу событий.
Использование
Выходной таблицей может быть файл .dbf или таблица базы геоданных.
Если значением параметра Входные объекты являются точки, то значение параметра Тип события должен быть задано как Точка. Если значением параметра Входные объекты являются линии или полигоны, то значение параметра Тип события должен быть задано как Линия.
Вы достигнете наилучших результатов в случае, если исходные и целевые маршруты полностью накладываются друг на друга.
Внимание:
Не используйте большой кластерный допуск, чтобы попытаться преодолеть расхождения между исходным и целевым маршрутами, т. к. это может привести к неожиданным результатам.
Для уменьшения количества входных объектов, которые будут обрабатываться этим инструментом, можно ввести слои с выборками.
-
Выходная таблица может быть показана на карте с помощью инструмента Создать слой событий на маршруте.
Параметры
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})
Имя | Описание | Тип данных |
in_features | Входные точечные, линейные или полигональные объекты. | Feature Layer |
in_routes | Маршруты, с которыми будет пересекаться значение параметра in_features. | Feature Layer |
route_id_field | Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID. | Field |
radius_or_tolerance | Если значением параметра in_features являются точечные объекты, радиус поиска будет представлять собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск целевого маршрута. Если значением параметра in_features являются линии, радиусом поиска будет кластерный допуск, который представляет собой числовое значение, представляющее максимально допустимое расстояние между входными линиями и целевыми маршрутами. Если значением параметра in_features являются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется. | Linear Unit |
out_table | Создаваемая таблица. | Table |
out_event_properties | Поля, определяющие местоположения на маршруте, и тип событий, которые должны быть записаны в выходную таблицу событий.
| Route Measure Event Properties |
route_locations (Дополнительный) | Указывает, будет ли в значение параметра out_table записываться только ближайшее местоположение маршрута или каждое местоположение маршрута в пределах радиуса поиска. При размещении точек вдоль маршрута в радиусе поиска любой точки может быть несколько маршрутов. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
distance_field (Дополнительный) | Указывает, будет ли поле DISTANCE добавлено к значению параметра out_table. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов.
| Boolean |
zero_length_events (Дополнительный) | Определяет, будут ли записываться в выходные данные линейные события нулевой длины. При обнаружении полигонов вдоль маршрутов могут быть созданы события, в которых значение "От" равно значению "До". Параметр не учитывается при размещении точек или линий вдоль маршрутов.
| Boolean |
in_fields (Дополнительный) | Указывает, будет ли значение параметра out_table содержать поля местоположения маршрута и все атрибуты из значения параметра in_features.
| Boolean |
m_direction_offsetting (Дополнительный) | Указывает, будут ли расстояния смещения рассчитаны исходя из направления m или из оцифрованных направлений. Расстояния включаются в значение параметра out_table, если для параметра distance_field задано DISTANCE.
| Boolean |
Пример кода
В следующем скрипте Python показано, как использовать функцию LocateFeaturesAlongRoutes в окне Python.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("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"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)
В следующем скрипте Python показано, как использовать функцию LocateFeaturesAlongRoutes в автономном окне Python с данными файловой базы геоданных.
# 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"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(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) # stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да