Integrating 12d with XPSWMM/XPStorm

12d’s drainage module integrates directly with the XPSWMM/XPStorm interface. This simple transition between packages allows teams to combine the functions of 12d’s terrain and pipe design capabilities with Innovyze’s hydrology and hydraulic assessment tools. The process for exporting the 12d model data to XPSWMM/XPStorm and then taking the results back into 12d is outlined below.

Exporting from 12d and importing to XP

Prepare your 12d drainage model.
Replace the existing swmm.dmf file located in the 12d directory on your computer with the one provided with these instructions (or you can download it here). This file controls the mapping between 12d and XPSWMM/XPStorm and can be edited in a text editor if required.

Note: The swmm.dmf file has been specifically setup for use of Laurenson Method hydrology. Any catchment areas provided in 12d will be split into impervious and pervious areas automatically based on the % impervious specified in 12d. All global data within 12d (such as pit inlet types) that is not setup in XP prior to import will be lost. It is recommended that global databases for the two packages match prior to exchange.
Export the drainage model to an .xpx file for import:
1. Using the Network Drainage Editor, select the network to be exported.
2. Select Import/Export dialog box.
3. Under the I/O Format select XP SWMM from the menu.
Import the .xpx file into your XPSWMM/XPStorm project. If you are starting a new project, you can Create From Template and use the template provided in this folder.
Ensure Global Data is updated to reflect the 12d drainage library (that is, Pit inlet types, infiltration rates exist)
1. Go to Configuration > Global Data.
Import the .xpx file created by 12d:
1. Go to File, Import/Export Data > Import XPX/EPA data.
2. Locate the file from 12d and then click Import.
Import the TIN files from 12d into the XPSWMM/XPStorm project:
1. Right-click the DTM under Topography and select Load XPTIN file.
2. Locate the .tin0 files for the TIN you wish to import.
  
  Note: This will be in the 12d project directory for your specific project and an .xptin file will be created in the same location automatically.
3. Repeat the process for any other TIN files
Running Hydrology
1. Check catchment slopes: slopes from 12d should have automatically been converted to m/m (XPSWMM/XPStorm's default units)
2. Check catchment areas: the catchment areas should have been automatically split from 12d based on %impervious. The three sub-catchments in 12d are exported to XP as per below:
  - 12d sub-catchment 1 - %Imp area goes to XP sub-catchment 1
  - 12d sub-catchment 1 - %Perv area goes to XP sub-catchment 2
  - 12d sub-catchment 2 - %Imp area goes to XP sub-catchment 3
  - 12d sub-catchment 2 - %Perv area goes to XP sub-catchment 4
  - 12d sub-catchment 5 - total goes to XP sub-catchment 5
3. Check that the Routing Method is set to Laurenson in the Hydrology node.
4. Check the Infiltration and Rainfall has come across from 12d.
  
  Note: The infiltration and rainfall data will only come across from 12d if the names were already existing in the XP Global Database before import.
5. Setup the Runoff Job Control for the project.
Running Hydraulics:
1. Select a ponding option for all nodes.
2. Apply loss coefficients to system where required.
  
  Note: Pressure change coefficients will be applied to the downstream links to account for junction losses. The coefficients will be populated automatically if the 12d drainage model had been run prior to export.
3. Setup the Hydraulic Job Control for the project
4. If running xp2D, Setup the 2D Job Control
Solve the model and review.

Exporting from XP and importing to 12d

Once the model has been solved, the updates and resulting HGL can be exported from XPSWMM/XPStorm and brought back into 12d to finalise designs.

Export the XPSWMM/XPStorm project to .xpx.
Import the .xpx file back into 12d using the drainage editor once again.