Barriers

Barriers are used in traces to define locations where a trace should stop.

There are two types of barriers in a trace network:

  • Feature barriers—Created on a map using the Trace pane or by specifying another feature class to serve as a barrier.
  • Dynamic barriers—Network features that meet criteria defined by a condition or function barrier.

Feature barriers are created by specifying the network features to serve as barriers when configuring a trace. Dynamic barriers allow you to use information about your network features to create barriers.

Feature barriers

Barriers can be created on the Barriers tab in the Trace pane or by specifying a user-defined feature class in the Barriers parameter of the Trace tool.

Feature (or physical) barriers are optional during tracing events. To include them, you use a tool to set areas in your network as barriers for a trace.

Only network features can be used to place barriers with the Trace pane. When a network feature is selected or added to the pane from a selection set, the following are true:

  • A coincident point is created to denote the barrier for the trace.
  • When working with lines, a barrier can be placed anywhere along the edge.

When a barrier is established in the Trace pane, a feature class named TN_Temp_Barriers is created in the project's default geodatabase. Successive feature barriers are appended to this class. To remove all barriers from a map, click the Clear All button Clear on the Barriers tab.

When a user-defined feature class or table is used to supply barriers for the Trace tool, the following should be taken into consideration:

  • The TN_Temp_Barriers feature class is not used with this method.
  • Selection sets on the input feature class are not honored.
  • For polygon features, barriers are placed along the boundary where network features intersect the polygon geometry.
  • When working with an enterprise geodatabase, the following are requirements:
    • The schema of the user-defined feature class must contain a FEATUREGLOBALID field of type guid.
      • The FEATUREGLOBALID field must contain the Global ID of a corresponding network feature to be used as a barrier.
      • Features without a corresponding value are not used to place barriers. This option can be used to provide granularity over which features serve as barriers in a feature class.
    • The schema of the user-defined feature class must contain a PERCENTALONG field of type double to place barriers along an edge feature.
      • The PERCENTALONG field must contain a value between 0.0 and 1.0 to indicate the location of the barrier along the line.
      • If the PERCENTALONG field is not present or does not contain an appropriate value, the trace assumes the barrier is placed on a junction feature and ignores placement along an edge.
  • When working with a single-user geodatabase, the following are requirements:
    • The FEATUREGLOBALID field is not required. When absent, the geometry of the input feature class is used to intersect the network feature's geometry and place barriers.
      • When the FEATUREGLOBALID field is present, it must contain the Global ID of a corresponding network feature to be used as a barrier.
    • The PERCENTALONG field is not required. When absent, the geometry of the input feature class is used to intersect the network feature's geometry and place the barrier.
      • When the PERCENTALONG field is present, it must contain a value between 0.0 and 1.0 to indicate the location of the barrier along a line. If the field is present and does not contain an appropriate value, the trace assumes the barrier is placed on a junction feature and ignores placement along an edge.

Note:

By default, trace results are returned as a selection and include the entire edge feature. When a barrier is placed midspan on an edge, the PERCENTALONG field is used to denote its location along the edge. The Result Types Aggregate Geometry option can be specified to return partial feature results in an output multipart geometry feature class. This result type can also be used to return partial feature results when a function barrier using an apportionable network attribute evaluates to true midspan along a line.

Dynamic barriers

In addition to feature barriers, dynamic (or configurable) barriers can be set on network attributes or function conditions. Dynamic barriers are optional during tracing events

Two types of dynamic barriers are used during a trace: Condition Barriers and Function Barriers. Both types are considered during a trace.

Note:

When using the Include Barrier Features configuration option for barriers placed along an edge, the trace results include the entire feature. The Result Types Aggregate Geometry option can be used to return partial feature results. When a barrier is placed midspan on an edge, trace results stop at the barrier and return partial feature geometry of the edge feature.

Condition barriers

A condition barrier is an expression based on network attributes, for example, to stop at all water bodies that have indeterminate flow in a hydrologic network. When a feature meets the condition set in the expression, the trace operation does not continue to the next feature.

More than one condition barrier can be implemented using the Combine Using parameter (AND or OR).

Function barriers

Function barriers define the extent of a trace based on whether a function condition has been satisfied. Function barriers can be used to do such things as restrict how far a trace travels from the starting point or set a maximum value to stop a trace. For example, the length of each line traveled is added to the total distance traveled. The Add function could be used to set a maximum value, and when the total length traveled reaches the value specified, the trace stops.

Networks often have paths that fork into multiple paths. At times, you may want to consider all forked paths together (global) and at other times consider them as separate paths from one another (local). Using the example of distance along paths in a trail network, if the starting point is placed at a fork with three paths, and the trace is set to trace 3 kilometers down the trails using global values, the trace will travel 1 kilometer down each of the three forked paths. When you enable the Use Local Values option, the trace will travel 3 miles down each of the three forked paths.

More than one barrier type can be used at once. Combining barriers allows you to control a group of diverse, precise types of barriers. Suppose you want to run a trace and have it stop at any disabled line segment, but you don't want the trace to travel more than 500 meters beyond the starting point. To accomplish this, you can use a condition barrier to control the network attribute value that denotes a disabled line that stops a trace, and you can use a function barrier to calculate the length of the line you travel and set a limit of 500 meters.

Function barriers support apportionable situations and return a portion of the function value calculated for a line that has a barrier located midspan. For example, in a stream network, you want a trace to stop once it has traveled 500 meters downstream. The 500th meter may not be at the end of a stream reach, but instead may fall midspan along the stream segment. In this case, the trace stops midspan, but the entire stream segment is considered a barrier. In this scenario, the features returned in the results of your trace can add up to less than 500 meters depending on whether you choose to enable the Include Barrier Features parameter on the Trace tools. Using the aggregated geometry honors the location of starting points and barriers placed midspan on edge features and allows you to return partial feature results that honor configured function barriers.

Note:

When running a trace using a function barrier with the Use Local Values option selected, only one starting point is allowed.

To learn more about setting barriers, see Configure a trace.