BASINS2: Using the NPSM Model

Prepared by Ann Quenzer, Dr. Neal Armstrong, and the USEPA

 

 

Table of Contents

Goals of the Exercise 

This exercise is structured after the EPA BASINS Training Workshop for BASINS2 training. 

This exercise will familiarize the user with the tools available in BASINS. The first two parts of the exercise use the tutorial included with the BASINS CD-ROM. The tutorial shows how the delineation tool and NPSM model works. The following exercise will walk you through the delineation of Onion Creek in Texas. The final exercise will run the NPSM model on the Onion Creek Watershed. For your reference, Onion Creek is a tributary of the Colorado River which is located in the south end of Austin, TX. The objective of the model is to determine the overland flow and fecal coliform contributions to Onion Creek from the watershed. The general goals of using the NPSM model is to perform hydrologic and water quality simulations. 

Computer and Data Requirements

 ArcView 3.0a and BASINS2 software are needed for the exercise. The data needed for the exercise is included in the Basins directory on the C:\ drive of the computer. It is also downloadable from the EPA Internet Site: http://www.epa.gov/OST/BASINS/.

 Three computers in the last row of room 3.400 in the LRC are setup with ArcView 3.0a and BASINS2. There is also one computer set up in room 3.402 in the LRC and one computer at CRWR. If you would like the software installed on your computer at home, the BASINS software is downloadable through the EPA Internet site (http:\www.epa.gov/OST/BASINS).

The computer requirements needed to run the BASINS software are listed below:

Computer Pentium w/ CD-ROM
RAM 32 MB
Free disk space 400 MB for an average State
Operating System Windows 95 or Windows NT
GIS software ArcView 30.a 

If you are running WindowsNT you will need a special build.apr file in order to run the system.

 Watershed Delineation Tutorial

Using the Windows Start button, click on the Programs icon which will lead you to the Windows NT Explorer program. Click on the Windows NT Explorer icon. Click on the C: drive icon. Click on the Basins folder. Click on the Tutorial folder. Click on the Tutor icon. Click on the Delineate a Watershed button. Watch the show. Click on the Exit button when you are finished unless you are going directly on to the NPSM tutorial. In that case, go directly to the ** in the next section.

NPSM Tutorial

Using the Windows Start button, click on the Programs icon which will lead you to the Windows NT Explorer program. Click on the Windows NT Explorer icon. Click on the C: drive icon. Click on the Basins folder. Click on the Tutorial folder. Click on the Tutor icon. **Click on the Run NPSM Model button. Watch the show. Click on the Exit button when you are finished

Getting Started

Using the Windows Start button, click on the Programs icon which will lead you to the Basins program. Click on the Basins icon. Open the project called texas.apr.

In order to get the texas.apr project, a data extraction must be done along with the build program. These two process are explained in the BASINS users manual. They are not discussed in this exercise due the time involved.

** Immediately save the project to a directory of your own with a unique name.**

The BASINS program saves to its own folder as the default. This means that other people have access to your files which are created while you work. You will not have the option to save most of your data files else where, but you will have the option to save your project to where you want it. This will partially secure your project as you own. The reason for this is because the version of BASINS that we are using is still in Beta format and some of the bugs have not been worked out.

Watershed Delineation

The major steps required for watershed delineation consist of the following:

 To begin the Watershed Delineation: (You may want to take note of the questions you need to answer before you start.) 

  1. Activate the Basins View.
  2. Display and activate the Cataloging Unit Boundary theme by clicking the box and the name of the theme.
  3. Use the query builder in the Theme menu to locate Cataloging Unit (CU) # 12090205. Zoom to the selected features using this button .
  4. Unselect the Cataloging Unit once it has been located by using the "Clear Selected Feature" tool .
  5. Display and activate the Reach File, V1 theme.
  6. Use the query builder to locate Onion Creek (Pname is the field). Zoom in closer to the selected features while making sure you can still see part of the east and west boundaries of the CU.
  7. Unselect Line Creek.
  8. Select CU # 12090205 by activating the theme and using the Select Feature tool (The watershed delineation will be performed within this cataloging unit�s boundaries).
  9. Depress the watershed delineation button (denoted by a "W") to create a name for the watershed being delineated.
  10. Use yourname.shp as the name. Remember to save it in a directory of your own.
  11. NOTE: your soon-to-be created watershed name is listed at the top of the themes list. Also, a dashed box appears around the checked box next to the new watershed�s theme name. This dashed box notifies you that your watershed is in "editing" mode. To create the watershed outline, the watershed must be in "editing" mode. If you are not in "editing" mode, simply depress "W" again.

  12. Begin to create the outline for the watershed at CU # 12090250's boundary by clicking the mouse. (Be sure to click at a point just outside of the CU boundary. I recommend using the west, east and southern boundaries of the CU be used and you only create the north boundary of the new watershed. Another point of interest, is to not include any of the Colorado River in the watershed you are delineating. This will cause problems when trying to run the NPSM module.)
  13. Complete one segment of the outline by moving the cursor, hereby drawing a segment, and clicking the mouse a second time.
  14. Repeat this point-and-click process until the entire watershed outline is developed. Best results are produced by an "out-and-back" procedure, i.e. delineate in the direction of the tributary�s mouth (on one side of the tributary) and return to the CU boundary (on the other side of the tributary).
  15. Finish the watershed outline at the same CU boundary you started from, by double-clicking the mouse outside of the CU..
  16. Once the watershed has been delineated successfully, it is represented by a visible outline.
  17. When prompted to continue subwatershed delineation, select NO. YES would be selected if multiple subwatersheds were to be delineated.
  18.  NOTE: It is likely that the watershed outline you delineated does not follow the actual boundary of the watershed too well. As a consequence, it may be necessary to clean the initial delineation. Be sure the yourname.shp theme is active, and click on the BASINS cleaning tool (denoted by a "C"). Create a box enclosing a segment of the delineated watershed�s outline. Click YES to delete the line. Once the line has been deleted, the previously-delineated watershed disappears. When prompted to continue cleaning, click NO. Re-delineate the watershed as described in previous steps. When you are prompted to export watersheds, select NO. This saves your new delineation to the .shp file already created for your watershed (yourname.shp). Selecting YES would enable you to create an additional .shp file for the re-delineated watershed (under a different name).

After successfully delineating the watershed for Onion Creek, locate the weather station in closest proximity to the delineated watershed. Weather stations are represented by the WDM Weather Stations theme. You may have to zoom out to find the WMD nearest to Onion creek.

Answer the following questions:

  1. Turn in a picture of the watershed you delineated.
  2. What is the name of the closest weather station? (Use the identify tool)_____________
  3. (Be sure to take note of its name, as it will be used for NPSM modeling.)

  4. What is the total area of the watershed?(Use the identify tool - area is m2)?________
  5. What are the types of land uses found in the watershed?_______________

NOTE: The Watershed Report Generator can be run for land uses in the watershed. This was done for an entire cataloging unit in the introduction to BASINS exercise. Now do it for the watershed you delineated.

Using NPSM

 

The following steps are performed within the NPSM interface and are required for an NPSM simulation:

 To run the NPSM model: (You may want to take note of the questions you need to answer before you start.)

  1. Activate the Basins View.
  2. Add in the shape file called onion.shp from the directory c:\basins\modelout using the Add Theme tool.
  3. Activate the NPSM Data Loading Window, and highlight the BASINS Watershed option. Click OK.
  4. NOTE: This will be similar to the watershed you delineated in the previous section. However, to make everyone and everything consistent, we will all use the same watershed. As you can tell, the delineation tool is a downfall to the BASINS program because of its independence of the elevation of the land. It is possible to run the NPSM model using the entire cataloging unit, however we have limited data and time. There are also tools that can be used to delineate the watershed using digital elevation data. The watershed could then be imported into the BASINS program as we just did.

  5. Activate the Onion Creek Watershed by using the Select Feature tool .
  6. Run NPSM from the MODEL menu and save the model run as yourname. This will create a directory in c:\basins\modelout in which all of the model output will be saved.
  7. When prompted to View/Modify the default % perviousness, select YES. These values will be applied to the watershed being modeled.
  8. Change the percent pervious value to 100% pervious for the Unclassified landuse from 0%.
  9. Select 1993 as the discharge year for point source loading.
  10. Look at the BASINS views produced while preparing the data for the NPSM model. This appears an instant before the NPSM interface appears. You will have to make the BASINS interface active to view the output.
  11. Once the NPSM interface screen appears, create a new project by selecting the button on the far left side of the toolbar .
  12. Choose the yourname.wsd file, in order to load data for the selected watershed into your new project.
  13. When the "Trapezoidal Import Data Review" window appears, change the slope value from -9999.0000 to 0.0018 (be sure to press the enter key after typing in this value).
  14.  Discussion of this information will follow in an appendix.

  15. Select the REACH EDITOR button (denoted by a stream network ), and select the REACH CHARACTERISTICS button from the list of selections.
  16. Check to make sure there are no -9999.00 00 values in any of the fields. Use your engineering judgment to change the values, if needed.
  17.  Again, discussion of information in these tables will follow in an appendix.

  18. Click OK and then DONE when finished editing the reach information.
  19. Select the SIMULATION TIME button .
  20. Select the reg06.wdm file containing meteorological data for the state of Texas by depressing the browse button, denoted by "�".
  21. Enter a simulation time period of 01/01/1980 (00) - 12/31/1983 (24).
  22. Assign the weather station closest to Onion Creek to the watershed being modeled using the pulldown menu.
  23. In the Unselected Watershed Box, double click on Onion Cr to select it.
  24. Click OK.
  25. Select the LANDUSE EDITOR button .
  26. NOTE: The table lists all PERLND and IMPLND segments and their respective areas, as they will be represented by the model. Values in this table were transferred directly from the watershed delineated for Onion Creek.

    NOTE 2: Changes can be made to landuse areas if necessary. Click OK when finished.

  27. Select the NPSM CONTROL CARDS button . This section displays the names of all NPSM modules.
  28. Activate the ATMP, PWATER, and PQUAL modules for Pervious land.
  29. For Impervious land segments, select ATMP, IWATER and IQUAL.
  30. Also select the HYDR, ADCALC, and GQUAL modules for the Reaches.
  31. NOTE: These modules are necessary for performing hydrologic and water quality functions.

  32. Click OK and Close when finished.
  33. Then depress the POLLUTANT SELECTION button, , and select "Fecal Coliform, #/100ml" from the pollutant list as the pollutant for water quality simulation.
  34. In the Pollutant List, highlight the pollutant Fecal Coliform, #/100ml.
  35. Click the Left Arrow button. Click OK.
  36. Since there are no point sources in the watershed, the point source button, , will not be needed.
  37. Depress the DEFAULT DATA ASSIGNMENT button .
  38. Browse for available default files by clicking on the "�" button, and choose the initial.def default data file.
  39. Depress the LOAD ALL button to load all data available in the default file into your present simulation.
  40. NOTE: This action essentially checks to see if any default data for landuses in your watershed are contained in the default data set (by comparing landuse names). If any data exists in the default file for your landuse types, it is automatically assigned to your landuses. If any landuses are not assigned data from the default file (i.e. if data for a particular landuse is not available in the default data set), a warning will appear. In this situation, it is necessary to manually assign data from a similar landuse or reach (in the default set) to the landuse or reach being modeled. Use the Right Arrow button to perform this function. A problem I found with the initial.def is that there is no data for pollutants other than nitrate, ammonium and fecal coliforms. Also, the default.def file is outdated.

    NOTE 2: that reach information from the default data set is automatically assigned to reaches being modeled. This is independent of the reach name.

  41. Assign the Pasture Land default data to the unassigned landuse by highlighting Pasture Land in the "Available Data" list and highlighting Range Land in the "Actual Land Unit" list.
  42. Then click the ASSIGN TO button.
  43. NOTE: Rangeland then appears in the "Assigned Land Units" list with the automatically-assigned landuses (Forest Land, Agricultural Land, and Urban Land).

    NOTE2: The manual assigning you just performed was only for the pervious land units, because the "Pervious Land" radial button is selected. Also select the "Impervious Land" and "Reach" radial buttons to be sure default data has been assigned for all impervious land units and reaches.

  44. Also, depress the POLLUTANT ASSIGNMENT button and be sure that Fecal Coliform has been assigned default values.
  45. Click CLOSE when you are done.
  46. Select the INPUT DATA EDITOR button (denoted by a calculator ).
  47. PERLND, IMPLND, and RCHRES module names are initially visible.
  48. READ APPENDIX!! The data groups and their sub-groups are set up in a tree-like structure. Double-clicking on a module name results in the listing of data groups within the module. Double-clicking on a data group name results in the listing of additional data groups within the chosen data group, or a listing of parameters associated with the data group. Actual parameter names are not denoted with a "+" symbol. Explanation of all the parameters are located in the appendix. 

  49. Depress the "Run" button, , to run the model. You will be prompted to save the file. Save the project as yourname.prj.
  50. Choose to View Output after running the simulation. The View Output option is divided into separate sections for:
  51. PERLND
    IMPLND
    RCHRES
  52. First, view the flow contribution from the Agricultural Landuse.
  53. Do so by highlighting it in the section listing "Pervious Lands" and select VIEW.

NOTE: The output file is displayed as a text file. It begins with a heading which describes run and output information. The remainder of the file is composed of daily values for the entire simulation period. The two columns displayed for the Agricultural Landuse are average daily flow and total daily pollutant loading. Average daily flow combines overland, interflow, and groundwater flow for the watershed.

NOTE 2: Total daily pollutant loading is not a concentration.

 ***If you can't get the NPSM model to view your output in the notepad. Open the output files in Word or Notepad. The following are the files you will need to look at:

Pervious cover:

Urban or Built-up Land
C:\Basins\Modelout\onion\yourname.p01
Agricultural Land
C:\Basins\Modelout\onion\yourname.p02
Rangeland
C:\Basins\Modelout\onion\yourname.p03
Forest Land
C:\Basins\Modelout\onion\yourname.p04
Barren Land
C:\Basins\Modelout\onion\yourname.p05

Impervious Cover:

Urban or Built-up Land
C:\Basins\Modelout\onion\yourname.i01

Reach Output:

Onion
C:\Basins\Modelout\onion\yourname.r01

 Answer the following question:

  1. What was the selected watershed ID #?_________________
  2. What was the default % perviousness for Urban or Built-up Land?__________
  3. For what time span was meteorological data available in the reg06.wdm file?_______
  4. Which landuse accounts for the largest area in the watershed?_________
  5. What is the total area of the watershed?____________________
  6. How does this compare to the watershed area found while in the GIS portion of BASINS?___________________
  7. What landuse is not accounted for in the default data set?______________
  8. In the Input data editor:

  9. What modules are selected for the IMPLND section?_____________
  10. Do these modules match the ones selected in the NPSM Control Cards section?____
  11. NOTE: You must exit the Input Data Editor window and return to the NPSM Control Cards window to perform this action.

  12. How many parameters are associated with the PWAT-PARM3 data sub-group, within the PWATER data group of the PERLND module?
  13. Is the interception storage capacity for PERLND represented by a constant or monthly varying values? _____________
  14. Hint: the -PARM1 section of each data group generally offers the user the opportunity to change parameters from constant to monthly.

  15. Is the interflow inflow parameter represented by constant or monthly varying values?______________
  16. What are the units for each of these cloumns of output?___________
  17. NOTE: The beginning of this text file lists information about the data. (Recall that the pollutant is fecal coliform bacteria).

  18. What is the fecal coliform loading contribution from the Agricultural landuse on May 13, 1983?___________________
  19. How does this compare to each of the other pervious landuse fecal coliform loading values for the same day?(List their values)________________________

 

APPENDIX

 

PERLND Default Data

 

NOTE: The active modules of PERLND segments for hydrologic and general water quality simulation are:

 ATMP parameters:

ATEMP-DAT - Temperature information

PWATER parameters:

 PWAT-PARM2 - Surface and subsurface characteristics

PWAT-PARM3 - Subsurface and atmospheric information

PWAT-PARM4 - Surface and subsurface characteristics

PWAT-STATE1 - Initial conditions

 PQUAL parameters:

QUAL-INPUT - Pollutant buildup information

 IMPLND Default Data

 Parameters are displayed for the IMPLND module in the same manner as for PERLND.

 NOTE: The active modules of PERLND segments for hydrologic and general water quality simulation are:

 ATMP parameters:

 Same as PERLND

IWATER parameters:

IWAT-PARM2 - Surface characteristics

IWAT-PARM3 - Atmospheric information

IWAT-STATE1 - Surface characteristics

IQUAL parameters:

QUAL-INPUT - Pollutant buildup information


Back to Ann Quenzer's Home Page