Perform valve isolation trace

View in

Android

Forms

UWP

WPF

WinUI

iOS

View on GitHub

Run a filtered trace to locate operable features that will isolate an area from the flow of network resources.

Image of a utility network with an isolation trace applied to it

Use case

Determine the set of operable features required to stop a network's resource, effectively isolating an area of the network. For example, you can choose to return only accessible and operable valves: ones that are not paved over or rusted shut.

How to use the sample

Tap on one or more features to use as filter barriers or create and set the configuration's filter barriers by selecting a category. Check or uncheck 'Include Isolated Features'. Tap 'Trace' to run a subnetwork-based isolation trace. Tap 'Reset' to clear filter barriers.

How it works

Create a MapView and subscribe to its GeoViewTapped event.
Create and load a ServiceGeodatabase with a feature service URL and get tables by their layer IDs.
Create a Map that contains FeatureLayer(s) created from the ServiceGeodatabase's tables.
Create and load a UtilityNetwork with the same feature service URL and this Map.
Create UtilityTraceParameters with UtilityTraceType.Isolation and a starting location from a given asset type and global ID.
Get a default UtilityTraceConfiguration from a given tier in a domain network to set UtilityTraceParameters.TraceConfiguration.
Add a GraphicsOverlay with a Graphic that represents this starting location; and another GraphicsOverlay for filter barriers.
Populate the choice list for the 'Filter Barrier: Category exists' from UtilityNetworkDefinition.Categories.
When the MapView is tapped, identify which features are at the tap location and add a Graphic that represents a filter barrier.
Create a UtilityElement for the identified feature and add this UtilityElement to a collection of filter barriers.
- If the element is a junction with more than one terminal, display a terminal picker. Then set the junction's Terminal property with the selected terminal.
- If an edge, set its FractionAlongLine property using GeometryEngine.FractionAlong.
If 'Trace' is tapped without filter barriers:
- Create a new UtilityCategoryComparison with the selected category and UtilityCategoryComparisonOperator.Exists.
- Create a new UtilityTraceFilter with this condition as Barriers to set Filter and update IncludeIsolatedFeatures properties of the default configuration from step 5.
- Run a UtilityNetwork.TraceAsync.
If 'Trace' is tapped with filter barriers:
- Update IncludeIsolatedFeatures property of the default configuration from step 5.
- Run a UtilityNetwork.TraceAsync.
For every FeatureLayer in the map, select the features returned with GetFeaturesForElementsAsync from the elements matching their NetworkSource.FeatureTable with the layer's FeatureTable.

Relevant API

FractionAlong
ServiceGeodatabase
UtilityCategory
UtilityCategoryComparison
UtilityCategoryComparisonOperator
UtilityDomainNetwork
UtilityElement
UtilityElementTraceResult
UtilityNetwork
UtilityNetworkDefinition
UtilityTerminal
UtilityTier
UtilityTraceFilter
UtilityTraceParameters
UtilityTraceResult
UtilityTraceType

About the data

The Naperville gas network feature service contains a utility network used to run the isolation trace shown in this sample. Authentication is required and handled within the sample code.

Additional information

Using utility network on ArcGIS Enterprise 10.8 requires an ArcGIS Enterprise member account licensed with the Utility Network user type extension. Please refer to the utility network services documentation.

Sample Code

PerformValveIsolationTrace.xaml

PerformValveIsolationTrace.xaml.cs

Use dark colors for code blocksCopy
﻿<ContentPage x:Class="ArcGISRuntimeXamarin.Samples.PerformValveIsolationTrace.PerformValveIsolationTrace"
             xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Xamarin.Forms;assembly=Esri.ArcGISRuntime.Xamarin.Forms"
             xmlns:resources="clr-namespace:Forms.Resources;assembly=ArcGISRuntime">
    <RelativeLayout>
        <esriUI:MapView x:Name="MyMapView"
                        BindingContext="{x:Reference Name=ResponsiveFormContainer}"
                        GeoViewTapped="OnGeoViewTapped"
                        Style="{StaticResource MapWithFormStyle}" />
        <resources:ResponsiveFormContainer x:Name="ResponsiveFormContainer">
            <StackLayout x:Name="FilterOptions" Orientation="Vertical">
                <Label Margin="5"
                       FontAttributes="Bold"
                       Text="Choose Category for Filter Barrier:" />
                <Grid>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="*" />
                        <ColumnDefinition Width="auto" />
                        <ColumnDefinition Width="auto" />
                    </Grid.ColumnDefinitions>
                    <Picker x:Name="CategoryPicker"
                            Grid.Column="0"
                            Margin="5"
                            ItemDisplayBinding="{Binding Name}"
                            TextColor="Black"
                            VerticalOptions="CenterAndExpand" />
                    <Button Grid.Column="1"
                            Margin="5"
                            Clicked="OnTrace"
                            Text="Trace" />
                    <Button Grid.Column="2"
                            Margin="5"
                            Clicked="OnReset"
                            Text="Reset" />
                </Grid>
                <StackLayout Orientation="Horizontal">
                    <Label Text="Include Isolated Features" VerticalOptions="Center" />
                    <Switch x:Name="IncludeIsolatedFeatures"
                            Margin="5"
                            IsToggled="False" />
                </StackLayout>
            </StackLayout>
        </resources:ResponsiveFormContainer>
        <ActivityIndicator x:Name="LoadingIndicator"
                           HorizontalOptions="CenterAndExpand"
                           IsRunning="True"
                           IsVisible="True"
                           RelativeLayout.HeightConstraint="{ConstraintExpression Type=RelativeToParent,
                                                                                  Property=Height,
                                                                                  Factor=1}"
                           RelativeLayout.WidthConstraint="{ConstraintExpression Type=RelativeToParent,
                                                                                 Property=Width,
                                                                                 Factor=1}"
                           VerticalOptions="CenterAndExpand" />
        <Grid x:Name="PickerUI"
              HorizontalOptions="CenterAndExpand"
              IsVisible="False"
              RelativeLayout.HeightConstraint="{ConstraintExpression Type=RelativeToParent,
                                                                     Property=Height,
                                                                     Factor=1}"
              RelativeLayout.WidthConstraint="{ConstraintExpression Type=RelativeToParent,
                                                                    Property=Width,
                                                                    Factor=1}"
              VerticalOptions="CenterAndExpand">
            <Grid.RowDefinitions>
                <RowDefinition Height="auto" />
                <RowDefinition Height="*" />
            </Grid.RowDefinitions>
            <Label Grid.Row="0"
                   Margin="5"
                   HorizontalTextAlignment="Center"
                   Text="Choose a terminal for this junction." />
            <ListView x:Name="TerminalPicker"
                      Grid.Row="1"
                      ItemSelected="Terminal_Selected" />
        </Grid>
    </RelativeLayout>
</ContentPage>