Построить журнал маршрута в системе линейных координат (Инструменты Location Referencing)

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

Cоздает продукт данных журнала маршрута для маршрутов в сети LRS без шаблона данных LRS.

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

Этот инструмент поддерживает данные из файловой базы геоданных или многопользовательской базы геоданных (подключение сервис-ориентированных версий), или из сервисов объектов (опубликованных из сервис-ориентированных версий).
Этот инструмент не изменяет входные данные и создает файл .csv или таблицу базы геоданных в качестве выходных данных.
Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на эту дату.
Слои журнала, местоположения и референта должны храниться в одной и той же базе геоданных или сервисе объектов и иметь ту же систему координат, что и указанная сеть LRS.
Слой журнала может представлять собой класс объектов точечных событий LRS, класс объектов линейных событий LRS или класс объектов пересечений LRS, зарегистрированный в указанной сети LRS. Класс объектов центральных линий также может использоваться в качестве слоя журнала, если он настроен с помощью решения Управление адресными данными или инженерной сети.
Слой местоположения должен быть классом полигональных объектов.
Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, слоя (слоев) журнала, слоя (слоев) местоположения и базового слоя.
Базовый слой должен представлять собой класс объектов точечных событий LRS или класс объектов пересечений LRS, зарегистрированный в указанной сети LRS.
Значение Неклассифицированный будет включено в выходные поля местоположения для маршрутов, которые не пересекаются со слоями местоположения.
You can add multiple log and location fields from the same feature class by creating selection layers и указывает каждый слой выборки либо как логичное поле, либо как поле местоположения. Например, если у вас есть класс объектов линейных событий LRS, вы можете создать два слоя выборки—класс A и класс B — и указать каждый из этих слоев выборки в качестве поля журнала.

Подпись	Объяснение	Тип данных
Входные объекты-маршруты	Объекты-маршруты, которые будут использоваться для создания журнала маршрута.	Feature Layer
Дата вступления в силу	Дата, которая будет использоваться для определения временного представления сети. Значение по умолчанию — сегодняшняя дата.	Date
Поля журнала (Дополнительный)	Поля, которые будут использоваться для отображения информации о событиях и пересечениях в выходных данных. Столбцы таблицы значений: Layer–The feature layer that will be used as the log layer. Field–The field that will participate in the route log.	Value Table
Слияние совпадающих событий (Дополнительный)	Указывает, будут ли совпадающие линейные события объединяться в выходных данных. Отмечено–Совпадающие линейные события с одним и тем же значением в поле журнала будут объединены и возвращены как одно событие. Не отмечено–Совпадающие линейные события с одним и тем же значением в поле журнала не будут объединены или возвращены как одно событие. Используется по умолчанию.	Boolean
Поля местоположения (Дополнительный)	Поля, используемые для отображения атрибутов границ полигонов, пересекаемых маршрутами. Столбцы таблицы значений: Layer–The feature layer that will be used as the location layer. Field–The field that contains the attributes of the polygon boundaries crossed by the routes.	Value Table
Местоположение референта (Дополнительный)	Указывает метод, который будет использоваться для вычисления смещения референта. Нет–Смещение референта не будет вычисляться. Используется по умолчанию. Ближайший вверх по маршруту–Ближайший объект референта, расположенный выше записи журнала маршрута, будет использоваться для расчета смещения референта. Если не существует объекта референта выше по течению, значения референта будут пустыми. Ближайший–Ближайший объект референта, расположенный выше или ниже по течению записи журнала маршрута, будет использоваться для расчета смещения референта.	String
Объекты-референты (Дополнительный)	Векторный слой, который будет использоваться для расчета смещения от записи журнала маршрута.	Feature Layer
Поле референта (Дополнительный)	Поле референта, которое будет содержать атрибуты объектов-референтов в выходных данных.	Field
Единицы измерения смещения (Дополнительный)	Указывает единицы измерения смещения, которые будут использоваться для вычисления расстояния между объектом-референтом и записью журнала маршрута. Дюймы (США)–Единицами измерения будут дюймы. Футы (США)–Единицами измерения – футы Ярды (США)–Единицами измерения – ярды. Мили (США)–Единицами измерения – мили. Морские мили (США)–Единицами измерения будут морские мили. Футы (Международные)–Единицами измерения будут международные футы. Используется по умолчанию. Сухопутные мили–Единицами измерения будут сухопутные мили. Миллиметры–Единицами измерения будут миллиметры. Сантиметры–Единицами измерения будут сантиметры. Метры–Единицей измерения – метры. Километры–Единицами измерения – километры. Дециметры–Единицами измерения будут дециметры.	String
Выходной формат (Дополнительный)	Задает формат выходных данных. CSV–Выходными данными будет файл `.csv`. Используется по умолчанию. Таблица–Выходными данными будет таблица базы геоданных.	String
Выходной файл (Дополнительный)	Выходной файл `.csv`, который будет содержать журнал маршрута.	File
Выходная таблица (Дополнительный)	Выходная таблица базы геоданных, которая будет содержать журнал маршрута.	Table

arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, {log_fields}, {merge_coincident_events}, {location_fields}, {referent_location}, {referent_features}, {referent_field}, {offset_units}, {output_format}, {out_file}, {out_table})

Имя	Объяснение	Тип данных
in_route_features	Объекты-маршруты, которые будут использоваться для создания журнала маршрута.	Feature Layer
effective_date	Дата, которая будет использоваться для определения временного представления сети. Значение по умолчанию — сегодняшняя дата.	Date
log_fields [log_fields,...] (Дополнительный)	Поля, которые будут использоваться для отображения информации о событиях и пересечениях в выходных данных. Столбцы таблицы значений: `Layer`–The feature layer that will be used as the log layer. `Field`–The field that will participate in the route log.	Value Table
merge_coincident_events (Дополнительный)	Указывает, будут ли совпадающие линейные события объединяться в выходных данных. `MERGE`–Совпадающие линейные события с одним и тем же значением в поле журнала будут объединены и возвращены как одно событие. `DO_NOT_MERGE`–Совпадающие линейные события с одним и тем же значением в поле журнала не будут объединены или возвращены как одно событие. Используется по умолчанию.	Boolean
location_fields [location_fields,...] (Дополнительный)	Поля, используемые для отображения атрибутов границ полигонов, пересекаемых маршрутами. Столбцы таблицы значений: `Layer`–The feature layer that will be used as the location layer. `Field`–The field that contains the attributes of the polygon boundaries crossed by the routes.	Value Table
referent_location (Дополнительный)	Указывает метод, который будет использоваться для вычисления смещения референта. `NONE`–Смещение референта не будет вычисляться. Используется по умолчанию. `NEAREST_UPSTREAM`–Ближайший объект референта, расположенный выше записи журнала маршрута, будет использоваться для расчета смещения референта. Если не существует объекта референта выше по течению, значения референта будут пустыми. `NEAREST`–Ближайший объект референта, расположенный выше или ниже по течению записи журнала маршрута, будет использоваться для расчета смещения референта.	String
referent_features (Дополнительный)	Векторный слой, который будет использоваться для расчета смещения от записи журнала маршрута.	Feature Layer
referent_field (Дополнительный)	Поле референта, которое будет содержать атрибуты объектов-референтов в выходных данных.	Field
offset_units (Дополнительный)	Указывает единицы измерения смещения, которые будут использоваться для вычисления расстояния между объектом-референтом и записью журнала маршрута. `INCHES`–Единицами измерения будут дюймы. `FEET`–Единицами измерения – футы `YARDS`–Единицами измерения – ярды. `MILES`–Единицами измерения – мили. `NAUTICAL_MILES`–Единицами измерения будут морские мили. `INTFEET`–Единицами измерения будут международные футы. Используется по умолчанию. `INTMILES`–Единицами измерения будут сухопутные мили. `MILLIMETERS`–Единицами измерения будут миллиметры. `CENTIMETERS`–Единицами измерения будут сантиметры. `METERS`–Единицей измерения – метры. `KILOMETERS`–Единицами измерения – километры. `DECIMETERS`–Единицами измерения будут дециметры.	String
output_format (Дополнительный)	Задает формат выходных данных. `CSV`–Выходными данными будет файл `.csv`. Используется по умолчанию. `TABLE`–Выходными данными будет таблица базы геоданных.	String
out_file (Дополнительный)	Выходной файл `.csv`, который будет содержать журнал маршрута.	File
out_table (Дополнительный)	Выходная таблица базы геоданных, которая будет содержать журнал маршрута.	Table

Пример кода

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

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

# Name: GenerateLRRouteLog_ex1.py
# Description: Create a route log data product that returns the location and information of signal events,
# functional class events, reference posts, intersections, and county boundaries for routes in an LRS Network
# Requirements: ArcGIS Location Referencing

# Set tool variables
in_route_features = "CountyLog"
effective_date = "12/31/2024"
log_fields = "Signal SIGNAL_MODE; Functional_Class FUNCTIONAL_CLASS; Intersections IntersectionName"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME"
referent_location = "NEAREST_UPSTREAM"
referent_features = "Reference_Post"
referent_field = "POST_NAME"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL1"

# Run the tool
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)

GenerateLRRouteLog, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции GenerateLRRouteLog.

# Name: GenerateLRRouteLog_ex2.py
# Description: For routes in an LRS Network, create a route log data product that returns the location and information of anomalies, pipes, crossing utility intersections, operating pressure,
# ILI surveys, as well as county and city boundaries
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Set current workspace
arcpy.env.workspace = r"C:\Data\SampleData.gdb"

# Using the Anomaly point event feature class, create a feature layer that contains active anomalies, to be used as a log layer
arcpy.management.MakeFeatureLayer("Anomaly", "Anomaly_Active", "anomalystatus = 'Active'")

# Using the Pipes line event feature class, create three feature layers, each representing a different pipe material, to be used as log layers
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_CastIron", "MATERIAL = 2")
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Copper", "MATERIAL = 4")
arcpy.management.MakeFeatureLayer("Pipes", "Pipes_Composite", "MATERIAL = 10")

# Set tool variables
in_route_features = "Engineering Network"
effective_date = "12/31/2024"
log_fields = "Anomaly_Active anomalytype; Crossing Utility Intersection intersectionname; Pipes_CastIron status; Pipes_Copper status; Pipes_Composite status; Operating Pressure pressurevalue"
merge_coincident_events = "DO_NOT_MERGE"
location_fields = "Counties NAME; Cities CITY_NM"
referent_location = "NEAREST_UPSTREAM"
referent_features = "ILI Survey Readings"
referent_field = "surveytype"
offset_units = "INTFEET"
output_format = "TABLE"
out_file = None
out_table = r"C:\Data\SampleData.gdb\RL2"

# Run the tool
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)

GenerateLRRouteLog, пример 3 (автономный скрипт)

В следующем автономном скрипте показано, как использовать функцию GenerateLRRouteLog с данными из сервиса объектов.

# Name: GenerateLRRouteLog_ex3.py
# Description: Create a route log data product that returns the location and information of crashes, speed limits, pavement conditions,
# centerlines, intersections, and city boundaries for routes in a combined LRS and Address Data Management dataset that is published as a feature service
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Data is in a feature service. Signing in to the Enterprise portal is required to access the feature service
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the LRS Network from the feature service. Here, 11 corresponds to the LRS Network's layer ID
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/11"

# Create the feature layers from the feature service. The feature layers will be used as log layers
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/25", "crash")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/24", "intersections")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/17", "speed_limit")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/14", "pavement_condition")
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/19", "centerline")

# Create a feature layer from the Cities layer of the feature service to be used as the location layer
arcpy.management.MakeFeatureLayer(r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/21", "cities")

# Map the Reference Post layer from the feature service to be used as the input to the referent_features parameter
referent_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/26"

# Set tool variables
effective_date = "12/31/2024"
log_fields = "crash CrashType; intersections IntersectionName; speed_limit SpeedLimit; pavement_condition Condition; centerline fullname"
merge_coincident_events = "MERGE"
location_fields = "cities name"
referent_location = "NEAREST"
referent_field = "PostName"
offset_units = "INTFEET"
output_format = "CSV"
out_file = r"C:\Data\RL3.csv"
out_table = None

# Run the tool
arcpy.locref.GenerateLRRouteLog(in_route_features, effective_date, log_fields, merge_coincident_events,
                                location_fields, referent_location, referent_features, referent_field,
                                offset_units, output_format, out_file, out_table)

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

Текущая рабочая область

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