Tutorials:4 Using the Mapping Table and GIS Data

From Gsshawiki
Jump to: navigation, search

This tutorial is compatible with:

  • WMS Version 8.1 and later
  • GSSHA Version 3.0b and later

Disclaimer: GSSHA tutorial exercises do not represent real world conditions

Using Land Use Data

So far in our model we have set up uniform roughness and precipitation conditions. Setting up non-uniform precipitation will be covered in a later chapter. We shall now look at setting up spatially varied roughness coefficients. Describing the spatial variability of almost all parameters is done through setting up an index map and a mapping table. The index map is a grid of ID numbers. The ID numbers refer to numbers in the mapping table. Index maps are generic and may apply to any number of tables. Each table lists the name of the index map associated with the table and all the IDs that the index map (should or could) have, along with parameters for the IDs. We will be using a land use GIS file to create the IDs for the index map to be used with the roughness table.

  1. Start from where the previous chapter ended or you can open up the clean_ov project in the Finished_tutorial/clean_ov folder. (If you starting from here, you will notice in the Coverage that Land Use already exists.)
  2. Select File | Open…
  3. Browse to the Landuse folder in the project folder.
  4. Click on jb_luse_poly.shp. Click Open. The shapefile will be added as a GIS layer (not a feature object coverage).
  5. Right-click on Coverages and select New Coverage.
  6. Change the Coverage Type to Land Use. Click Ok.
  7. Make sure the Land Use coverage is the current active coverage by clicking on it in the Coverage list.
  8. Select the jb_luse_poly.shp GIS layer by clicking on it. Notice that this changes the active module to the GIS module.
  9. Select Mapping->Shapes to Feature Objects.
  10. Click yes on when asked to use all shapes in visible shapefile for mapping.
  11. Click Next.
  12. Click Next to accept the default attribute mappings.
  13. Click Finish.

  14. Figure 21. Creating a new coverage in the data tree.

    We now have a land use coverage in WMS. Zoom into the GSSHA™ model area. You can turn off the display of the jb_luse_poly.shp GIS layer by unchecking the box next to it. Using the Select Polygon tool Icon Select Polygon.png double-click a polygon inside the grid. The land use mapping dialog will open. Notice that there are 10 land use types.


    Table 3. USGS Land Use codes. [ref]
    USGS Land Use Codes
    11 Residential
    12 Commercial and Services
    14 Transportation, Communications, and Utilities
    16 Mixed Urban or Built-up Land
    17 Other Urban or Built-up Land
    21 Cropland or Pasture
    41 Deciduous Forest Land
    43 Mixed Forest Land
    53 Reservoirs
    76 Transitional Areas

    Now we can make an index map out of the land use coverage. The index map will be used to describe the spatial variability of roughness values for the simulation.


  15. Switch to the 2D Grid Module Icon 2DGrid.png.
  16. Select GSSHA™ | Maps…
  17. For the coverage use the Land Use coverage. Do not use a second GIS data source.
  18. Change the Index map name to Land Use.
  19. Click on Coverages -> Index Map.
  20. Select Done.

  21. If you expand the 2D Grid part of the Data Tree you’ll notice that there are now two index maps listed, uniform and Land Use. Let’s visualize them as well.


  22. Click on the ‘uniform’ index map in the data tree.
  23. The grid should appear solid red. This is because the uniform map is all ones.

  24. Click on the ‘Land Use’ index map in the data tree.

  25. The grid should now have cells colored in several colors representing the IDs of the polygons that were mapped to the grid cells. Next we will assign the Land Use index map to the roughness table and set up roughness values for each of the IDs in the Land Use index map.


  26. Select GSSHA™ | Map Tables…
  27. Select the Roughness tab if it is not already selected.
  28. Under Using index map choose the Land Use index map.
  29. Click on Generate IDs. Click yes when asked to delete the process’ existing IDs.
  30. Fill out the Roughness values according to the table below. To enter a roughness value for an ID, highlight the surface roughness box below the ID then edit the roughness value. (You may also edit the descriptions if you wish, however you should leave the original polygon ID description as is.)

  31. Table 4. Roughness values corresponding to Land Use
    ID Description Roughness
    11 Land ID #11, Residential 0.08
    14 Land ID #14, Highway 0.07
    21 Land ID #21, Cropland and Pasture 0.35
    41 Land ID #41, Deciduous Forest Land 0.20

  32. Once you are done, select Done.

  33. You can now save the model and run the simulation.



GSSHA Tutorials

GSSHA Tutorial Download Website