This tool converts XPSWMM models for use in TUFLOW-SWMM using an xpx file exported from XPSWMM. Common XPSWMM parameters are converted. Some attributes will need to be specified manually.
The tool uses the "Convert TUFLOW Model GIS Format" processing tool to convert the 2D portion of the model (if provided), extracts the 1D portion from the xpx file, and modifies the converted model to incorporate SWMM into the TUFLOW model. Most common features are converted in full while some may require manual specification. Some additional processing is done to make the model match TUFLOW-SWMM expectations.
Most common functionalties are supported with some limitations especially for non-SWMM hydrology or some structures. * Nodes - junction, outfalls, and storage * Conduits - including the various shape types including natural channels with transects and custom H-W curves. * Inlets and inlet placement with connections to the 2D. * Weirs and orifices * Pump - The locations currently converted but not pump curves. * Nodal inflows * Inactive geometries are ignored * Subcatchments - Attributes other than area are only brought across currently if using SWMM hydrology. Because the functionalities differ in this area, it is an area where manual conversion may be required. * Boundary condition connections at nodes identified with "Link invert elevation to 2D." HX connections are connected to junction and storage nodes while SX connections are used for outfalls. * Boundary condition curves are stored in a boundary condition database. If using global rainfall, multiple events will be created. Otherwise, the specified default name will be used but the framework allows easy expansion for new events.
The tool does additional model cleanup and preparation including:
1. Cleanup of TUFLOW control files (2D) such as removing or commenting invalid or rarely used options.
2. Snaps BC layers to SWMM nodes which is required because of tolerance differences in XPSWMM generated files.
3. Identifies inactive nodes (may be used in other scenarios).
4. Forces furthest downstream nodes to outfalls (required by TUFLOW-SWMM).
5. Fixes outfalls that have multiple (upstream) links which is not support by SWMM version 5 by adding a dummy link and moving the outfall to the downstream side.
6. Fixes some improper BC setups generally by extending the channel and adding dummy conduits:
' a. Inflows at nodes connected to HX boundaries
' b. Inflows at outfall nodes
' c. SX connections at junction or storage nodes without inlets (HX required for this situation)
The xpx file required for this tool can be exported from XPSWMM or the free XPSWMM Viewer by clicking on the file menu and selecting "Import/Export Data" and then "Export XPX Data" from the secondary menu.
Here is a brief description of the parameters. The parameters used in the "Convert TUFLOW Model GIS Format" may have a more detailed description with that tool.
A TUFLOW model with SWMM connectivity will be added to the output folder.
TUFLOW-SWMM recommended conventions such as storage nodes at HX connections and recommended junction attributes (ymax=0, area of ponding=positive value) are not currently incorporated. It is recommended to modify the input files to enforce these conventions. The processing toolbox has many tools to help enforce these settings.
While careful testing has been done developing and testing this tool, some features may not transfer cleanly. Structures using non-typical shapes (rectangular/circular) should be cross-checked.