Perform valve isolation trace
Run a filtered trace to locate operable features that will isolate an area from the flow of network resources.
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
Create and set the configuration's filter barriers by selecting a category. Check or uncheck 'Include Isolated Features'. Click 'Trace' to run a subnetwork-based isolation trace.
How it works
- Create a
MapView
. - Create and load a
UtilityNetwork
with a feature service URL. - Create a
Map
that containsFeatureLayer
(s) that are part of this utility network. - Create a default starting location from a given asset type and global id.
- Add a
GraphicsOverlay
with aGraphic
that represents this starting location. - Populate the choice list for the 'Filter Barrier: Category exists' from
UtilityNetworkDefinition.Categories
. - Get a default
UtilityTraceConfiguration
from a given tier in a domain network. Set it'sFilter
with a newUtilityTraceFilter
. -
When 'Trace' is clicked,
- Create a new
UtilityCategoryComparison
with the selected category andUtilityCategoryComparisonOperator.Exists
. - Assign this condition to
TraceFilter.Barriers
from the default configuration from step 7. Update this configuration'sIncludeIsolatedFeatures
property. - Create a
UtilityTraceParameters
withUtilityTraceType.Isolation
and default starting location from step 4. - Set its
TraceConfiguration
with this configuration and then, run aUtilityNetwork.TraceAsync
.
- Create a new
- For every
FeatureLayer
in the map, select the features returned byGetFeaturesForElementsAsync
from the elements matching theirNetworkSource.Name
with the layer'sFeatureTable.Name
.
Relevant API
- UtilityCategory
- UtilityCategoryComparison
- UtilityCategoryComparisonOperator
- UtilityDomainNetwork
- UtilityElement
- UtilityElementTraceResult
- UtilityNetwork
- UtilityNetworkDefinition
- UtilityTier
- UtilityTraceFilter
- UtilityTraceParameters
- UtilityTraceResult
- UtilityTraceType
About the data
The Naperville gas network feature service, hosted on ArcGIS Online, contains a utility network used to run the isolation trace shown in this sample.
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.
Tags
category comparison, condition barriers, isolated features, network analysis, subnetwork trace, trace configuration, trace filter, utility network