arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, {geometry_type}, {calibrate_rule}, {retire_rule}, {extend_rule}, {reassign_rule}, {realign_rule}, {reverse_rule}, {carto_realign_rule})
|
Name
|
Explanation
|
Data type
|
|
event_name
|
The name of the external event or table that will be registered to the LRS.
|
String
|
|
parent_network
|
The LRS Network to which the event will be registered.
|
Feature Layer
|
|
geometry_type
(Optional)
|
Specifies the geometry type that will be used for the external event or table.
|
String
|
|
calibrate_rule
(Optional)
|
Specifies the event behavior rule that will be used for the calibrate activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
|
String
|
|
retire_rule
(Optional)
|
Specifies the event behavior rule that will be used for the retire activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
SNAP—The geographic location of the event will be preserved by snapping the event to a concurrent route, and measures may change.
|
String
|
|
extend_rule
(Optional)
|
Specifies the event behavior rule that will be used for the extend activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
COVER—The geometric location and measure of a line event will be modified to include a new or newly modified section.
|
String
|
|
reassign_rule
(Optional)
|
Specifies the event behavior rule that will be used for the reassign activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
SNAP—The geographic location of the event will be preserved by snapping the event to a concurrent route, and measures may change.
|
String
|
|
realign_rule
(Optional)
|
Specifies the event behavior rule that will be used for the realign activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
SNAP—The geographic location of the event will be preserved by snapping the event to a concurrent route, and measures may change.
COVER—The geometric location and measure of a line event will be modified to include a new or newly modified section.
|
String
|
|
reverse_rule
(Optional)
|
Specifies the event behavior rule that will be used for the reverse activity.
STAY_PUT—The geographic location of the event will be preserved, and measures may change. This is the default.
RETIRE—Both measure and geographic location will be preserved, and the event will be retired.
MOVE—The measures of the event will be preserved, and the geographic location may change.
|
String
|
|
carto_realign_rule
(Optional)
|
Specifies the event behavior rule that will be used for the cartographic realign activity.
HONOR_ROUTE_MEASURE—The measure of the event will be preserved or changed proportionally to the route's measure change. This is the default.
|
String
|
Derived output
|
Name
|
Explanation
|
Data type
|
|
out_workspace
|
The updated LRS workspace.
|
Workspace
|
Code sample
ConfigureExternalEventBehaviorsWithLRS example 1 (Python window)
The following script demonstrates how to use the ConfigureExternalEventBehaviorsWithLRS function to configure an external point event in the Python window.
# Name: Configure_Externaleventbehaviors_LRS_ex1.py
# Description: Configure an external point event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing
# Tool variables
event_name = "PointEvent"
parent_network = "C:\\Networkdata.sde\\Network1"
geometry_type = "POINT"
calibrate_rule = "STAY_PUT"
retire_rule = "STAY_PUT"
extend_rule = "STAY_PUT"
reassign_rule = "STAY_PUT"
realign_rule = "STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"
# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"
# Run the tool
arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, geometry_type, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)
ConfigureExternalEventBehaviorsWithLRS example 2 (Python window)
The following script demonstrates how to use the ConfigureExternalEventBehaviorsWithLRS function to configure an external line event with different event behaviors in the Python window.
# Name: Configure_Externaleventbehaviors_LRS_ex2.py
# Description: Configure an external line event in an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing
# Tool variables
event_name = "LineEvent"
parent_network = "C:\\Networkdata.sde\\Network1"
geometry_type = "LINE"
calibrate_rule = "STAY_PUT"
retire_rule = "RETIRE"
extend_rule = "COVER"
reassign_rule = "SNAP"
realign_rule = "COVER"
reverse_rule = "MOVE"
carto_realign_rule = "HONOR_ROUTE_MEASURE"
# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"
# Run the tool
arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, geometry_type, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)
ConfigureExternalEventBehaviorsWithLRS example 3 (Python window)
The following script demonstrates how to use the ConfigureExternalEventBehaviorsWithLRS function to modify an existing external line event in the Python window.
# Name: Configure_Externaleventbehaviors_LRS_ex3.py
# Description: Modify an existing external line event in an LRS Network in the Python window. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing
# Tool variables
event_name = "LineEvent"
parent_network = "C:\\Networkdata.sde\\Network1"
geometry_type = "LINE"
calibrate_rule = "RETIRE"
retire_rule = "RETIRE"
extend_rule = "RETIRE"
reassign_rule = "RETIRE"
realign_rule = "RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"
# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"
# Run the tool
arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, geometry_type, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)
ConfigureExternalEventBehaviorsWithLRS example 4 (stand-alone script)
The following stand-alone script demonstrates how to use the ConfigureExternalEventBehaviorsWithLRS function to configure an external line event that spans routes in an LRS Network.
# Name: Configure_Externaleventbehaviors_LRS_ex4.py
# Description: Configure an external line event in an LRS Network using a stand-alone Python script.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Tool variables
event_name = "LineEvent"
parent_network = "C:\\Networkdata.sde\\Network1"
geometry_type = "LINE"
calibrate_rule = "STAY_PUT"
retire_rule = "STAY_PUT"
extend_rule = "STAY_PUT"
reassign_rule = "STAY_PUT"
realign_rule = "STAY_PUT"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"
# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"
# Run the tool
arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, geometry_type, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)
ConfigureExternalEventBehaviorsWithLRS example 5 (stand-alone script)
The following stand-alone script demonstrates how to use the ConfigureExternalEventBehaviorsWithLRS function to modify an existing external point event in an LRS Network.
# Name: Configure_Externaleventbehaviors_LRS_ex5.py
# Description: Modify an existing external point event of an LRS Network using a stand-alone Python script. Event name and optional parameter fields are updated.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Tool variables
event_name = "PointEvent"
parent_network = "C:\\Networkdata.sde\\Network1"
geometry_type = "POINT"
calibrate_rule = "RETIRE"
retire_rule = "RETIRE"
extend_rule = "RETIRE"
reassign_rule = "RETIRE"
realign_rule = "RETIRE"
reverse_rule = "STAY_PUT"
carto_realign_rule = "HONOR_ROUTE_MEASURE"
# Set current workspace
arcpy.env.workspace = "C:\\Networkdata.sde"
# Run the tool
arcpy.locref.ConfigureExternalEventBehaviorsWithLRS(event_name, parent_network, geometry_type, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule, reverse_rule, carto_realign_rule)