Перенести измерения событий (Location Referencing)

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

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

Переносит измерения (m-значения) точки или слоя линейных событий из одного линейного метода привязки (LRM) в другой.

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

Помимо измерений связанные маршруты объектов события также могут иметь различаться между двумя LRM. На выходе этого инструмента получается класс объектов с правильными измерениями и связанными маршрутами целевой сети LRS.

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

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

  • Этот инструмент не изменяет никакие входные данные и создает класс объектов на выходе.

  • Этот инструмент поддерживает одно временное представление за один раз. Создайте определяющий запрос по времени или примените набор выборки по времени к входному слою событий, а также к целевой сети LRS перед запуском этого инструмента. Бегунок времени в ArcGIS Pro также можно использовать, если время настроено для обоих входных слоев.

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

  • Если целевой сетью является линейная сеть LRS, также известная как инженерная сеть, входной слой событий может быть перенесен, даже если исходная сеть входного слоя событий не поддерживает линии.

  • Тип выходного класса пространственных объектов — линия или точка — должен соответствовать типу входного слоя событий.

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

  • Для определения сопоставленных условий, возникающих во время переноса, в выходном классе объектов создается поле с именем Loc_Error, содержащее такие значения, какMulti-Match, Partial Match, No Match и No Error.

  • Атрибутивные поля из входного слоя событий будут включены в выходной класс объектов.

  • Если целевая сеть LRS содержит параллельные маршруты, используйте опцию Сопоставление параллельных маршрутов.

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

  • Этот инструмент выполнит пространственное наложение входного слоя событий на целевую сеть LRS для создания объектов для входного события в целевой сети. Эти объекты будут содержать ID маршрута и информацию об измерениях этого местоположения на маршруте.

  • Входной слой событий и целевая сеть должны представлять только один момент времени для получения точных выходных данных. Если входной слой событий представляет несколько моментов времени, установите фильтр с помощью бегунка времени или используйте определяющий запрос для столбцов даты.

  • Выходные данные могут быть добавлены к новому или существующему событию LRS с помощью инструмента Присоединить события. Если входной слой событий содержал несколько временных представлений и это привело к многократному запуску этого инструмента с разными фильтрами даты, каждый результат на выходе может быть добавлен в один класс объектов событий LRS с помощью инструмента Присоединить события.

Параметры

ПодписьОписаниеТип данных
Слой источника события

Входной слой событий, который должен быть перенесен.

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

Целевая сеть LRS, относительно которой будут переноситься входные события.

Feature Layer
Выходной слой событий

Выходной класс пространственных объектов, который будет содержать объекты перенесенного события.

Feature Class
Сопоставление параллельных маршрутов
(Дополнительный)

Указывает метод, используемый для определения маршрута для переноса события, когда в целевой сети LRS существуют параллельные маршруты. Этот параметр применяется только в том случае, если местоположение переноса события в целевой сети LRS имеет параллельные маршруты (маршруты с общим местоположением).

  • Любой параллельный маршрутВходной слой событий переносится относительно первого из двух или более параллельных маршрутов, найденных в целевой сети LRS.
  • Маршрут с совпадающим RouteIDID маршрута исходного события сравнивается с ID маршрутов параллельных маршрутов в целевой сети LRS. Исходное событие будет перенесено на основе совпадения ID маршрутов в исходном событии и целевой сети. ID маршрутов входного события и целевой сети LRS совпадать для целей этого метода для правильного переноса события. Входной слой событий также должен быть зарегистрированным событием LRS, чтобы можно быть использовать этот метод.
  • Все параллельные маршрутыВходное событие переносится относительно всех параллельных маршрутов в этом местоположении в целевой сети LRS.
String

arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
ИмяОписаниеТип данных
in_source_event

Входной слой событий, который должен быть перенесен.

Feature Layer
in_target_route_features

Целевая сеть LRS, относительно которой будут переноситься входные события.

Feature Layer
out_target_event

Выходной класс пространственных объектов, который будет содержать объекты перенесенного события.

Feature Class
in_concurrent_route_matching
(Дополнительный)

Указывает метод, используемый для определения маршрута для переноса события, когда в целевой сети LRS существуют параллельные маршруты. Этот параметр применяется только в том случае, если местоположение переноса события в целевой сети LRS имеет параллельные маршруты (маршруты с общим местоположением).

  • ANYВходной слой событий переносится относительно первого из двух или более параллельных маршрутов, найденных в целевой сети LRS.
  • ROUTE_IDID маршрута исходного события сравнивается с ID маршрутов параллельных маршрутов в целевой сети LRS. Исходное событие будет перенесено на основе совпадения ID маршрутов в исходном событии и целевой сети. ID маршрутов входного события и целевой сети LRS совпадать для целей этого метода для правильного переноса события. Входной слой событий также должен быть зарегистрированным событием LRS, чтобы можно быть использовать этот метод.
  • ALLВходное событие переносится относительно всех параллельных маршрутов в этом местоположении в целевой сети LRS.
String

Пример кода

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

В следующем скрипте окна Python показано, как использовать инструмент TranslateEventMeasures в режиме прямого запуска в ArcGIS Pro:

# Name: TranslateEventMeasures_ex2.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

# Tool variables
in_source_event = "Test Pressure Range"
in_target_route_features = "Station Series Network"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

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

# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
TranslateEventMeasures, пример 2 (автономный скрипт)

В следующем автономном скрипте показано, как использовать инструмент TranslateEventMeasures в ArcGIS Pro:

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
Concurrency = "ANY"

# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(Event, Network, Output, Concurrency)

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

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

# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

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

# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
target_route_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

# Set tool variables
output_event = r"C:\Data\LocationReferencing.gdb\outputevent"
concurrency = "ANY"

# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(source_event, target_route_network, output_event, concurrency)

# Check in 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)

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