Размещение объектов вдоль маршрутов—Справка

Краткая информация
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензиях

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

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

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

Выходная таблица может быть файлом dBASE или таблицей базы геоданных.
Типом события должен быть POINT, если Входные объекты являются точками, и LINE, если входные объекты – линии или полигоны.
Вы достигнете наилучших результатов в случае, если исходные и целевые маршруты полностью накладываются друг на друга.
Внимание:
Не используйте большой кластерный допуск, чтобы попытаться преодолеть расхождения между исходным и целевым маршрутами, т. к. это может привести к неожиданным результатам.
Для уменьшения количества входных объектов, которые будут обрабатываться этим инструментом, можно ввести слои с выборками. Более подробную информацию см. в разделе Использование слоев и представлений таблиц.
Выходная таблица может быть отображена в ArcMap при помощи инструмента Создать слой событий на маршруте либо при помощи команды Отобразить события на маршруте в ArcMap.

Синтаксис

LocateFeaturesAlongRoutes_lr (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	Маршруты, с которыми будут пересекаться входные объекты.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Это поле может быть числовым или текстовым.	Field
radius_or_tolerance	Если в качестве входных используются точечные объекты, радиус поиска представляет собой числовое значение, определяющее, на каком максимальном расстоянии от точки будет вестись поиск соответствующего маршрута. Если в качестве входных используются линейные объекты, радиус поиска представляет максимальное допустимое расстояние между линией и соответствующим маршрутом. Если в качестве входных используются полигональные объекты, этот параметр не учитывается, а радиус поиска не используется.	Linear Unit
out_table	Создаваемая таблица.	Table
out_event_properties	Параметр, состоящий из полей, определяющих местоположения на маршруте, и типа событий, которые будут записаны в выходную таблицу событий. Поле идентификатора маршрута – поле, которое будет содержать значения, определяющие, к какому маршруту относится каждое из событий. Тип событий – Тип событий, которые будет содержать выходная таблица (POINT или LINE). POINT – Точечное событие происходит в определенной точке маршрута. Требуется указать только одно поле измерения. LINE – Линейное событие затрагивает участок маршрута. Требуется указать поля измерений "От " и "До ". Поле измерений "От" – Поле, которое будет содержать значения измерений. Является обязательным для событий типа POINT и LINE. При этом для события типа POINT этот параметр будет обозначен как Поле измерений. Поле измерений "До" – Поле, содержащее значения измерений. Требуется, когда выбран тип событий LINE.	Route Measure Event Properties
route_locations (Дополнительный)	При размещении точек вдоль маршрута, возможно в пределы радиуса поиска вокруг какой-либо точки попадает более одного маршрута. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. FIRST —В выходную таблицу событий будет вписан ближайший маршрут. Используется по умолчанию. ALL —Информация о каждом маршруте (в пределах радиуса поиска) будет вписана в выходную таблицу событий.	Boolean
distance_field (Дополнительный)	Определяет, будет ли поле с именем DISTANCE добавлено к выходной таблице событий. Значения этого поля в единицах, в которых был указан радиус поиска. Параметр не учитывается при размещении линий или полигонов вдоль маршрутов. DISTANCE —Поле, содержащее расстояние «от точки до маршрута», будет добавлено к выходной таблице событий. Используется по умолчанию. NO_DISTANCE —Поле, содержащее расстояние «от точки до маршрута», не будет добавлено к выходной таблице событий.	Boolean
zero_length_events (Дополнительный)	При размещении полигонов вдоль маршрутов, возможно создание события, для которого измерение "От " равно измерению "До ". Параметр не учитывается при размещении точек или линий вдоль маршрутов. ZERO —Линейное событие нулевой длины будет записано в выходную таблицу событий. Используется по умолчанию. NO_ZERO —Линейное событие нулевой длины не будет записано в выходную таблицу событий.	Boolean
in_fields (Дополнительный)	Определяет, будет ли выходная таблица событий кроме информации о маршруте содержать все атрибуты входных объектов. FIELDS —Выходная таблица событий будет содержать поля с информацией о маршруте, а также все атрибуты входных объектов. Используется по умолчанию. NO_FIELDS —Выходная таблица событий будет содержать только поля с информацией о маршруте и поле ObjectID от входных объектов.	Boolean
m_direction_offsetting (Дополнительный)	Указывает, будут ли расстояния смещения рассчитаны исходя из направления М, или из оцифрованных направлений. Расстояния включаются в выходную таблицу событий, если distance_field="DISTANCE". M_DIRECTON —Значения расстояний будут вычислены в выходной таблице событий с использованием направлений маршрутов М. Входным объектам, расположенным слева от направления маршрута М, будет присвоено положительное значение сдвига (+), а расположенным справа от направления M – отрицательное (-). Используется по умолчанию. NO_M_DIRECTION —Значения расстояний будут вычислены в выходной таблице событий с использованием цифровых направлений маршрутов. Входным объектам, расположенным слева от оцифрованного направления, будет присвоено отрицательное значение (-), а находящимся справа от оцифрованного направления – положительное значение сдвига (+).	Boolean

Пример кода

LocateFeaturesAlongRoutes. Пример 1 (окно Python)

Следующий пример скрипта 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")

LocateFeaturesAlongRoutes. Пример 2 (автономный скрипт Python)

Следующий автономный скрипт 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)

LocateFeaturesAlongRoutes. Пример 3 (автономный скрипт Python)

Следующий автономный скрипт 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)

LocateFeaturesAlongRoutes. Пример 4 (автономный скрипт Python)

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

# Name: LocateFeaturesAlongRoutes_Example4.py
# Description:  Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
feats = gp.QualifyTableName("counties", wkspc)  # standalone feature class
rts = gp.QualifyTableName("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")

LocateFeaturesAlongRoutes. Пример 5 (автономный скрипт Python)

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

# Name: LocateFeaturesAlongRoutes_Example5.py
# Description:  Locate personal geodatabase points along personal geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.mdb"
# 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)

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

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

ArcGIS Desktop Basic: Да
ArcGIS Desktop Standard: Да
ArcGIS Desktop Advanced: Да