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


Exports the topological data, extracted by RivEX, into plain text files so that they can be viewed or used in third party applications


RivEX extracts topological information from the river network and stores this in the RivEX workspace TopoCache folder.  Technically they are serialized python dictionaries\lists organising the connectivity of the network in a format that the processing algorithms can use. These serialized data structures are in binary format and thus unreadable.

This admin tool allows you to export the cached data into a plain text file so that they can be viewed. This can be helpful when trying to track down why a tool is generating erroneous values.  Understanding the connectivity as how RivEX "sees it" can help explain the source of a topological anomaly leading to erroneously computed values.

This is a tool for advance users and was primarily constructed for me the developer to understand any errors that arose. This tool has been exposed to RivEX users to allow them to do their own detailed error checking or even import the connectivity information into other 3rd party applications.

Simply select the network of interest, an existing output folder and one or more topology caches then press OK to export.

If you have Open Output Folder after Export ticked on, then for your convenience, RivEX will open Windows File Explorer to the folder you had set as output.




Data type

River Network

The river network.

Feature Layer

Output Folder

The output folder that the plain text files will be written to.


Topo Cache data to export

One of more topo cache files that you wish to export into plain text files.

List [of strings]

Open Output Folder after Export

If this is ticked (default) RivEX will open Windows File Explorer to the location specified by the Output Folder parameter.



The output files have the typical header information shown below then the data. Files that output XY information will have the values semi-colon separated, all other outputs have their values comma separated as shown in the example below.

Node Valency topo export

An example of the typical output of this tool, here you see the Node valency Dictionary exported.


If you have edited the topology of your river network since running this tool then you need to re-run this tool to ensure these files are up to date.

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. This tool is not meant to be run in a scripting environment, it is for you to export cache files to text format, if you need to. Run this tool from toolbox in an active ArcPro session.
  2. You must have run the Extract Network Topology and write to Workspace tool first before you can use this tool.

Return to top of page