Modify Event Behavior Rules (Location Referencing)

Summary

Modifies event behavior rules for the registered event layer or feature class.

Usage

• The following event behavior rules are set by default:

  Activity	Rule
  Calibrate Route	Stay Put
  Retire Route	Stay Put
  Extend Route	Stay Put
  Realign Route	Stay Put
  Reassign Route	Stay Put
  Carto Realign Route	Honor Route Measure

Parameters

Dialog

Label	Explanation	Data Type
Event Feature Class	The event feature class.	Feature Layer
Calibrate Rule (Optional)	Specifies the event behavior rule defined for the calibrate activity. Stay put —The geographic location of the event is preserved; measures may change. This is the default. Retire —Both measure and geographic location are preserved; the event is retired. Move —The measures of the event are preserved; the geographic location may change.	String
Retire Rule (Optional)	Specifies the event behavior rule defined for the retire activity. Stay put —The geographic location of the event is preserved; measures may change. This is the default. Retire —Both measure and geographic location are preserved; the event is retired. Move —The measures of the event are preserved; the geographic location may change.	String
Extend Rule (Optional)	Specifies the event behavior rule defined for the extend activity. Stay put —The geographic location of the event is preserved; measures may change. This is the default. Retire —Both measure and geographic location are preserved; the event is retired. Move —The measures of the event are preserved; the geographic location may change.	String
Reassign Rule (Optional)	Specifies the event behavior rule defined for the reassign activity. Stay put —The geographic location of the event is preserved; measures may change. This is the default. Retire —Both measure and geographic location are preserved; the event is retired. Move —The measures of the event are preserved; the geographic location may change. Snap —The geographic location of an event is preserved by snapping the event to a concurrent route; the measures may change.	String
Realign Rule (Optional)	Specifies the event behavior rule defined for the realign activity. Stay put —The geographic location of the event is preserved; measures may change. This is the default. Retire —Both measure and geographic location are preserved; the event is retired. Move —The measures of the event are preserved; the geographic location may change.	String

Derived Output

Label	Explanation	Data Type
Updated Input Feature Class	The updated feature layer.	Feature Layer

Python

arcpy.locref.ModifyEventBehaviorRules(in_feature_class, {calibrate_rule}, {retire_rule}, {extend_rule}, {reassign_rule}, {realign_rule})

Name	Explanation	Data Type
in_feature_class	The event feature class.	Feature Layer
calibrate_rule (Optional)	Specifies the event behavior rule defined for the calibrate activity. STAY_PUT —The geographic location of the event is preserved; measures may change. This is the default. RETIRE —Both measure and geographic location are preserved; the event is retired. MOVE —The measures of the event are preserved; the geographic location may change.	String
retire_rule (Optional)	Specifies the event behavior rule defined for the retire activity. STAY_PUT —The geographic location of the event is preserved; measures may change. This is the default. RETIRE —Both measure and geographic location are preserved; the event is retired. MOVE —The measures of the event are preserved; the geographic location may change.	String
extend_rule (Optional)	Specifies the event behavior rule defined for the extend activity. STAY_PUT —The geographic location of the event is preserved; measures may change. This is the default. RETIRE —Both measure and geographic location are preserved; the event is retired. MOVE —The measures of the event are preserved; the geographic location may change.	String
reassign_rule (Optional)	Specifies the event behavior rule defined for the reassign activity. STAY_PUT —The geographic location of the event is preserved; measures may change. This is the default. RETIRE —Both measure and geographic location are preserved; the event is retired. MOVE —The measures of the event are preserved; the geographic location may change. SNAP —The geographic location of an event is preserved by snapping the event to a concurrent route; the measures may change.	String
realign_rule (Optional)	Specifies the event behavior rule defined for the realign activity. STAY_PUT —The geographic location of the event is preserved; measures may change. This is the default. RETIRE —Both measure and geographic location are preserved; the event is retired. MOVE —The measures of the event are preserved; the geographic location may change.	String

Derived Output

Name	Explanation	Data Type
out_feature_class	The updated feature layer.	Feature Layer

Code sample

ModifyEventBehaviorRules example 1 (Python window)

The following script demonstrates how to use the ModifyEventBehaviorRules tool in a Python window.

# Name: Modify_Event_Behavior_Rules_ex1.py
# Description: Modify event behavior rules for the registered event layer or feature class.
# Requires: ArcGIS Location Referencing 

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

# Tool variables 
in_feature_class = r"Data.gdb\LRS\P_ILIInspectionRange"
calibrate_rule = "RETIRE"
retire_rule = "STAY_PUT"
extend_rule = "STAY_PUT"
reassign_rule = "STAY_PUT"
realign_rule = "STAY_PUT"

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

# Execute the tool
arcpy.ModifyEventBehaviorRules_locref(in_feature_class, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule)

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

ModifyEventBehaviorRules example 2 (stand-alone script)

The following script demonstrates how to use the ModifyEventBehaviorRules tool in a stand-alone Python script.

# Name: Modify_Event_Behavior_Rules_ex2.py
# Description: Modify event behavior rules for the registered event layer or feature class
# Requires: ArcGIS Location Referencing 

# Import arcpy module
import arcpy 

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

# Local variables 
in_feature_class = r"Data.gdb\LRS\P_ILIInspectionRange"
calibrate_rule = "RETIRE"
retire_rule = "STAY_PUT"
extend_rule = "STAY_PUT"
reassign_rule = "STAY_PUT"
realign_rule = "STAY_PUT"

# Process:  Modify Event Behavior Rules
arcpy.ModifyEventBehaviorRules_locref(in_feature_class, calibrate_rule, retire_rule, extend_rule, reassign_rule, realign_rule)

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

Environments

Current Workspace

Licensing information

• Basic: Requires ArcGIS Location Referencing
• Standard: Requires ArcGIS Location Referencing
• Advanced: Requires ArcGIS Location Referencing