XPSWMM to TUFLOW-SWMM Troubleshooting

This page is a work in progress. Please contact support@tuflow.com for assistance.

Introduction

This page contains alternate methods for XPSWMM to TUFLOW SWMM conversion and outlines common conversion issues and steps to troubleshoot them.

Model Conversion Without a XPSWMM License

This guide outlines the steps for converting a XPSWMM model to TUFLOW SWMM without a valid XPSWMM license. Please note that this process is not recommended and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact support@tuflow.com.

If you have access to the XPSWMM Viewer but do not have a valid XPSWMM license, you can export the XPX data from the XPSWMM model. However, exporting the DTM data and 2D model files directly from the XPSWMM model is not possible. See section below**. To export XPX data, please follow the instructions provided, Export XPX Data From XPSWMM.

Without a valid XPSWMM license and access to the XPSWMM Viewer, you will not be able to export the XPX data, DTM data, or the 2D model files directly from the XPSWMM model. See section below **.

Locate Essential Files

Without a XPSWMM license, it is impossible to export data from a XPSWMM model directly. Instead, the best alternative is to locate the files generated during the last run of the XPSWMM model.
If you do not have access to these files, please contact support@tuflow.com for assistance.

Search through the XPSWMM files for the following:

1. Exported XPX data file: Look for a file with a .xpx extension.
2. TUFLOW control files: Files such as .tgc', .tbc, .tcf, etc. They are typically found in the 2D/Data folder, although their location may vary depending on the XPSWMM model settings.
3. Grid file: A grid file with a .tif, .flt or .asc extension.
4. 2D model files: These files are in MapInfo (.mif/.mid) or ShapeFile (.shp) format and they contain the model data. They are typically found in the 2D/Data folder.

Actions based on located files:

Files Located	Possible Steps
XPX data file	Use the Convert - XPSWMM model from XPX processing tool. This will convert only the 1D data from the XPSWMM model.
TUFLOW control files 2D model files Grid file	Use the Convert TUFLOW Model GIS Format processing tool to convert the XPSWMM model into TUFLOW format. Carefully review the output to ensure all data has been converted correctly. Some steps in the XPSWMM to TUFLOW SWMM Archive process may be useful. Note: This process can be done without a grid file, but the converted TUFLOW model will not include one. If possible, try to locate the model's grid file or create a new one.
XPX data file TUFLOW control files (in particular .tcf) Grid file	Proceed with the main conversion process, Convert XPSWMM Model to TUFLOW SWMM. Note: This process can be done without a grid file, but the converted TUFLOW model will not include one. If possible, try to locate the model's grid file or create a new one.

Common Conversion Issues

XPX Tool

Some conversion messages may be addressed/resolved by completing the Recommended Additional Conversion Steps.

There are different levels to the conversion messages. An Error will abort the Convert - XPSWMM model from XPX tool and therefore may not generate a convert_messages.gpkg. There will be a description of the error in the tools log. Both Warnings and Checks will not abort the conversion process, and they will both be reported in the convert_messages.gpkg and the tools log. A Warning is more severe then a Check, however both messages should be reviewed to determine the cause.