Extract Network Topology and write to Workspace
Summary :: Usage :: Parameters :: Outputs :: Warnings :: Limitations
Summary
Extracts network topology and writes it to the RivEX Workspace. It will also add to the river network layer three new fields: RivID, Fnode and Tnode. If these fields already exist then a numeric suffix is added (e.g. RivID_1).
Usage
This tool attempts to extract a variety of topological information from the river network and store these as serialized objects in the RivEX workspace Topo cache folder.
The philosophy behind this tool is to assume that any existing attribution in the network (e.g. node ID's) can potentially be wrong, so to ensure successful execution of RivEX tools this tool builds the topological information from first principles and ignores any attribution. This means the tool adds to the river network three new fields of type Long: RivID, Fnode and Tnode, if they already exist a numeric suffix is added (e.g. RivID_1). The names of these new fields are written to the RivEX Settings file.
The topological information written to the Topo cache file are in binary format, if you wish to view them or even use the data in a third party software you can export the data to plain text file using the Admin tool Export Topo cache files to Text.
The user can optionally specify a set of fields to deleted from the layer and this deletion is run before the main topological extraction routine. You would typically use this option after you have corrected errors identified by the quality control tools and need to remove redundant topological\attribution fields.
Parameters
Name |
Help |
Data type |
River Network |
The river network to extract and store topological information from. For best results the network should be within a File GeoDatabase. |
Feature Layer |
Fields to delete |
A parameter to allow you to select a set of fields to be removed from the network dataset BEFORE the main topological extraction routine. This is an optional processing step. |
List of [Fields] |
Outputs
The output are 14 files ending with the file name extension "rtd" written to the TopoCache folder in the RivEX workspace. The River network and RivEX settings file are also updated with the field names of the polyline ID and nodes (RivID, Fnode and Tnode).
Warnings
It is not unusual to run this tool multiple times on the same network, especially when resolving errors identified by the quality control tools. This will result in duplicating fields with near identical names\values and RivEX ignoring any previous ID and node fields it had created. It is good practise to delete these redundant fields to ensure optimal performance. An optional parameter allows you to select a set of fields to be removed from the network dataset BEFORE the main topological extraction routine.
With the release of ArcGIS Pro 3.2.1 a switch control appears on parameters that accept tables\feature classes, do not interact with it! More advice here.
Limitations
- If a selection existed on the network this is cleared prior to processing.
- The RivEX_Workspace folder must exist before using this tool, you use the Create a RivEX workspace tool to create the workspace.
- This tool is not meant to be run in a scripting environment, use it to build the latest topology from your river network. Run this tool from toolbox in an active ArcPro session.