Apply Event Behaviors (Location Referencing)

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

Updates the event locations for all event feature classes registered with the input network based on the route edit performed.

The events get updated as per the configured event behavior.

To learn more about event behavior and configuring event behavior, see event behavior in ArcGIS Pipeline Referencing or event behavior in ArcGIS Roads and Highways.

Иллюстрация

Apply Event Behaviors tool illustration

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

  • An LRS dataset is required to run this tool. To create an LRS dataset, add the calibration point, centerline, and redline layers to a feature dataset; then run the Modify LRS tool with the geodatabase as the input.

  • This tool will process all event behaviors for all event feature classes registered with the input network.

  • This tool will process edits that have not been processed earlier in the working geodatabase version. Once the event behavior for a particular route edit is processed, it is marked as processed. When you post the edits to the parent version, if the event behavior is already processed, they will not get processed again.

    Примечание:

    Selection or definition queries used to filter the route or event records in the map are ignored to keep events in sync with route edits.

  • Внимание:

    This tool modifies the event records in the event feature classes. See Tools that do not create output datasets for more information and strategies to avoid unwanted data changes.

  • When conflict prevention is enabled and route edits (including create, realign, reassign, retire, extend, calibrate, and cartographic realignment) are made in a child version, this tool must be run before posting that version. If the route edits are made in the default version, this tool must be run before any child version can be reconciled against the default version.

Параметры

ПодписьОписаниеТип данных
Input Route Features

The LRS Network for which event locations will be updated. This must be a feature layer registered as a network with the LRS.

Feature Layer

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

ПодписьОписаниеТип данных
Output Event Layers

The updated event layers.

Feature Layer
Output Details File

A text file that details changes made by the tool.

Text File

arcpy.locref.ApplyEventBehaviors(in_route_features)
ИмяОписаниеТип данных
in_route_features

The LRS Network for which event locations will be updated. This must be a feature layer registered as a network with the LRS.

Feature Layer

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

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

The updated event layers.

Feature Layer
out_details_file

A text file that details changes made by the tool.

Text File

Пример кода

ApplyEventBehaviors example 1 (stand-alone script)

Demonstrates how to use the ApplyEventBehaviors tool as a stand-alone Python script.

# Name: ApplyEventBehaviors_Pro_ex1.py
# Description: Processes event behaviors for events impacted by edits to the LRS Network in a stand-alone script.
# Requirements: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
network = r"C:\Data\UPDM.gdb\LRS\P_StationSeriesNetwork"

# Execute the tool
arcpy.ApplyEventBehaviors_locref(network)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
ApplyEventBehaviors example 2 (Python window)

Demonstrates how to use the ApplyEventBehaviors tool in the Python window.

# Name: ApplyEventBehaviors_ex2.py
# Description: Process event behaviors for events impacted by edits to the LRS Network in the Python window.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Set tool variables
in_route_features = "Station_Series_Network"

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

# Execute the tool
arcpy.ApplyEventBehaviors_locref(in_route_features)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
ApplyEventBehaviors example 3 (stand-alone script)

Demonstrates how to use the ApplyEventBehaviors tool as a stand-alone Python script in a feature service.

# Name: ApplyEventBehaviors_Pro_Ex3.py
# Description: Processes event behaviors 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 any necessary licenses.
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  LRS network from the feature service. Here, 1 corresponds to the  LRS network.
in_network_layer = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Execute the tool
arcpy.ApplyEventBehaviors_locref(in_network_layer)

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

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

Этот инструмент не использует параметры среды геообработки

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

  • Basic: Обязательно ArcGIS Location Referencing
  • Standard: Обязательно ArcGIS Location Referencing
  • Advanced: Обязательно ArcGIS Location Referencing

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