ArcGIS Pro 3.3 API Reference Guide
ArcGIS.Core.Data.UtilityNetwork.Trace Namespace / Propagator Class
Members Example

In This Topic
    Propagator Class
    In This Topic
    Propagator objects allow a subset of NetworkAttribute values to propagate through a network while executing a trace. These values can be tested to allow or disallow further traversal.
    Object Model
    Propagator ClassNetworkAttribute ClassField ClassNetworkAttribute Class
    Syntax
    public class Propagator 
    Public Class Propagator 
    Remarks
    The canonical example is phase propagation- open devices along the network will restrict some phases from continuing along the trace. Propagators are only applicable to subnetwork-based traces (SubnetworkTracer, UpstreamTracer, etc.).
    Example
    Create a Propagator
    // Get a NetworkAttribute object for the Phases Normal attribute from the UtilityNetworkDefinition
    using (NetworkAttribute normalPhaseAttribute = utilityNetworkDefinition.GetNetworkAttribute("Phases Normal"))
    {
      // Create a propagator to propagate the Phases Normal attribute downstream from the source, using a Bitwise And function
      // Allow traversal to continue as long as the Phases Normal value includes any of the ABC phases
      // (represented by the constant ABCPhase)
      Propagator phasePropagator = new Propagator(normalPhaseAttribute, PropagatorFunction.BitwiseAnd, Operator.IncludesAny, ABCPhase);
    
      // Assign this propagator to our trace configuration
      traceConfiguration.Propagators = new List<Propagator>() { phasePropagator };
    }
    
    Inheritance Hierarchy

    System.Object
       ArcGIS.Core.Data.UtilityNetwork.Trace.Propagator

    Requirements

    Target Platforms: Windows 11, Windows 10

    ArcGIS Pro version: 3 or higher.
    See Also