Dynamic Segmentation widget

The Dynamic Segmentation widget takes multiple input event layers and summarizes them into a single segmented table. The tool creates new records, known as segments, at any measure along the event where any of the attributes from any of the input event layers change. You can view the results of a dynamic segmentation in either a table or a straight line diagram (SLD). An SLD graphs the input and output event layers. You can use this widget to manage and visualize pipeline data with ArcGIS Pipeline Referencing and roadways data with ArcGIS Roads and Highways.

Note:

All Location Referencing widgets support express mode. When you create an app in express mode, all Location Referencing widgets are automatically configured based on the web map added to the Map widget. Any modifications made in the Map widget, such as changing the web map, will instantly be reflected in the Location Referencing widgets. Express mode allows you to efficiently set up Location Referencing widgets within ArcGIS Experience Builder, streamlining the deployment process for apps that contain Location Referencing widgets.

Learn more about express mode

Examples for Pipeline Referencing

Use this widget to support app design requirements such as the following:

• You want to analyze pipeline conditions and allocate funds for pipeline maintenance.
• You need users to perform a cross-event check to verify the accuracy of event data along a route.
• You want to check for gaps in your data and fill them.

Examples for Roads and Highways

Use this widget to support app design requirements such as the following:

• You want to analyze road conditions using variables like traffic and jurisdiction to determine how to allocate maintenance funds.
• You need users to perform a cross-event check to verify the accuracy of Highway Performance Monitoring System (HPMS) data along a route.
• You want to check for gaps in your data and fill them.

Usage notes

This widget requires connection to a Map widget. To dynamically segment events, the Map widget must be connected to a web map data source with an LRS published with the Linear Referencing and Version Management capabilities enabled.

To create an LRS and publish a feature service with the Linear Referencing and Version Management capabilities enabled, follow the steps in ArcGIS Pro documentation:

• Pipeline Referencing—Create an LRS and share an LRS as web layers
• Roads and Highways—Create an LRS and share an LRS as web layers

To use the Dynamic Segmentation widget with feature services published with ArcGIS Enterprise, you must sign in with an ArcGIS Enterprise account.

When you include this widget in an app, you can display results in a table or in a straight line diagram.

When you display results in a table, you can interact with the table in the following ways:

• Double-click a cell in the table to edit its value.

  Note:

  A line event's user-managed fields are editable when Type = Line in the table. A point event's user-managed fields are editable when Type = Point.

• Click Save to save changes. Edits affect individual event layers.

A straight line diagram is a graphical representation of event locations and their characteristics along routes. Like the table, the diagram is interactive and editable. Edits affect individual event layers.

When you display results in a straight line diagram, you can interact with the diagram in the following ways:

• Use the navigation buttons to change the scale and extent represented by the diagram.
• Click the name of a layer to hide it from the diagram. You can click a hidden layer to return it to the active list.
• Hover the pointer over an event to display a tooltip that lists event attributes.
• Click an event to highlight it on the map and see attributes and statistics in a pop-up window. Some attributes are editable.
• Hover the pointer over the measure bar to display a tooltip that lists exact measure values.
• Click a measure value to display a pop-up window that lists attributes of all events that exist at that measure.
• Click the Map Interact button to turn off or turn on synchronization between the Map widget and the straight line diagram. When enabled, navigating within the map will update the SLD, and vice versa.

  Note:

  When Map Interact is enabled, double-clicking along the SLD’s scale bar will cause the map to zoom to the measure’s location.

If you experience poor performance or failures when using this widget, increase the heap size at the service level.

Example of dynamic segmentation

Note:

The following is an example of dynamic segmentation for ArcGIS Roads and Highways.

View a similar example for ArcGIS Pipeline Referencing

In the following diagram, two line event layers, Speed Limit and Functional Class, and a point event layer are associated with a single route. Each event layer has different values along the route measures indicated by the color changes.

A straight line diagram displays dynamically segmented event layers.

The route is calibrated from left to right between measures 0 and 8. The three events are present on the route and have the input and output properties described in the subsections below.

Input

The following tables show the events' attributes:

Input (Speed Limit)

Route ID	Event ID	From Measure	To Measure	From Date	To Date	Speed Limit
Route1	Event1	0	4	1/1/2000	<Null>	65
Route1	Event2	4	8	1/1/2000	<Null>	40

Input (Functional Class)

Route ID	Event ID	From Measure	To Measure	From Date	To Date	Functional Class
Route1	Event1	0	6.7	1/1/2000	<Null>	Interstate
Route1	Event2	6.7	8	1/1/2000	<Null>	US Highway

Input (Point Event)

Route ID	Event ID	Measure	From Date	To Date	Code
Route1	Event1	5	1/1/2000	<Null>	P1

Output

The output feature class and accompanying attribute table are dynamically created using data from constituent line events. The attribute table is editable, and the edits go through to the individual event layers.

Moving in the direction of calibration of the route (from left to right), the first segment in the events is caused by the Speed Limit, 65, which starts at measure 0 and ends at measure 4. The second segment is caused by the Speed Limit, 40, which starts at measure 4 and ends at measure 5 due to the presence of the Point Event, P1. The third segment is caused by the Point Event, P1, at measure 5. The fourth segment between measures 5 and 6.7 contains the Speed Limit, 40, and the Functional Class, Interstate. The final segment between measures 6.7 and 8 containing the Speed Limit, 40, and the Functional Class, US Highway.

The following table shows the dynamic segmentation output:

Output (Dynamic Segmentation)

Route ID	Type	Section	From Measure	To Measure	From Date	To Date	Speed Limit	Functional Class	Code
Route1	Line	1	0	4	1/1/2000	<Null>	65	Interstate
Route1	Line	2	4	5	1/1/2000	<Null>	40	Interstate
Route1	Point	3	5	5	1/1/2000	<Null>	40	Interstate	P1
Route1	Line	4	5	6.7	1/1/2000	<Null>	40	Interstate
Route1	Line	5	6.7	8	1/1/2000	<Null>	40	US Highway

Settings

The Dynamic Segmentation widget includes the following settings:

• Mode—Choose a method of loading data.
  • Select Layers—Select a Map widget and load all layers from the web map.
    • Select a Map widget—Select a Map widget in the page that's connected to a web map.
    • Load layers—Load layers from the web map in the connected Map widget. To load layers, the Map widget must be connected to a web map that contains LRS layers.
    • Clear layers—Remove all loaded layers from the widget.
    • Layers—After loading layers, you can click the down arrow to expand the list of layers. Click a layer to open the Layer Configuration panel.
    • Layer Configuration—Configure settings for individual layers.
      • LRS Network layers:
        • Route Identifier—Choose the default route identifier. For non-line networks, the default is route ID. For line networks, the default is route name.
      • LRS event layers:
        • Display field—Choose a display field for the event layer.
  • Interact with a Map widget—Connect the Dynamic Segmentation widget to a Map widget. Any web maps in the connected Map widget appear in the list. After connecting to a Map widget, you can click the down arrow next to the Select Layers button to expand the list of layers. Click a layer to open the Layer Configuration panel.
    • Layer Configuration—Configure settings for individual layers. Review the settings available in the Layer Configuration panel.
    • Select Layers—Click the Select Layers button to open the Select Layers panel. You can select or unselect layers from the list in the panel.
• Default settings—Configure the following default settings for when the widget first loads.
  • Default dynamic segmentation result—Choose a default method for displaying results, either a table or a straight line diagram. You can switch between the two at run time.
  • Default Network—If you add more than one network layer, you can set a default network layer.

    Note:

    When using the Route ID or Route Name text box to search for routes to be included in the dynamic segmentation, only route features within the Default Network parameter value can be queried. To query other LRS Networks, use data actions.

  • Default attribute set type—Choose whether to show results using a line attribute set or both line and point attribute sets.
  • Line attribute set—Choose a default line attribute set.
  • Point attribute set—Choose a default point attribute set.
  • Allow editing—Turn on this setting to allow users who have access to the data to edit data in the dynamic segmentation table and straight line diagram.
  • Merge coincident events—Turn on this setting to automatically merge edited events that have exactly the same attributes as an existing event and are adjacent to or overlapping with that existing event in terms of measure values.
  • Table highlight color—Choose a color for the rows in the results table.
  • Map highlight color—Choose a color for displaying routes on the connected map.
  • Diagram default scale—Choose a default scale for the straight line diagram. The unit is the network's unit.
  • Show statistics—Turn on this setting to show statistics in a pop-up window when double-clicking an event in a straight line diagram.

Interaction options

The following widgets support the Dynamic Segmentation data action, which you can turn on in the Action tab of their settings.

• LRS Identify widget
• Search By Route widget
• Table widget

Run dynamic segmentation

Complete the following steps to run dynamic segmentation:

1. Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
2. Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing and Version Management capabilities enabled.

   Learn more about enabling these capabilities in ArcGIS Pro for Pipeline Referencing

   Learn more about enabling these capabilities in ArcGIS Pro for Roads and Highways

3. Add a Dynamic Segmentation widget. Connect it to the Map widget, and load LRS layers from the Map widget.
4. Publish the app.
5. Launch the app. If prompted, sign in to your ArcGIS Enterprise portal.
6. Open the Dynamic Segmentation widget.
7. Provide a route ID or name in the Route ID or Route Name text box.

   If the network layer has a route name configured as an identifier, this setting is labeled Route Name.

   Note:

   You can also select events to be dynamically segmented with the LRS Identify widget, the Search By Route widget, or the Table widget. For more information, refer to the sections below.

8. Select a record from the search results.

   The dynamic segmentation table or straight line diagram populates with results.

Run dynamic segmentation with the LRS Identify widget

To use the Dynamic Segmentation data action at run time with the LRS Identify widget, complete the following steps:

1. Identify a location on a route with the LRS Identify widget.
2. Click the Actions button at the top of the LRS Identify widget panel.
3. Click Dynamic Segmentation.

   The dynamic segmentation table or straight line diagram populates with results.

Run dynamic segmentation with the Search By Route widget

To use the Dynamic Segmentation data action at run time with the Search By Route widget, complete the following steps:

1. Search for a route using one of the following measure options:
   • No measure—All the events present between the start and end of the route are dynamically segmented.
   • Single measure—All the events located at the searched measure location are dynamically segmented.
   • Multiple measures—All the events located between the smallest and largest searched measure locations are dynamically segmented.
   • Range of measures—All the events located between the start measure and the end measure are dynamically segmented.
2. Select a record from the search results.
3. Click the Actions button at the top of the Search By Route widget panel.
4. Click Dynamic Segmentation.

   The dynamic segmentation table or straight line diagram populates with results.

Run dynamic segmentation with the Table widget

To use the Dynamic Segmentation data action at run time with the Table widget, complete the following steps:

1. Select a single route record in the table.
2. Click the Actions button at the top of the Table widget panel.
3. Click Dynamic Segmentation.

   The dynamic segmentation table or straight line diagram populates with results.