Overlay Events (Location Referencing)

ArcGIS Pro 3.4 | | Help archive

Available with Location Referencing license.

Summary

Overlays one or more line and point event layers onto a target network and outputs a feature class or table that represents the dynamic segmentation of the inputs.

Illustration

Overlay Events tool illustration

Usage

  • The following table is the output for the tool illustration above:

    Output (Overlay Events)

    TypeFrom MeasureTo MeasureLine Event 1Line Event 2Point Event

    Line

    0

    2

    A

    1

    <Null>

    Point

    2

    2

    A

    1

    PE1

    Line

    2

    3

    A

    1

    <Null>

    Line

    3

    4

    B

    1

    <Null>

    Line

    4

    5

    B

    2

    <Null>

  • All Event Layers values can either be line events only or can include both point and line events.

  • The Event Layers parameter can only include event feature classes registered with an ArcGIS Location Referencing network.

    Note:

    The centerline layer can be input to the Event Layers parameter to dynamically segment events when the centerline layer is part of an Address Data Management solution or a Utility Network configuration. The centerline direction is honored in the outputs when the centerline layer is part of an Address Data Management solution configuration.

  • If the input layer has address range fields from an Address Data Management configuration and is configured as an address feature class in an LRS, the values in the address range fields will be updated for each segment in the output.

  • If the input events use different linear referencing methods (LRM), they will be translated using the LRM of the target network.

  • This tool supports selection sets on the Input Route Features and Event Layers parameter values.

  • This tool supports definition filters on the Input Route Features and Event Layers parameter values.

  • This tool supports input Event Layers values that are configured to contain events that span multiple routes. The output will still dynamically segment at the route level of the target network using the Network Fields parameter value.

  • This tool supports temporal segmentation (time slicing). This will occur by default and can be overridden by creating a time-based definition query or applying a selection set to the inputs.

  • This tool supports the inclusion of one or more fields from the network feature class in the output using the Network Fields parameter.

  • The output can be saved as either a table or a feature class.

  • If the output is saved as a table or feature class, the output will have the following indexes and fields:

    IndexField

    Route_ID

    • Route_ID

    Rid_Dates_Me

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

  • This tool supports the Gas Utility Network configuration pipeline feature layer as an input event layer if this feature class has been configured for use with an LRS using the Configure Utility Network Feature Class tool.

  • If more than one LRS Network exists in the Gas Utility Network configuration, the measures for the input event layers will match the measures shown in the second column of the following table:

    If the LRS with the Utility Network Configuration containsThe measures in the PipelineLine feature class belong to

    Line network, nonline network

    Line network

    Line network

    Line network

    More than one line network

    Line network that has the derived network

    More than one line network with no derived network

    Line network that has the lowest number in the coded-value domain, dLRSNetworks

    More than one line network with derived networks

    Line network that has the lowest number in the coded-value domain, dLRSNetworks

    One nonline network

    Nonline network

    More than one nonline network

    Network that has the lowest number in the coded-value domain, dLRSNetworks

  • This tool supports physically gapped routes and events as input routes and input events, respectively.

  • Only one event per layer can be on a route segment. For example, for the layer named Speed Limit, only one event record in that layer can be on that segment. A segment can have multiple events, each in its own event layer. Use the ArcGIS Data Reviewer Invalid Event Measures check to identify and resolve issues with event data.

Parameters

LabelExplanationData Type
Input Route Features

The target network onto which the event layers will be dynamically segmented.

Feature Layer
Event Layers

The event layers that will be dynamically segmented together onto a target network. The centerline layer can be used as an input to dynamically segment events.

Feature Layer
Output Dataset

The table or feature class containing the output event records that will be created.

Table
Include Geometry
(Optional)

Specifies whether the Output Dataset parameter value will include event geometry.

  • Unchecked—The Output Dataset parameter value will not include event geometry. Event records will be stored as a table. This is the default.
  • Checked—The Output Dataset parameter value will include event geometry. Event records will be stored as a feature class.
Boolean
Network Fields
(Optional)

The fields from the network layer that will be included in the output.

Field

Environments

Licensing information

  • Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
  • Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)

Related topics