Summary :: Usage :: Parameters :: Outputs :: Warnings :: Limitations


Extracts network topology and writes it to the RivEX Workspace. 


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: 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.




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]


The output are 14 files ending with the file name extension "rtd" written to the TopoCache folder in the RivEX workspace.  The RivEX settings file is also updated with the field names of the polyline ID and nodes.  The user may have optionally specified a set of fields to deleted from the layer and this deletion is run before the main topological extraction routine.


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.


  1. If a selection existed on the network this is cleared prior to processing.
  2. The RivEX_Workspace folder must exist before using this tool, you use the Create a RivEX workspace tool to create the workspace.
  3. 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.

Return to top of page