Построить маршруты (Location Referencing)

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

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

Воссоздает геометрии и применяет изменения калибровки для объектов маршрута в сети LRS.

Этот инструмент также может определять изменения калибровки на маршрутах, чтобы можно было обрабатывать поведение событий. Эти изменения калибровки могут быть вызваны добавлением, редактированием или удалением точек калибровки без использования инструментов Location Referencing в ArcGIS Pro.

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

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

  • Для запуска инструмента необходим набор данных LRS.

    Узнайте больше о создании набора данных LRS в ArcGIS Pipeline Referencing или создании набора данных LRS в ArcGIS Roads and Highways.

  • Если калибровочные точки удалены или их дата изменена без использования инструментов ArcGIS Location Referencing в ArcGIS Pro, а инструмент Построить маршруты запускается с отмеченным параметром Записать изменения калибровки для обновлений местоположения события, любые события в области, где калибровочная точка была удалена, или дата которых была изменена, будут перемещать поведение событий вместо того, чтобы оставлять на месте.

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

  • Маршруты в производной сети строятся путем объединения геометрий маршрута в родительской линии.

  • Если для инструмента включено предотвращение конфликтов, любые события, создаваемые этим инструментом, будут заблокированы.

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

  • Этот инструмент поддерживает предотвращение конфликтов и будет пытаться получать и передавать блокировки.

    Более подробно о предотвращении конфликтов в ArcGIS Pipeline Referencing или о предотвращении конфликтов в ArcGIS Roads and Highways.

Параметры

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

Сеть LRS, для которой будут воссозданы геометрии маршрута и применены изменения калибровки.

Feature Layer
Записать изменения калибровки для обновлений местоположения события
(Дополнительный)

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

  • Отмечено — любые точки калибровки, созданные, измененные или удаленные без использования инструментов Location Referencing, будут применены к маршрутам в сети, а поведение событий будет применено при следующем запуске инструмента Применить поведение событий.
  • Не отмечено — изменения калибровки будут применены к маршрутам в сети LRS, но поведение событий не будет применяться. Это значение по умолчанию
Boolean

Производные выходные данные

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

Обновленный слой объектов маршрута.

Feature Layer
Выходные объекты производного маршрута

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

Feature Layer
Выходной файл результатов

Текстовый файл с подробным описанием маршрутов, которые были обновлены в классе объектов сети LRS.

Text File

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})
ИмяОписаниеТип данных
in_route_features

Сеть LRS, для которой будут воссозданы геометрии маршрута и применены изменения калибровки.

Feature Layer
record_calibration_changes
(Дополнительный)

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

  • RECORD_CALIBRATION_CHANGESЛюбые точки калибровки, созданные, измененные или удаленные без использования инструментов Location Referencing, будут применены к маршрутам в сети, а поведение событий будет применено при следующем запуске инструмента Применить поведение событий.
  • NO_RECORD_CALIBRATION_CHANGESИзменения калибровки будут применены к маршрутам в сети LRS, но поведение событий не будет применяться. Это значение по умолчанию
Boolean

Производные выходные данные

ИмяОписаниеТип данных
out_route_features

Обновленный слой объектов маршрута.

Feature Layer
out_derived_route_features

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

Feature Layer
out_details_file

Текстовый файл с подробным описанием маршрутов, которые были обновлены в классе объектов сети LRS.

Text File

Пример кода

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

Показывает использование функции GenerateRoutes в режиме прямого запуска.

# Name: GenerateRoutes_ex1.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "NO_RECORD_CALIBRATION_CHANGES"

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

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)
arcpy.CheckInExtension('LocationReferencing')
GenerateRoutes, пример 2 (автономный скрипт)

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

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "RECORD_CALIBRATION_CHANGES"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
GenerateRoutes, пример 3 (автономный скрипт)

Показывает, как использовать функцию GenerateRoutes в автономном скрипте Python в сервисе объектов.

# Name: GenerateRoutes_Pro_Ex3.py.py
# Description: Generate routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input LRS route network from the feature service. Here, 1 corresponds to the input LRS route network.
in_route = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process : Generate Routes.
arcpy.locref.GenerateRoutes(in_route)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

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

Особые случаи

Коэффициент параллельной обработки

Значение по умолчанию для этого параметра среды, если оно оставлено пустым, равно 0%. Любое абсолютное значение параметра среды всегда заключено между 0 и количеством логических ядер данного компьютера.

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

  • 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)

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