XPSWMM to TUFLOW-SWMM Troubleshooting - Revision history

Emilie Nielsen at 05:27, 26 August 2024

2024-08-26T05:27:55Z

← Older revision		Revision as of 15:27, 26 August 2024
Line 1:		Line 1:
	<font size=3>'''This page is a work in progress. Please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for assistance. ''' </font>		<font size=3>'''This page is a work in progress. Please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for assistance. ''' </font>
			= Introduction =
			This page provides extra guidance for converting a XPSWMM model to TUFLOW SWMM. For the full conversion process, see <u>[[XPSWMM_to_TUFLOW-SWMM\|XPSWMM to TUFLOW SWMM]]</u>.

	= Model Conversion Without a XPSWMM License =		= 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 <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.		This guide outlines the steps for converting a XPSWMM model to TUFLOW SWMM without a valid XPSWMM license. Please note that this process is <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.

Emilie Nielsen: /* Model Conversion Without a XPSWMM License */

2024-08-26T05:24:34Z

Model Conversion Without a XPSWMM License

← Older revision		Revision as of 15:24, 26 August 2024
Line 3:		Line 3:
	This guide outlines the steps for converting a XPSWMM model to TUFLOW SWMM without a valid XPSWMM license. Please note that this process is <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.		This guide outlines the steps for converting a XPSWMM model to TUFLOW SWMM without a valid XPSWMM license. Please note that this process is <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.

	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 <u>[[~~section~~ below**]]</u>. To export XPX data, please follow the instructions provided, <u>[[XPSWMM_to_TUFLOW-SWMM#Export_XPX_Data_From_XPSWMM \|Export XPX Data From XPSWMM]]</u>.		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 the <u>[[XPSWMM_to_TUFLOW-SWMM_Troubleshooting#Locate_Essential_Files\|Locate Essential Files]]</u> section below. To export XPX data, please follow the instructions provided, <u>[[XPSWMM_to_TUFLOW-SWMM#Export_XPX_Data_From_XPSWMM \|Export XPX Data From XPSWMM]]</u>.

	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 <u>[[~~section~~ ~~below~~ **]]</u>.		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 the <u>[[XPSWMM_to_TUFLOW-SWMM_Troubleshooting#Locate_Essential_Files\|Locate Essential Files]]</u> section below.

	=== Locate Essential Files ===		=== Locate Essential Files ===

Emilie Nielsen: /* Common Conversion Issues */

2024-08-26T05:21:34Z

Common Conversion Issues

← Older revision		Revision as of 15:21, 26 August 2024
Line 50:		Line 50:
	:* 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.		:* 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.

	The information provided in the processing tool log and/or the messages GeoPackage should be sufficient for identifying the location and cause of the issue(s) in the TUFLOW model. The <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u> are applicable to the most common conversion issues. For other issues, some sections of the <u>[[XPSWMM_to_TUFLOW-SWMM_Archive\|XPSWMM to TUFLOW SWMM Archive]]</u> process may be helpful. If the issue(s) ~~persist~~, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for further assistance.		The information provided in the processing tool log and/or the messages GeoPackage should be sufficient for identifying the location and cause of the issue(s) in the TUFLOW model. The <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u> are applicable to the most common conversion issues. For other issues, some sections of the <u>[[XPSWMM_to_TUFLOW-SWMM_Archive\|XPSWMM to TUFLOW SWMM Archive]]</u> process may be helpful. If the issue(s) persists, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for further assistance.

Emilie Nielsen: /* Common Conversion Issues */

2024-08-26T05:21:07Z

Common Conversion Issues

← Older revision		Revision as of 15:21, 26 August 2024
Line 44:		Line 44:

	= Common Conversion Issues =		= Common Conversion Issues =
		⚫	Any issues that may have occurred while running the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool will be documented in the '''*_convert_messages.gpkg'''. This file is located in the '''TUFLOW/model/swmm''' folder of the converted TUFLOW model. Drag and drop this GeoPackage into QGIS and turn on labels to view any conversion messages and their locations.
	== 'Convert - XPSWMM model from XPX' Processing Tool ==

⚫	Any issues that may have occurred while running the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool will be documented in the '''*_convert_messages.gpkg'''. This file is located in the '''TUFLOW/model/swmm''' folder of the converted TUFLOW model. Drag and drop this GeoPackage into QGIS and turn on labels to view any conversion messages. ~~There~~ ~~are~~ ~~different levels to the~~ ~~messages:~~
			There are different levels to the messages:
	:* An 'Error' will abort the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool and therefore may not generate a '''*_convert_messages.gpkg'''. However, there will be a description of the error in the tools log.		:* An 'Error' will abort the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool and therefore may not generate a '''*_convert_messages.gpkg'''. However, 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.		:* 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.

	~~Some~~ ~~conversion~~ messages ~~may~~ be ~~addressed~~ by ~~completing~~ the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.		The information provided in the processing tool log and/or the messages GeoPackage should be sufficient for identifying the location and cause of the issue(s) in the TUFLOW model. The <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u> are applicable to the most common conversion issues. For other issues, some sections of the <u>[[XPSWMM_to_TUFLOW-SWMM_Archive\|XPSWMM to TUFLOW SWMM Archive]]</u> process may be helpful. If the issue(s) persist, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for further assistance.

Emilie Nielsen: /* Introduction */

2024-08-26T05:10:40Z

Introduction

← Older revision		Revision as of 15:10, 26 August 2024
Line 1:		Line 1:
	<font size=3>'''This page is a work in progress. Please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for assistance. ''' </font>		<font size=3>'''This page is a work in progress. Please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u> for assistance. ''' </font>
	= Introduction =
	This page contains alternate methods for XPSWMM to TUFLOW SWMM conversion and outlines common conversion issues and steps to troubleshoot them.<br>

	= Model Conversion Without a XPSWMM License =		= 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 <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.		This guide outlines the steps for converting a XPSWMM model to TUFLOW SWMM without a valid XPSWMM license. Please note that this process is <u>not recommended</u> and may result in issues with the converted TUFLOW model. For assistance with converting a XPSWMM model without a license, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.

Emilie Nielsen: /* Common Conversion Issues */

2024-08-26T05:10:22Z

Common Conversion Issues

← Older revision		Revision as of 15:10, 26 August 2024
Line 53:		Line 53:

	Some conversion messages may be addressed by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.		Some conversion messages may be addressed by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.


			{{Tips Navigation
			\|uplink=[[XPSWMM_to_TUFLOW-SWMM\| Back to XPSWMM to TUFLOW SWMM Conversion Page]]
			}}

Emilie Nielsen: /* Common Conversion Issues */

2024-08-26T05:07:30Z

Common Conversion Issues

← Older revision		Revision as of 15:07, 26 August 2024
Line 48:		Line 48:
	= Common Conversion Issues =		= Common Conversion Issues =
	== 'Convert - XPSWMM model from XPX' Processing Tool ==		== 'Convert - XPSWMM model from XPX' Processing Tool ==
			Any issues that may have occurred while running the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool will be documented in the '''*_convert_messages.gpkg'''. This file is located in the '''TUFLOW/model/swmm''' folder of the converted TUFLOW model. Drag and drop this GeoPackage into QGIS and turn on labels to view any conversion messages. There are different levels to the messages:
			:* An 'Error' will abort the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool and therefore may not generate a '''*_convert_messages.gpkg'''. However, 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.

		⚫	Some conversion messages may be addressed by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.


⚫	Some conversion messages may be addressed~~/resolved~~ by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.

	There are different levels to the conversion messages. An Error will abort the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> 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.

Emilie Nielsen: /* Model Conversion Without a XPSWMM License */

2024-08-26T04:41:43Z

Model Conversion Without a XPSWMM License

← Older revision		Revision as of 14:41, 26 August 2024
Line 32:		Line 32:
	\|XPX data file \|\| Use the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool. This will convert only the 1D data from the XPSWMM model.		\|XPX data file \|\| Use the <u>[[QGIS_SWMM_Convert_XPSWMM_Model_From_XPX\|Convert - XPSWMM model from XPX]]</u> processing tool. This will convert only the 1D data from the XPSWMM model.
	\|-		\|-
	\|TUFLOW control files <br> 2D model files <br> Grid file \|\| Use the <u>[[Convert_TUFLOW_Model_GIS_Format\|Convert TUFLOW Model GIS Format]]</u> 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 <u>[[XPSWMM_to_TUFLOW-SWMM_Archive\|XPSWMM to TUFLOW SWMM Archive]]</u> process may be useful~~. <br>		\|TUFLOW control files <br> 2D model files <br> Grid file \|\| Use the <u>[[Convert_TUFLOW_Model_GIS_Format\|Convert TUFLOW Model GIS Format]]</u> processing tool to convert the XPSWMM model into TUFLOW format. <br>
			Prior to using the tool, the references within the TUFLOW control files must be updated. As XPSWMM uses absolute file paths, if your XPSWMM model is in a different folder location to where it was run originally, all the references will be incorrect. To fix this, update the commands in each control file to have relative file path references. For example, <br>
			: <tt><font color="blue">Output Folder </font><font color="red">== </font>C:\XPSWMM_XPX_to_TUFLOW_Conversion\XPSWMM\2D\Output</tt>
			: becomes...
			: <tt><font color="blue">Output Folder </font><font color="red">== </font>..\Output</tt><br>

			Carefully review the output to ensure all data has been converted correctly. Some steps in the <u>[[XPSWMM_to_TUFLOW-SWMM_Archive\|XPSWMM to TUFLOW SWMM Archive]]</u> process may be useful. <br>

	'''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.		'''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.
	\|-		\|-

Emilie Nielsen: /* Common Conversion Issues */

2024-08-26T04:26:42Z

Common Conversion Issues

← Older revision		Revision as of 14:26, 26 August 2024
Line 40:		Line 40:

	= Common Conversion Issues =		= Common Conversion Issues =
	== XPX Tool ==		== 'Convert - XPSWMM model from XPX' Processing Tool ==



	Some conversion messages may be addressed/resolved by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.		Some conversion messages may be addressed/resolved by completing the <u>[[XPSWMM_to_TUFLOW-SWMM#Recommended_Additional_Conversion_Steps\|Recommended Additional Conversion Steps]]</u>.

Emilie Nielsen: /* Model Conversion Without a XPSWMM License */

2024-08-26T04:24:35Z

Model Conversion Without a XPSWMM License

← Older revision		Revision as of 14:24, 26 August 2024
Line 38:		Line 38:
	'''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.		'''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.
	\|}		\|}
	<br>

	= Common Conversion Issues =		= Common Conversion Issues =