Tracing Tools

  Network Trace

The Network Trace tool allows the user to determine which pipes, valves or parcels will be affected if a network is interrupted within the context of water/sewer utilities. Water/Sewer network tracing starts from a selected pipe and traces to find the connected nodes and pipes that would be affected if something were to happen to the selected pipe.

 

For this network trace to function select the water/sewer pipe or node to perform a network trace on. Click the Network Trace button. A side pane will open displaying various options according to the type of pipe that has been selected.

 

Network Tracing is also now available for Fiber utilities, which incorporates powerful capabilities for the end user and becoming extremely beneficial for organizations in a modern-day context. Fiber network tracing can start with a Fiber node, Fiber Cable or Cable Route and work through the network to display desired results, based on the trace option selected. For this network trace to function select the Fiber node to perform a network trace on.

 

Note: Different trace options will appear for water, sewer and fiber network traces.

 

To change the Selected results to display after a trace was run select the same water or sewer object/s from the map and select the Network Trace function from the enlighten toolbar. Select the desired results to display from the Selected results to display options and run the trace again.

 

Once a network trace has been run you can switch between water and sewer traces by selecting either water or sewer objects without selecting the Network Trace function again. Alternatively refreshing the map, without making any selections, would inevitably bring up the Fiber network trace pane. The various water, sewer and fiber trace options will be discussed below:

Water Pipe Network Tracing

If a water pipe is selected the user can choose to perform either a:

  • Pre Calculated Trace: Switch on/off the availability of using pre-calculated shut-off block trace result.
  • System Trace: Only the selected section of the network will be subjected to a network trace.
  • Full Trace: All the sections of the network that do not have any other source of supply will be selected when a full trace is conducted.
  • Part Trace: The trace will stop when the closed or nearest valve has been reached. The trace will traverse the network in all directions from a given point of failure/leak and calculate the valves that will define a Shut Off block.

 

Before running the trace, the user can choose which layers will be displayed in the Water Pipe Trace Results window. If the service connection table contains both parcel GID and property GID data, the user can choose to see either the affected parcels or the affected properties in the result window:

  • Affected Water Pipes
  • Affected Pipe Volume
  • Affected Valves
  • Affected Service Connections
  • Affected Parcels or Properties



    Fig: Water Network Trace

 

After the initial water pipe trace has been conducted an option appears that is called Trace Through. The Trace Through option should be used if a valve cannot be physically closed for any reason (rusted/covered).

 

The user can select the offending valve on the map and trace through that valve. This option will re-calculate and extend the trace to exclude that valve from the network trace. To stop a trace prematurely you can select a ‘Stop Predicate’.

Sewer Pipe Network Tracing

The Sewer Network Tracing function provides the ability to perform different types of trace from a graphically selected sewer pipe. The user can choose to perform an upstream or downstream trace.

  • Upstream Trace: All the pipes and parcels which have service connections connected to the pipes that flow to the selected pipe will be found.
  • Downstream Trace: All the pipes and parcels which have service connections connected to the pipes that flow from the selected pipe will be found.

 

The user defines what layers will be displayed in the Sewer Pipe Trace Results by checking or unchecking the display boxes:

  • Affected Sewer Pipes
  • Affected Pipe Volume
  • Affected Service Connections
  • Affected Parcels or Properties



    Fig: Sewer Network Trace

 

If the sewer service connection table contains both parcel GID and property GID data, the user can choose to see either the affected parcels or the affected properties in the result window. To stop a trace prematurely you can select a ‘Stop Predicate’.

Stop Predicates

The enlighten administrator has the ability to define Stop Predicates in the administration section of enlighten for sewer and water network traces.

 

Stop predicates are described as a condition at which the trace is forced to terminate prematurely if a certain condition is satisfied during the trace. In the instance of enlighten, a stop predicate may be an access point of a particular type, a change of pipe diameter, or a specific valve type, etc. The purpose of stop predicates is to find information using network trace functionality, without performing a standard network trace, i.e. when a stop predicate is selected, the valves and water sources etc. will be ignored and the stop predicate condition will be searched for.

 

The Trace direction is only triggered once the number of max pipes is set and will run bi-directional traces. If the Maximum number of pipes is set to NULL then the trace will run with default value of 250 pipes, and the resultant trace will still run bi-directionally. If the Trace number of pipes is entered, then the other parameters are not necessarily ignored since the trace result depend on the data on the map and on the parameter values entered in the Stop Predicate.

 

By default, the stop predicate condition for a network trace is None, meaning that no stop predicate will be used in the trace.

 

To define a stop predicate the user simply selects a predefined Stop Predicate condition from the drop-down list and sets the condition requirements.

 

Note: When a stop predicate is selected, the default network trace behavior is overwritten.



Fig: Stop Predicate Options

 

When the user selects either a Pipe or Node as a Stop Predicate, the system dynamically updates the referenced table and generates the SQL with the first column of the table being highlighted in the where clause. If the new column being specified has no lookup assigned to it, then it will revert to a free text input box.

 

Manually entering a value within double quotes will return a SQL error as the system is not configured to tolerate it. Using the keyword “SAME” or “same” would default the variable to the selection from the database column being referenced.

 

If a numeric value is entered in the SQL dialog, then it is not validated if a lookup value list is displayed. Ordinarily one would select the value in the lookup table, and it would be automatically pasted into the SQL dialog. Manually entering a value in the SQL dialog would be done if for some reason the lookup table was not populated with that value.

 

A Stop Predicate can be applied to a Water or Sewer Network Trace and can be defined for pipes or nodes.

  • Trace number of pipes: The number defined in this section defines the number of pipes to trace through if the predicate condition is not met. For a water trace this is the number of pipes in both directions, and for a sewer pipe trace it is the number of pipes in a single direction.
  • Maximum number of pipes: This field is the highest priority in the stop predicate. When a number is entered in this field it disables every other predicate condition. For a water trace, this is the number of pipes in both directions and for sewer pipes trace it is the number of pipes in a single direction.

 

A Function lookup has also been added to qualify the predicate condition. Some Oracle functions have been made available via lookup table EN_TRACE_FUNCTIONS:

  • Left Trim: Removes all leading spaces.
  • Right Trim: Removes all trailing spaces.
  • Lower Case: Removes all trailing spaces.
  • Upper Case: Removes all trailing spaces.
  • To Number: Removes all trailing spaces.
  • NT_CONV_VAR2NUM: Removes all trailing spaces.

 

To define a stop predicate the user simply selects a Stop Predicate condition from the drop-down list and sets the condition requirements.

Network Trace Results

After performing a Network Trace, the user can choose to view or save the information retrieved. A tabular output of the network trace results can be accessed by selecting the Show Report link on the Network Trace Result dialog. The results are then shown in the standard enlighten ‘Advanced Form’. The columns displayed on the Advanced form are pre-defined by the enlighten administrator.

 

Network Trace results are saved using the ‘Shut Off Reporting’ or ‘Selections’ functionality

Load From File

If a pipe selection was saved to a file, this can be retrieved and traced on by selecting the Load from File option. Preloading map selections before running a trace will override the trace package. The selections need therefore to contain Pipes and Nodes for Water trace and Pipes only for Sewer. Other objects included in the selection will be ignored.

 

Note: Non-Return Valves (also called Check Valves) are processed during network tracing in the following manner. When the tracing process reaches such a node through a pipe, it checks if the node rests at the start point of the coming pipe. This is true when the START_NODE of the coming pipe has a value equal to the NODE_ID of the node. In such a case the tracing goes through the node as if it does not exist. Otherwise, when the END_NODE of the coming pipe is equal to the NODE_ID of the node, the tracing stops at that node.

Sewer Pipe Trace Example

To conduct a sewer pipe trace, first select a sewer pipe then click the network trace/tool. A side pane will appear on the right-hand side of the screen once selected and the following prompts can be used to conduct a sewer pipe trace.

 

To start a trace:

  1. Select the direction of the trace Upstream or Downstream.
  2. Select the layers to be displayed in the results.
  3. Select whether to have the pipe volume displayed in the results.
  4. Alternatively, select a Stop Predicate (set up by the administrator).



    Fig: Sewer Pipe Network Trace Dialog Box

  5. The Network Trace results are displayed on the map and the Sewer Trace Results window will appear as shown below.



    Fig: Results from Sewer Pipe Network Trace Analysis

 

The map will be zoomed to the extent of the trace results and the Affected Pipes and Parcels are highlighted and selected. The number of Pipes Affected and/or Service Connections and/or Properties/Parcels Affected is shown as part of the Sewer Pipe Trace Results.

 

The Add/Remove Parcel/Service option provides the ability to add or remove one or more objects from the trace selection. The user can continue adding or removing objects to/from the trace selection until the Stop option is clicked. If the selection set is lost, it can be retrieved by selecting the Redraw Selections option.

 

Further information pertaining to Adding/Removing Parcels/Properties/Buildings can be found within the enlighten Administrators guide under the Configure Settings section > Network Trace > Service Connection Linking.

 

Further reporting is available by clicking on the Show Report link. To save the results please refer to ‘Shut Off’ reporting or ‘Selections

Water Pipe Trace Example

If a water pipe has been selected, the Water Network Trace Settings set up side pane will appear. If a pipe selection was saved to a file, this can be retrieved and traced on by selecting the Load from File option.



Fig: Water Pipe Network Trace Dialog Box

 

To start a trace:

  1. Choose to do a Pre Calculated, System Trace, Full Trace or Part Trace. The Full Trace is the default and will automatically include in the trace all the sections of the Network with no other source of supply, Part Trace will isolate the network to the closest valves in each direction (the trace will stop when the nearest node defined as valve has been reached.
  2. Select the required results (Affected Water Pipes and/or Affected Valves and/or Affected Service Connections and/or Affected Properties or Parcels).
  3. Select whether to have the pipe volume displayed in the results.
  4. If a Stop Predicate is selected, this will override the tracing package.
  5. The Network Trace results are displayed on the map and the Water Pipe Trace Results window will appear as shown below.



Fig: Results from Water Pipe Network Trace Analysis

 

The map will be zoomed to the extent of the trace results and the affected objects highlighted along with the pipe volume if that option was selected.

 

The Add/Remove Parcel/Service option provides the ability to remove one or more objects from the trace selection. The user can continue adding or removing objects to/from the trace selection until the Stop option is clicked. If the selection set is lost, it can be retrieved by selecting the Redraw Selections option.

 

Trace Through functionality is only available in water network trace and allows continuing the trace through a selected valve to the next one. This option is used, for example, when a valve cannot be closed or is broken, and the operator needs to identify the next nearest one.

 

The process for tracing through a valve is:

  1. From the Water Trace Results dialog, click on the Trace Through button.
  2. Click on an Affected Valve on the map. These are indicated as red squares on the map.

 

If an affected valve is not selected, a message dialog will be displayed saying Please select an Affected Valve to trace through.



Fig: Results from Water Pipe Network Trace Through

When an Affected Valve is selected, the program will perform the re-trace and then display the new result set on the map. The Water Pipe Trace Results in the right pane is updated with the number of Valves, Pipes, Parcels, and Services affected. The Trace Through can be repeated until the user is satisfied with the extent of the trace. For each trace, the Water Pipe Trace Results in the right pane is updated.



Fig: Results from a secondary Water Pipe Network Trace Through

Water Pipe Stop Predicate Example

If a water pipe has been selected, the Water Network Trace Settings set up side pane will appear. If the Stop Predicate option is selected, the parameters are displayed in the side pane for user configuration. For this example, the following Stop Predicate parameters have been set.

  1. Set the Stop Predicate by selecting Pipe Diameter from the drop-down list.
  2. Set the Trace number of pipes to trace 3 water pipes.
  3. The Where Clause is partially set based on the the Pipe Diameter selection above, however you will need to set the Pipe Diameter criteria, for example, select the greater than operator > , and select a pipe diameter from the available drop-down list, for example 140.
  4. Set the Maximum number of pipes to only trace 5 pipes, remembering this field is the highest priority in the stop predicate.



Fig: Water Pipe Network Trace Dialog Box with Stop Predicate parameters

 

The results of the Water Pipe trace after applying the Stop Predicate are displayed in the Water Pipe Trace Results section on the side pane, and the affected Parcels, Pipes, Service Connections and Valves (based on the Selected Results to display) are all highlighted in the map.



Fig: Water Pipe Trace Results after applying the Stop Predicate

The affected Parcels, Pipes etc. can be viewed in Advanced Forms if these have been defined. If the Map Layer count is displayed in black, it indicates there is an Advanced Form defined.



Fig: View Water Pipe Trace Results in Advanced Forms

The Affected Parcel records displayed in the Advanced Form can be exported to a csv file for reporting purposes.



Fig: Affected Parcel records displayed in the Advanced Form can be exported to a csv file

The Affected Parcels csv file can be imported into Excel and saved as a spreadsheet.



Fig: Import csv file into Excel

Network Trace (Manual Mode)

When the user runs a Network Trace in Manual Mode, then the system is manipulated into returning the results only of what the user manually selected before running the trace. Network trace can be run in Manual Mode, for both the Water and Sewer utilities.



Fig: Network Trace Manual Mode

 

To start a Network Trace in manual mode:

  1. Select the relevant Pipes/Valves and Property/Building/Parcels, which is desired to be outputted. (selecting 2 pipes and a valve also triggers manual mode).
  2. Click on the Network Trace Icon.
  3. Select whether to have the pipe volume displayed in the results.
  4. If a Stop Predicate is selected, this will override the tracing package.
  5. The Network Trace results are displayed on the map and the Water Pipe Trace Results windows will appear as shown below. These results will be the initial Pipes/Valves the user selected prior to running the Trace.

 

Note: When conducting a Network Trace in Manual Mode then the option to define the Trace type is greyed out.

Fiber Network Tracing

The Fiber Network Tracing function provides the ability to perform different types of traces from a Fiber selection made on the map. As long as fiber layers have been configured in the Network Trace Admin page, having nothing selected on the map will bring up the common route trace.

 

The various Fiber Network Trace options are:

  • Optical Time Distance Reflectonomy (OTDR): Select a relevant Fiber Node and then the Route > Cable > Tube > Strand carrying a service, enter in a distance and then the system should highlight the associated Route and Path. Important attribute information is also displayed on the screen of the map view, near the associated feature and on the right hand side task pane.
  • Break Trace: Select a Fiber Cable / Cable / Tube / Strand and once a trace is done, the route and path is highlighted, and activates an advanced form. On this form important information pertaining to services attached to the strand are displayed.
  • Common Route Trace: This trace selects a commonality between two cable routes, an overlap between the both. As with the Break, trace, the Common Route Trace also activates an advanced form.

Optical Time Distance Reflectonomy (OTDR) Trace

The OTDR trace provides enlighten users the ability to locate the point along a fiber path where a significant event or anomaly has occurred. The user must have performed a physical OTDR trace to characterize the optical fiber utilizing appropriate instrumentation and provide a distance where the event or anomaly occurs. The user must select the source node that the OTDR instrumentation has been utilized. The result of the OTDR trace in the enlighten application will show the physical location of the selected interruption with consideration of slack loops and vertical distances. The interruption point is provided within a given tolerance.

 

To start an OTDR Trace:

  1. Select a Fiber Room or Fiber Joint node from the map.
  2. Select the Network Trace icon in the enlighten toolbar.
  3. The trace defaults to the OTDR trace option if a Fiber Room or Fiber Joint node is selected. The Fiber Network Trace task pane is auto-populated with the connecting Cable Routes, Cables, Tubes and Strands for the selected node.
  4. Input the trace distance required, or accept the default of 10m.
  5. Select the Fiber Strand containing the service by expanding and selecting the expansion boxes from Route level down through the Cable and Tube level and select the desired Strand by ticking the check-box adjacent to the desired Strand.


    Fig: OTDR Node Selection

  6. Once the Strand is selected, click on the Trace button.



    Fig: OTDR Trace Criteria

     

  7. The OTDR Fiber Network Trace results are displayed in the Fiber Network Trace task pane.



    Fig: OTDR Trace Results

  8. Selecting the option Zoom to Path option will zoom the map to a scale of 1:1000 and display the Fiber Path at the center of the screen.
  9. Selecting the option Zoom to Fault option will zoom the map to a scale of 1:1000 and display the Fiber Fault at the center of the screen.

Break Trace

The Break Trace indicates to enlighten users the start point of a fiber cable, the end point and also what services are running on the fiber cable. By using this trace option, the user would be required to expand the tube of interest, and thereafter expand the actual strand. The user would then be able to see the relevant service which is attached to the fiber strand. Once the trace has been successfully completed, then the advanced form would pop, with important information pertaining to the service attached to the fiber strand.

 

To start a Break Trace:

  1. Select a Fiber Cable from the map.
  2. Select the Network Trace Icon from the toolbar.
  3. The Fiber Network Trace task pane is auto-populated with the selected Cable Tubes and Strands. Select the relevant Cable > Tube > Strand containing the service. This selection can be at Cable level, Tube level or at Strand level.
  4. Click on the Trace button.



    Fig: Break Trace Criteria

  5. The Advanced Form will open, containing associated results.



    Fig: Break Trace Result

Common Route Trace

The Common Route trace enables enlighten users to identify the cables that interact with a given service identifier. This enables the user to identify the cables of interest when analyzing an event that has occurred potentially reducing the time required to resolve network impact.

 

To start a Common Route Trace:

  1. Select the Network Trace icon from the toolbar.

    Note: When conducting a Network Trace in Manual Mode then the option to define the Trace type is greyed out. When results are returned only the Pipes/Valves info will be returned.

  2. Enter in the relevant Service IDs.
  3. Click on the Trace button.



    Fig: Common Route Trace Criteria

  4. The Advanced Form should open, containing associated results.



    Fig: Common Route Trace Results

Network Trace Error Messages

If enlighten does not have any layers configured for network traces, the following message will be displayed if the Network Trace icon is selected.


Fig: Error Message when no Network Trace Layers are configured

 

If enlighten only has Fiber layers configured for network traces, the following message will be displayed if the Network Trace icon is selected and no objects, or the incorrect objects are selected in the map.


Fig: Error Message when only Fiber Network Trace Layers are configured

 

If enlighten only has Sewer/Water layers configured for network traces, the following message will be displayed if the Network Trace icon is selected and no objects, or the incorrect objects are selected in the map.


Fig: Error Message when only Sewer/Water Network Trace Layers are configured

 

If enlighten has Fiber and Sewer/Water layers configured for network traces, the following message will be displayed if the Network Trace icon is selected and no objects, or the incorrect objects are selected in the map.


Fig: Error Message when Fiber and Sewer/Water Network Trace Layers are configured

 

  Shut Off Report

The Shut Off reporting tool  is located on the main toolbar.

 

Two options are available in the Shut off reports tool you can either save a new report or update an existing report. To open save report click the reports tool with features selected in the map. To enter the update report tool there must be nothing selected on the map.

 

When the ShutOff function is being executed on a Water pipe and the user clicks on a Sewer pipe in the map, then the task pane will change to reflect the relevant associated map feature. The consistent fields amongst these two features will maintain the user inputted data, however some fields will still need to be filled in.

Save Report

To save a new report you must first have at least one service connection selected on the map. Save report is often used after selecting multiple features using ‘Network Trace’ or other spatial functions.

 

The following information must be entered in the Save Report window:

  • The Report Type which in this case is Shut Off.
  • If the event is Planned or Unplanned.
  • The Event Type or Cause what is the problem with the pipe? The options include burst, hydrant, leak, other, service and valve.
  • The Service Request Number that is a unique numerical identifier for the event.
  • The Event Time the event occurred (e.g. 12:00 pm)
  • The Event Date the event occurred (DD/MM/YYYY), which can be selected from a date picker.
  • The Duration of the event (whole minutes).
  • The Event Description for the event.
  • The Water Category type abandoned, portable, raw, reclaim or all if the network does not have a specific category value.
  • Additional Remarks where further comments can be made.

 

The user is required to enter in a Service Request Number before generating the report. If the user attempts to run a Shut Off Report without a Service Request Number assigned, the system will flag an error. The error message displayed will be: Shut-Off not saved. Request Number cannot be null.

 

The user would also have to ensure that a unique Service Request Number is specified. If the user enters an existing Service Request Number to be saved when generating a new report then the following error message will be returned: Shut-Off not saved. Record already exists with the same service request: X (X being the actual service request number).



Fig: Save Shut Off Report Side Pane

 

After entering the required information, it is optional to Set a Event Point. To do this, click on the Create Event Point button and then the cursor will change. The operator then must click on the map on or near a pipe or node. When a point on the map has been clicked a pre-set symbol (created by the enlighten administrator) will appear on the map to mark the spot.

 

Note: The X marker is a temporary object on the map and will not reappear if the window were subsequently refreshed.



Fig: Event Point

 

When the user hits Create Event Point, then the following message will be displayed:

"Processing. Please Wait".

 

Thereafter Event was saved to the database will appear on the bottom of the Save Report pane.

 

Note: The job number is what you will be able to see when you select a job in the update reports section.



Fig: Event Saved to Database

 

If colored parcels have been configured by your enlighten administrator they can be viewed by clicking the refresh button on the map toolbar.

Update Report

To enter the Update Report side pane, click on Shut Off Reports without anything selected on the map.



Fig: Update Report Side Pane

 

Note: If additional report types and event types are required then the user should create those within the ‘Unknown’ type.

 

The details previously saved can be selected using the drop-down list in the Job No section. The jobs will be displayed by Job No in ascending order.



Fig: Saved Jobs

 

Once a job is selected, the form will automatically populate, and the map will zoom to the saved features.

 

If the details originally entered were not correct or have changed, they can be edited. To do this select the desired job, make the changes and click on the Update button.

 

Please contact the enlighten administrator for instructions of how to retrieve the saved event details. These can be displayed in a Shut Off event layer or extracted from the database in a tabular format.

Shut Off Report in Edit Mode

If nothing is selected on the map and the user clicks on the Shut off function, then the Update Report pane will be loaded (same as updating an existing job). This mode allows the user to update a report which has already been saved. If the shutoff is planned then it is updated later when the actual effects are known such as parcels added / removed and actual time taken.

  enMerge

The enMerge tool allows the user to merge together the network trace, shut off report and plotting functions leaving the plot engine to handle the production of mail-merge letters. If you click on the enMerge tool with no selections on the map the following window will appear. Three workflows are available to the user.

Shut Off Report with Network Trace

The workflow is activated when a sewer/water pipe is selected on the map and the user wishes to do a network trace, Shut Off and an optional plot.

Shut Off Report

The workflow is activated when a sewer/water service connection is selected on the map. The user is presented with the choice for an optional plot.

Prefilled Shut Off Jobs

Use this workflow to open a future Shut Off job, whose details have already been filled. The user has the choice to plot the Shut Off job if needed.



Fig: enMerge Work Flows

Workflow 1 Shut Off Report with Network Trace

Running a network trace requires an eligible pipe to be pre-selected on the map. Click on the enMerge tool and select Shut Off Report with Network Trace. When the network trace is finished and its results are selected on the map as illustrated below, enMerge will immediately invoke the second workflow Generating a new Shut Off report. For more information see ‘Network Trace’.



Fig: Trace Workflow Example

Workflow 2 Generate a New Shut Off Report

Creating a new Shut Off requires as a minimum that service connections are selected on the map. This is satisfied if a trace was run previously or if the user had manually performed the selections. After the form is filled in and saved (refer to the illustration below) the Plot button (which should now be enabled) can optionally be clicked to generate a plot which is displayed in its own window in a PDF format. The user can then save the plot information. For more information see ‘Shut Off Report’.



Fig: Shut Off Workflow Saved and Ready to Plot

Workflow 3 Choose a Prefilled Shut Off Report

An alternative to workflows 1 or 2 is to have no selections on the map. The shut off form will include a new lookup to allow selection of a previously saved job (or event) as illustrated below. When you choose a saved job, the map will zoom to the saved features and the form will auto-populate. Any details can be changed once you have selected a job, including the event point. Plotting can then proceed as per work flow 2 above. For more information see ‘Shut Off Report’.



Fig: Pre-Filled Shut Off Selection and Update

Workflow 4 enMerge Plot

Once you have your report information saved and ready to use you can select to plot. Plots are configured by your enlighten administrator and vary between organizations. Please see ‘enPlot’ for more information about plotting options.

Spatial Tools

The Spatial Function tools allow the user to detect spatial interactions between map objects as well as saving and loading spatial selections.

  Nearest Neighbour

The Nearest Neighbour tool , located in the main toolbar, allows the user to identify a set number of neighbouring objects within a set distance of a selected map feature. To activate the Nearest Neighbour function, first, select a map feature or multiple features on the map window and then click the Nearest Neighbours button. A side pane on the right-hand side of the screen will prompt for the following information:

  1. The target layer to perform the Nearest Neighbour search on.
  2. The maximum distance to the selected object.
  3. All distance sets unlimited distance (number limit applies).
  4. The maximum number of objects to be retrieved.
  5. All number sets an unlimited number (distance limit applies).
  6. After typing in the required information, click on Show. The features matching the selected criteria will be highlighted on the map.

Note: The results of this spatial query can be viewed and saved using the Selections Tool.

  Spatial Functions

The Spatial Functions tool , located in the main toolbar, allows the user to identify all map features on a specified layer that are adjacent to one or several selected map features.

 

To activate the Spatial Functions, first, select one or more map features from the map window and click the Spatial Functions button.

 

A side pane on the right-hand side of the screen will ask you to choose the target layer and the spatial function. The type of feature selected will appear in red text and the target layer will appear in blue text.



Fig: Spatial Functions Popup Window

 

Spatial functions available include:

  • Touching: The Touching function will select the items from the target layer that share a border with the selected object. This does not include items within the object or overlapping the selected object.


    Fig: Touching Spatial Function

  • Any Interaction: The spatial function Any Interaction will show features with relationships including within, equals, overlapping and touching. The red boxes in the diagram represent the selected map objects.


    Fig: Any Interaction Spatial Function

  • Contains: The Contains button is designed to find what the selected feature lies within. The red box in the diagram represents the selected feature.


    Fig: Contains Spatial Functions

  • Overlapping: The Overlapping spatial function will highlight the selected target layer that overlaps the selected item on the map.


    Fig: Overlapping Spatial Functions

  • Equals: The Equals spatial function can be used to find duplicate items on separate layers.


    Fig: Equals Spatial Functions

  • Inside: The Inside spatial function will highlight the information inside the item selected on the map from the layer chosen in the ‘select target layer’ drop-down box. The red box represents the item selected on the map.


    Fig: Inside Spatial Function

  • Outside: The Outside spatial function is used to find all items outside the selected item on the layer defined in the select a target layer dropdown box. If few objects are selected this tool takes some time to run.


    Fig: Outside Spatial Function

Note: The results of a spatial query can be viewed and saved using the Selections Tool.

  Spatial Summary

The Spatial Summary tool displays a polygon summary and a line summary in the right-hand side pane. The polygon summary includes the number of polygons selected, the total area and the sum of perimeters. The line summary includes the number of lines selected and the total length of the lines.



Fig: Spatial Summary Side Pane