• InfoWorks ICM

Coupling at banks

Create bank lines and build a bank connection using linear coupling.


Tutorial resources

These downloadable resources will be used to complete this tutorial:

iwcm2023M20U04_Cpl_1D_2D_Riv_Bnks.zip

Step-by-step guide

In ICM, coupling at bank lines connects 1D model objects to multiple 2D element faces. This can occur at either river reach banks or inline bank links, both of which are built from bank line data.

This example creates bank lines for river reach objects and builds a bank connection.

  1. Select Open > Open transportable database.
  2. Navigate to and select the .icmt file.
  3. Click Open.
  4. If a popup displays about opening the database as read-only, click Yes.
  5. Right-click the top-level folder and select Copy.
  6. In the popup, click Continue.
  7. In the Explorer window, right-click the Database and select Paste (with children).
  8. In the Copying pop-up, enable Copy ground models.
  9. Click Continue.
  10. In the Explorer window, double-click 1D/2D River Model to open it on the GeoPlan.
  11. From the Database, drag 1m Ground Model and drop it onto the GeoPlan.

The InfoWorks ICM interface, with the river model and ground model for this example loaded onto the GeoPlan.

Now, import a 2D zone:

  1. From the Network menu, click Import > Open Data Import Centre to open the ODIC.
  2. In the Table To Import Data Into drop-down, select 2D zone.
  3. Under Data Source, ensure the Source Type is set to Raw Shape File.
  4. Click the More () button.
  5. Navigate to and select the .shp file—in this example, 2D Zone.shp.
  6. Click Open.
  7. Under Field Mapping Configuration, click Auto-Map to search the import file for fields that match those defined in the network.

The Open Data Import Center, with settings configured for this example and Auto-Map selected.

  1. Click Import.

An import notification reports the number of imported objects.

  1. Click OK to close the notification.
  2. Close the ODIC.

The 2D zone is imported into the model and is displayed as a green polygon.

In the river model, the imported 2D zone appears as a green polygon.

  1. From the GeoPlan Tools toolbar, click the Selection tool.
  2. On the GeoPlan, double-click the 2D zone to open its Properties window.
  3. Set the Maximum triangle area to 200.
  4. Set the Minimum element area to 20.
  5. Set the Mesh generation to Classic.
  6. Enable Terrain-sensitive meshing.
  7. Set the Maximum height variation to 0.2.
  8. Set the Roughness (Manning's n) to 0.04.

The Properties window for the 2D zone, with Polygon definition settings configured for this example.

With these changes made, the mesh can be generated:

  1. Make sure the 2D Zone is still selected on the GeoPlan.
  2. From the Model menu, select Meshing > Mesh 2D zones.

The expanded Model menu with Meshing selected, and in the flyout, Mesh 2D zones selected.

  1. From the Database, drag the 1m Ground Model into the Mesh 2D Zones dialog box and drop it into the Ground Model group box.
  2. Click OK to mesh the 2D zone.

In the Mesh 2D Zones dialog box, 1m Ground Model appears in the Ground Model group box, and OK is selected.

  1. In the Schedule Job(s) dialog box, click OK.
  2. From the Window menu, select Job control window to display the status of the mesh job.

Once the mesh is complete, it can be loaded into the model.

  1. From the Job Control window, click the Mesh ready status to open the Manage mesh results window.
  2. Click Load mesh.

In the Job Control window, the Mesh ready status is highlighted in red, and in the Manage mesh results dialog box, Load mesh is being selected.

  1. Click Close.
  2. Inspect the 2D mesh to see how the terrain sensitive meshing has affected the element sizes in different areas of the model.

It may be helpful to adjust the Ground Model theme to see the mesh better.

  1. Right-click the GeoPlan and select Properties & themes.
  2. On the Layers and Themes tab, for the Ground Model object layer, in the Theme column, click Edit.

The GeoPlan Properties and Themes dialog box, with Edit highlighted in the Ground Model row; and in the background, terrain-sensitive meshing applied to the model, but only slightly noticeable on the dark ground model.

  1. In the Layers and Themes Editor, Map Type drop-down, select Ground Model – Transparent.

The Layers and Themes Editor, with the Map Type drop-down expanded and Ground Model – Transparent selected.

  1. Click OK.
  2. Click OK again to close the GeoPlan Properties and Themes dialog box.

Notice that the 2D zone extends beyond the river model. This is because this downstream area is complex and best represented in 2D.

  1. From the Windows toolbar, expand the Grid windows drop-down and select New links window.

In the Windows toolbar, the Grid windows drop-down expanded with New links window selected, and on the GeoPlan, the model with visible terrain-sensitive meshing and the 2D zone extending beyond the river model.

  1. At the bottom of the grid window, select the River reach tab to view data for the seven river reaches.

Note that the Left 2D zone ID and Right 2D zone ID columns are blank. Currently, if a simulation were run on the model, there would be no exchange of flow.

The links grid window, with the blank Left 2D zone ID and Right 2D zone ID columns highlighted in red, and the River Reach tab also highlighted in red.

To connect the bank lines to the 2D zone:

  1. Click the top left of the grid to select all the river reaches.
  2. From the Model menu, select River reach > Build bank connections.

In the Model menu, River reach selected, with Build bank connections selected in the flyout; and in the background, the grid with all river reaches selected and highlighted.

The Left 2D zone ID and Right 2D zone ID columns now display “2D”, the name of the 2D zone imported earlier.

In the grid window, the Left 2D zone ID and Right 2D zone ID columns now display “2D” for all river reaches.

  1. Close the grid window.

To help visualize the bank lines in the model:

  1. Right-click the GeoPlan and select Properties & themes.
  2. In the GeoPlan Properties and Themes dialog box, switch to the Elements tab.
  3. Under 2D elements, for Bank edges, click the More () button.
  4. In the Bank Edges Color dialog box, select red.
  5. Click OK.
  6. Back on the Elements tab, set the Width to 3.

The GeoPlan Properties and Themes dialog box, Elements tab, with Bank edges set to red and a Width of 3, and OK selected.

  1. Click OK.

At this point, there are no bank connections, as the mesh needs to be regenerated.

  1. With the 2D zone selected on the GeoPlan, select Model > Meshing > Mesh 2D zones.
  2. In the Mesh 2D Zones dialog box, click OK.
  3. In the Schedule Job(s) dialog box, click OK.
  4. Once the mesh is complete, from the Job Control window, click the Mesh ready status to open the Manage mesh results dialog box.
  5. Click Load mesh.
  6. Select Close.

Note that the bank lines are correctly connected to the 2D zone, highlighted by the red bank edges.

On the GeoPlan, the river network with bank lines correctly connected to the 2D zone, highlighted by the red bank edges.

  1. Click Validate to make sure there are no errors in the network.
  2. In the Network Validation dialog box, click OK.
  3. Click Commit changes to database to save changes.
  4. Add a comment, such as "Added 2D zone and connected the banks".
  5. Click OK.

The 1D-2D river network is now coupled along the banks.