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

Доступно с лицензией Location Referencing.

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

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

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

  • Этот инструмент поддерживает данные из файловой базы геоданных или многопользовательской базы геоданных (подключение сервис-ориентированных версий), или из сервисов объектов (опубликованных из сервис-ориентированных версий).

  • Этот инструмент не изменяет входные данные и создает файл .csv или таблицу базы геоданных в качестве выходных данных.

  • Параметр Дата вступления в силу используется для определения временного вида сети. Для расчета выходных данных будут использоваться только маршруты, активные на эту дату.

  • Слои журнала, местоположения и референта должны храниться в одной и той же базе геоданных или сервисе объектов и иметь ту же систему координат, что и указанная сеть LRS.

  • Слой журнала может представлять собой класс объектов точечных событий LRS, класс объектов линейных событий LRS или класс объектов пересечений LRS, зарегистрированный в указанной сети LRS. Класс объектов центральных линий также может использоваться в качестве слоя журнала, если он настроен с помощью решения Address Data Management или инженерной сети.

  • Слой местоположения должен быть классом полигональных объектов.

  • Выходные данные будут созданы на основе пересечения выбранных объектов из сети LRS, слоя (слоев) журнала, слоя (слоев) местоположения и базового слоя.

  • Слой референта должен быть классом объектов точечных событий LRS, зарегистрированным в указанной сети LRS.

  • Значение Неклассифицированный будет включено в выходные поля местоположения для маршрутов, которые не пересекаются со слоями местоположения.

  • Вы можете добавить несколько полей журнала и местоположения из одного и того же класса объектов, создав слои выборки и указав каждый слой выборки в качестве поля журнала или поля местоположения. Например, если у вас есть класс объектов линейных событий LRS, вы можете создать два слоя выборки - класс A и класс B - и указать каждый из этих слоев выборки в качестве поля журнала.

Параметры

ПодписьОписаниеТип данных
Входные объекты-маршруты

Объекты-маршруты, которые будут использоваться для создания журнала маршрута.

Feature Layer
Дата вступления в силу

Дата, которая будет использоваться для определения временного представления сети.

Значение по умолчанию — сегодняшняя дата.

Date
Поля журнала
(Дополнительный)

Поля, которые будут использоваться для отображения информации о событиях и пересечениях в выходных данных.

  • Слой - векторный слой, который будет использоваться в качестве слоя журнала.
  • Поле — поле, которое будет участвовать в журнале маршрута.

Value Table
Слияние совпадающих событий
(Дополнительный)

Указывает, будут ли совпадающие линейные события объединяться в выходных данных.

  • Отмечено - совпадающие линейные события с одним и тем же значением в поле журнала будут объединены и возвращены как одно событие.
  • Не отмечено - совпадающие линейные события с одним и тем же значением в поле журнала не будут объединены или возвращены как одно событие. Это значение по умолчанию
Boolean
Поля местоположения
(Дополнительный)

Поля, используемые для отображения атрибутов границ полигонов, пересекаемых маршрутами.

  • Слой - векторный слой, который будет использоваться в качестве слоя местоположения.
  • Поле - поле, содержащее атрибуты границ полигонов, пересекаемых маршрутами.
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,...]
(Дополнительный)

Поля, которые будут использоваться для отображения информации о событиях и пересечениях в выходных данных.

  • Слой - векторный слой, который будет использоваться в качестве слоя журнала.
  • Поле — поле, которое будет участвовать в журнале маршрута.

Value Table
merge_coincident_events
(Дополнительный)

Указывает, будут ли совпадающие линейные события объединяться в выходных данных.

  • MERGEСовпадающие линейные события с одним и тем же значением в поле журнала будут объединены и возвращены как одно событие.
  • DO_NOT_MERGEСовпадающие линейные события с одним и тем же значением в поле журнала не будут объединены или возвращены как одно событие. Это значение по умолчанию
Boolean
location_fields
[location_fields,...]
(Дополнительный)

Поля, используемые для отображения атрибутов границ полигонов, пересекаемых маршрутами.

  • Слой - векторный слой, который будет использоваться в качестве слоя местоположения.
  • Поле - поле, содержащее атрибуты границ полигонов, пересекаемых маршрутами.
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 
 
# Check out the license 
arcpy.CheckOutExtension("LocationReferencing")

# 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 
 
# Check out the license 
arcpy.CheckOutExtension("LocationReferencing") 
 
# 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)
 
# Check in the license 
arcpy.CheckInExtension("LocationReferencing")

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

  • Basic: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
  • Standard: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)
  • Advanced: Обязательно ArcGIS Location Referencing (ArcGIS Pipeline Referencing или ArcGIS Roads and Highways)

Связанные разделы