Running Geometric Network Traces

Network Tracing

ArcFM Web's tracing tools are accessed through a toolbar that must be configured by an administrator. Information on toolbar configuration is available in the VertiGIS Studio Web Designer Help. Your toolbar may differ from the examples in this document. The following toolbar is an example of the way a tracing toolbar could be configured.

NOTE: Ensure that the relevant features are in your map service before performing a trace. For example, if your map service does not contain Dynamic Protective Devices, a Protective Device trace will return inaccurate results.

Perform a Geometric Network Electric Trace

Open the Electric Traces menu on the Toolbar.
Click on the desired trace type. A checkmark appears in the upper corner to indicate it has been selected. The Trace Options pane displays on the left of your browser.
Click the arrow next to Trace Options to expand the trace options list if it is not already expanded. Set the desired options for your trace. For example, for an Upstream Protective trace, check or uncheck the desired Protected Devices.
To start the trace, click on the map at the desired location. This places a marker at the start point and executes the trace. Results are highlighted on the map and tabular results are displayed in the bottom half of the browser.
Use the Clear Trace icon to remove the flag and trace results from the map.
To change the trace type and run a new trace, first click the current trace type to turn it off, and then click the new trace type to turn that one on.

Geometric Network Electric Traces

The following tools are available on this sample geometric network Electric Tracing toolbar.

Icon	Trace	Description
	Electric Traces	Click this button to view the Electric Traces toolbar. Select the type of trace you want to run to display the Trace Options The following options are available to configure the Trace Options in the Start Point dock pane: Phases to Trace – Choose the phase option you want from the drop-down. The trace returns all features that contain the selected phases. Protective Devices – Check the checkbox for each device to be included in a protective device trace. This option affects only protective device traces. Return Complex Edges – When this box is checked, the trace returns complex edges as opposed to simple edges. Include Junctions - Check this box to include junctions in the trace results. Include Edges - Check this box to include edges in the trace results. Trace Tolerance – An integer value that determines how close the user must click, in map units, to the feature they want to trace on for it to be selected for tracing. The value defaults to 20 and can be set to any positive number.
	Upstream Trace	Finds all lines and devices in a feeder system that are upstream of the trace flag. Features are found by phase. This trace requires Feeder Manager to be configured in the geodatabase. NOTE: Upstream trace is phase sensitive. An edge is included in the trace results if it is a necessary component of any path that brings the specified phases from a source to the flagged feature. The edge itself carries all of the specified phases.
	Downstream Trace	Finds all lines and devices in a feeder system that are downstream of the trace flag. Features are found by phase.
	Next Upstream Protective Device Trace	Finds the first protective device upstream of the flag. Devices are found by phase. The trace stops at the first protective device it encounters. Use the Trace Options dialog to include specific features. This trace returns a transformer only if the voltage varies from one side of the transformer to the other. NOTE: This trace is phase sensitive, but it does not respect the Phases To Trace options in the Trace Options window. It traces all phases present on the flagged feature.
	Upstream Protective Device Trace	Finds all protective devices upstream of the flag. Devices are found by phase. The trace stops at the circuit source. Use the Trace Options dialog to include specific features.
	Downstream Protective Device Trace	Finds all protective devices downstream of the flag. Devices are found by phase. The trace stops at an open switch. Use the Trace Options dialog to include specific features.
	Protective Device Isolation Trace	Identifies features that interrupt the flow of electricity. NOTE: This trace is phase sensitive, but it does not respect the Phases To Trace options in the Trace Options window. It traces all phases present on the flagged feature. When running this trace, it is possible to return an empty results set. This occurs when the area cannot be isolated.
	Clear Trace	Removes the trace flag and the trace results from the map view.

Perform a Geometric Network Gas Trace

To perform a gas trace, perform these steps.

Open the Gas Traces menu on the Toolbar.
Click on the desired trace type. A checkmark displays in the upper corner to indicate it is selected. The Trace Options pane displays on the left of your browser.
Set the desired options for your trace. Multiple temporary marks are placed and then selected or deselected at will.
To start the trace, click the desired location on the map. A marker is placed at the start point and executes the trace. Results are highlighted on the map and tabular results are displayed in the bottom half of the browser.
Click the Clear Trace button to remove the flag and trace results from the map.
To change the trace type and run a new trace, click the current trace type to turn it off, then click the new trace type to turn on the different trace type.

Note: Water traces for a geometric network function the same as gas.

Geometric Network Gas Traces

The following tools are available on this sample geometric network Gas Tracing toolbar.

Icon	Trace	Description
	Gas Traces	Click this button to view the Gas Traces toolbar. Select the type of trace you want to run to display the Trace Options. The following trace options are available to configure: Select the Isolation Trace Barriers – Critical values only, or all valves. Select the Pressure Trace Barriers. The All Regulators option stops the trace at a regulator, regardless of its pressure. Return Complex Edges – When this box is checked, the trace returns complex edges as opposed to simple edges. Include Junctions - Check this box to include junctions in the trace results. Include Edges - Check this box to include edges in the trace results. Trace Tolerance – An integer value that determines how close the user must click, in map units, to the feature they want to trace on for it to be selected for tracing. The value defaults to 20 and can be set to any positive number.
	Cathodic Protection Trace	Cathodic protection is used in natural gas distribution systems to prevent corrosion of pipes and devices. A gas Cathodic Protection trace identifies the sections of your distribution system that utilize cathodic protection.
	Pressure System Trace	A pressure system is a section of the entire gas distribution system that is operating under the same pressure. Regulators are placed between pressure systems as separators. Regulators can be set between two pressure systems that are operating under the same pressure. In this case, the regulator does not separate the systems, and they are viewed as one continuous pressure system. If the pressure is modified on either side of the regulator, it becomes a system separator, and the pressure system should be re-traced.
	Valve Isolation Trace	Identifies features that interrupt the flow of gas. NOTE: When running this trace, it is possible to return an empty results set. This occurs when the area cannot be isolated.
	Clear Trace	Removes the trace flag and the trace results from the map view.
	Exclude Valve	Marks a valve on the map that should be excluded from the valve isolation trace. An Exclude Gas Valve marker is placed when a user clicks a valve on the map. Marked valves are listed by FacilityID under the Excluded Valves section.
	Include Valve	Marks a non-critical valve on the map that should be included in the valve isolation trace when the Critical Valve option is checked. An Include Gas Valve marker is placed when a user clicks a valve on the map. Marked valves are listed by FacilityID under the Included Valves section.
	Squeeze Offs	Places a temporary shutoff point as a barrier. The Valve Isolation trace treats a temporary shutoff point as a potentially-closed device and may include it in the results. A Pipe Squeeze Off marker (red plus sign) is placed when the user clicks a pipe on the map. Marked squeeze offs are listed by FacilityID under the Squeeze Offs section. Note the following about how temporary squeeze-off points affect the ArcFM Gas Valve Isolation Trace: If squeeze-off points isolate an area, the trace highlights the isolated area. The trace does not look beyond squeeze-off points that are not fed by a source. If you place a flag on an edge that contains a squeeze-off point, the trace returns no results.
	Temporary Source	Designates a gas pipe as a temporary source due to line pack. In most cases, the pipe is on a distribution main. A Gas Temporary Source marker is placed when the user clicks a pipe on the map. Marked temporary sources are listed by FacilityID under the Temporary Sources section.
	Clear Temporary Marks	Clears all temporary marks on the map. To clear an individual temporary mark, select the mark's type from the toolbar and click the mark to remove it.

Geometric Network Water Traces

The following tools are available on this sample geometric network Water Tracing toolbar.

Icon	Trace	Description
	Show Water Trace Options	The following options are available to configure: The following trace options are available to configure: Select the Isolation Trace Barriers – Critical values only, or all valves. Select the Pressure Trace Barriers. The All Regulators option stops the trace at a regulator, regardless of its pressure. Return Complex Edges – When this box is checked, the trace returns complex edges as opposed to simple edges. Include Junctions - Check this box to include junctions in the trace results. Include Edges - Check this box to include edges in the trace results. Trace Tolerance – An integer value that determines how close the user must click, in map units, to the feature they want to trace on for it to be selected for tracing. The value defaults to 20 and can be set to any positive number.
	Cathodic Protection Trace	Cathodic protection is used in water distribution systems to prevent corrosion of pipes and devices. A water Cathodic Protection trace allows you to identify the sections of your distribution system that utilize cathodic protection.
	Valve Isolation Trace	Identifies features that interrupt the flow of water. NOTE: When running this trace, it is possible to return an empty results set. This occurs when the area cannot be isolated.
	Clear Trace	Removes the trace flag and the trace results from the map view.
	Exclude Valve	Marks a valve on the map that should be excluded from the valve isolation trace. An Exclude Water Valve marker is placed when a user clicks a valve on the map. Marked valves are listed by FacilityID under the Excluded Valves section.
	Include Valve	Marks a non-critical valve on the map that should be included in the valve isolation trace when the Critical Valve option is checked. An Include Water Valve marker is placed when a user clicks a valve on the map. Marked valves are listed by FacilityID under the Included Valves section.
	Squeeze Offs	Places a temporary shutoff point as a barrier. The Valve Isolation trace treats a temporary shutoff point as a potentially-closed device and may include it in the results. A Pipe Squeeze Off marker (red plus sign) is placed when the user clicks a pipe on the map. Marked squeeze offs are listed by FacilityID under the Squeeze Offs section. Note the following about how temporary squeeze-off points affect the ArcFM Water Valve Isolation Trace: If squeeze-off points isolate an area, the trace highlights the isolated area. The trace does not look beyond squeeze-off points that are not fed by a source. If you place a flag on an edge that contains a squeeze-off point, the trace returns no results.
	Clear Temporary Marks	Clears all temporary marks on the map. To clear an individual temporary mark, select the mark's type from the toolbar and click the mark to remove it.