HAWQS User Guide. Prepared by the. Spatial Sciences Laboratory Texas A&M AgriLife Research College Station, TX. For the

Transcription

1 HAWQS User Guide Prepared by the Spatial Sciences Laboratory Texas A&M AgriLife Research College Station, TX For the Office of Water, Immediate Office US Environmental Protection Agency Washington, DC Version 1.0 Beta Released June 16, 2016

2 TABLE OF CONTENTS 1. Overview Contact Information Minimum requirements What can I do with HAWQS? Disclaimer Supplement Material and Help Menu Register for a new Account and Log In General Navigation Create a Project Advanced options Projects List Archive and Restore Projects Project Summary Page Set HRUs Create Project Scenarios Scenario Summary Page Customize SWAT Input Data General Watershed Inputs and Databases Basin Input Data Fertilizer and Urban Input Data Nutrient Efficiency Land Use Update Weather Input Data Climate Change Scenarios (CMIP3) Climate Sensitivity/Variability Analysis Weather Generator Subbasin Inputs Curve Number Pothole Variables Sediment Routing Method Point Source Data SWAT Print Output Run Scenario Tasks (Generate Inputs, Run SWAT)

3 11. Analyze Your SWAT Output Run SWAT Check Output Reach Statistics Output Summary Charts Reporting Errors and Bugs

4 1. OVERVIEW The Hydrologic and Water Quality System (HAWQS) is a web-based interactive water quantity and water quality modeling system that employs as its core modeling engine the Soil and Water Assessment Tool (SWAT), an internationally-recognized public domain model. HAWQS provides users with interactive web interfaces and maps; pre-loaded input data; outputs that includes tables, charts, graphs, and raw data; a user s guide, and online development, execution, and storage of a user s modeling projects. HAWQS enables use of SWAT to simulate the effects of management practices based on an extensive array of crops, soils, natural vegetation types, land uses, and climate change scenarios for hydrology and the following water quality parameters: Sediment Pathogens Nutrients Biological oxygen demand Dissolved oxygen Pesticides Water temperature HAWQS users can select from three watershed scales, or hydrologic unit codes (HUCs) small (HUC 12), medium (HUC 10), and large (HUC 8) to run simulations. HAWQS allows for further aggregation and scalability of annual, monthly, and daily estimates of water quality across large geographic areas up to and including the continental United States. The United States Environmental Protection Agency (USEPA) Office of Water supports and provides project management and funding for HAWQS. The Texas A&M University Spatial Sciences Laboratory and EPA subject matter experts provide ongoing technical support including system design, modeling, and software development. The United States Department of Agriculture (USDA) and Texas A&M University jointly developed SWAT and have actively supported the model for more than 25 years. The system was developed to meet the needs of the USEPA Office of Water. It can also be employed by other Federal Agencies, State and local governments, academics, and contractors. The suggested citation for HAWQS is: US EPA (2016). HAWQS 1.0 Beta (Hydrologic and Water Quality System) Modeling Framework. Office of Water, Washington, D.C. Accessed day month year Contact Information For assistance with account settings and system errors, please contact eco.web@tamu.edu. For assistance with training and use cases please contact hawqs@epa.gov Minimum requirements 3

5 HAWQS is run entirely on a server, so personal computing requirements are minimal. HAWQS simply requires a web browser, such as the latest version of Chrome, Firefox, or Safari. Internet Explorer 11 and Microsoft Edge browsers are supported. The Older versions of Internet Explorer (<11) are not supported, and if you are on an older computer that cannot update Internet Explorer, we recommend you download an alternative browser. HAWQS is also available in mobile browsers; however some tabular data may be difficult to read What can I do with HAWQS? The procedure for using HAWQS (Hydrologic and Water Quality System) is briefly summarized in the following outline. This user guide will walk you through the steps listed below in more detail. 1. Visit to begin 2. Log in or register for a new account 3. Create a project a. Choose a desired catchment resolution: HUC8, HUC10 or HUC12 b. Select ending (and optionally starting) HUC ID 4. Create a scenario a. Specify the model run duration and model run frequency 5. Make further customizations to your model a. Set HRUs to eliminate minor land uses, soils and slopes b. Edit general watershed inputs and databases (basin, fertilizer, urban, nutrient efficiency, land use update) c. Edit subbasin inputs (curve number, potholes, sediment routing, climate change/sensitivity, point source) d. Modify SWAT output by selecting reach, subbasin and HRU parameters 6. Generate SWAT input files 7. Generate SWAT Access database for SWATeditor 8. Run available versions of SWAT 9. Analyze your results a. Run SWAT Check a program designed to identify potential model problems b. Generate output reach statistics c. View output summary charts d. Download a zip file of all project files 1.4. Disclaimer The information in this document has been funded wholly by the U.S. Environmental Protection Agency (EPA). It has been subjected to the Agency s peer and administrative review, and has been approved for publication as an EPA document. Mention of trade names or commercial products does not constitute endorsement or recommendation for use. Although a reasonable effort has been made to assure that the results obtained are correct, the computer programs described in this user guide are experimental. Therefore the author and the U.S. Environmental Protection Agency are not responsible and assume no liability whatsoever for 4

6 any results or any use made of the results obtained from these programs, nor for any damages or litigation that result from the use of these programs for any purpose. The SWAT model is an abstract representation of multiple interacting watershed dynamics. The ability of a model to provide useful insight to a question depends on the appropriate selection of dynamic representations and interpretation of results. The user may wish to consult the [SWAT technical guidance], other literature on water quality modeling, and/or a water quality modeling expert on the appropriate configuration of the model and interpretation of results Supplement Material and Help Menu Please feel free to review HAWQS tutorials and peer reviewed literature covering the topics of SWAT as well as impacts modeling for additional help with HAWQS projects. There is also additional material available for HAWQS users on the Help Menu. This menu contains relevant material that can assist users with their project. 2. REGISTER FOR A NEW ACCOUNT AND LOG IN You must have an account to use HAWQS. Click the register button located on the top right of the home page to begin. The form will ask you to provide: 1. User name 2. Password a. Must be at least 8 characters b. Must contain at least 1 non-alphanumeric character 3. address a. Cannot have multiple accounts with the same address 4. First name 5. Last name 6. Company/organization 7. Reason for using HAWQS 8. Security question and answer (used for account recovery) Click the Register button to submit your form. Before gaining access to HAWQS, you will need to wait for an administrator to approve your account. You will receive an from eco.web@tamu.edu notifying you when your account is approved. Please check your spam folder, or add this address to your safe-senders list. If you have not been approved for an account within 24 hours, please contact HAWQS@EPA.GOV. 3. GENERAL NAVIGATION HAWQS makes use of heading breadcrumbs to allow easy navigation between pages within a project and scenario. The following figure shows an example of breadcrumbs used throughout HAWQS that you may click on at any time to go back to a page: 5

7 FIGURE 1: BREADCRUMB NAVIGATION In addition, a user may use the sidebar navigation to go back to a project or scenario summary. FIGURE 2: SIDEBAR NAVIGATION There are many pages in HAWQS that allow you to make modifications to SWAT input data. These pages are described in detail later in this guide. Each of these pages will have a Save changes button you may click to save all changes made to a page. No changes are saved unless this button is clicked. If at any time you want to exit the page without saving your changes, click the orange Cancel button, or simply click a different page in HAWQS, use your browser s back button, or close your internet browser. FIGURE 3: EXAMPLE SAVE AND CANCEL BUTTONS 4. CREATE A PROJECT To create a new project, log in and click the Create a New Project button on the home page. Zoom in on the map and click near the ending HUC (most downstream HUC) of your watershed. The system will map your watershed as well as show nearby HUCs to the point you clicked. 6

8 FIGURE 4: THE CREATE PROJECT PAGE AFTER THE USER CLICKS ON THE MAP In the figure above, the most downstream HUC located at the point clicked is shown in darker green. The resulting watershed is routed upstream from the most downstream HUC to the head of the watershed and shown in lighter green. The system also shows nearby HUCs and streams in tan, allowing the user to easily click and choose a new downstream HUC. In the figure above, you will also see the Map Options box to the right of the map. Here you may change your data resolution between HUC8, 10, or 12. You may also enter a downstream HUC ID directly instead of finding it on the map. After defining your watershed area on the map, you may finish setting up your project by giving it a name. 7

9 FIGURE 5: FINISH SETTING UP A PROJECT You are given a brief summary of your watershed area, as shown in the above figure. Click View your connections to see a routing table of HUC IDs in the watershed. Below the project name field is a checkbox asking if you want to receive an when your project completes the setup. The system automatically checks this box if it feels your project may take a few minutes or more to set up. Click the Help me decide link for more information about the time this task may take. Click the Create project button to create your project Advanced options By default, your watershed is routed from the head of the watershed to the most downstream HUC ID. If you would like to use a starting HUC other than the watershed head, you may enter it by clicking the Advanced link above the Create project button. 8

10 FIGURE 6: ADVANCED OPTION WHEN CREATING A PROJECT However, we recommend not doing so unless you plan to provide inlet data to your SWAT model, a feature not available through the HAWQS system. To utilize this feature, you will need to zip and download your project files to your own computer and modify them outside of HAWQS. 9

11 5. PROJECTS LIST When you log into HAWQS, you are directed to your list of projects. To view and modify a project, click on its title. From this list, you may also archive and delete projects. The list also shows if a project is currently busy running a task by displaying a spinning icon to the right of its title. FIGURE 7: PROJECT LIST 5.1. Archive and Restore Projects Unused projects are archived to save server resources and help aid compatibility with future HAWQS capabilities. Projects will be automatically archived after 6 months of no activity, but you also have the option to archive a project yourself at any time. When a project is archived we will do our best to save all your inputs and uploaded documents, but if there are significant changes to HAWQS, old project inputs may become incompatible when you restore your project. When you restore an archived project, you will be updated to the newest version of HAWQS data and SWAT. Old SWAT runs and output data will not be preserved, and you will need to re-run these tasks. It is recommended that the user download the zipped project files at the completion of each project for their records. You may browse your archived projects via the link below your projects list that will appear if you have at least one archived project. From here you may download your archived project s metadata, restore or delete the project. 10

12 6. PROJECT SUMMARY PAGE When you click on a project title from your projects list, you are taken to the project summary page. The summary page is split into two halves: the left side is where you customize your project; the right side shows project settings and watershed statistics. FIGURE 8: PROJECT SUMMARY PAGE FOR A NEWLY CREATED PROJECT The first step to take after creating a new project is to set Hydraulic Response Units (HRUs,) as described in the next section of this user guide. Once your HRUs are set, you will create project scenarios, where you may customize SWAT input data, run the model, and analyze outputs. Note: The system provides a link to download your subbasins, which is a table mapping the HUC ID to SWAT model subbasin ID for your watershed. You may also download a table of your HRUs in CSV format. 11

13 7. SET HRUS Reducing the number of HRUs in your project will decrease your project file size as well as decrease the time it takes to make input files and run SWAT. The Set HRUs page allows you to set threshold levels to eliminate minor land uses, soils, and slopes in each subbasin. Land uses, soils, or slopes that cover an area less than the threshold levels you supply are eliminated. Threshold levels may be set by percentage or area (km 2 ). You may also exempt any land use from elimination by checking the box next to its name on the right side of the page. Hover over the land use short name for a full description. Note: HRUs represent a specific Land use, Soil, Slope class, and subbasin. FIGURE 9: SET HRUS 12

14 After you have set your HRUs, you will be taken to a screen that summarizes your area redistribution and lists the remaining land uses, soils, and slopes in your project. You may download both your new table of HRUs as well as the original table before thresholds were applied. If the results are not what you desired, you may reset your HRUs to the original from when your project was created. Note: You will not be able to change your HRUs after you have created scenarios for your project. FIGURE 10: SET HRUS PAGE AFTER THRESHOLDS WERE APPLIED 13

15 8. CREATE PROJECT SCENARIOS A project scenario is where you customize SWAT input parameters and run the model. Each project may have multiple scenarios. Once you have set your HRUs for your project, as described in the previous section of this guide, go back to your project summary page, and click Create a scenario. FIGURE 11: CREATE A NEW SCENARIO Give your scenario a name; if it is the first scenario for your project, we recommend leaving the name as Default or Baseline. Having a scenario named Default will allow for simpler compatibility with ArcSWAT if you choose to download your project files and work outside of the HAWQS system. Enter a starting and ending simulation date for your project, as well the number of warm-up years and output print setting. Simulation runs are limited to dates that have continuous measured weather data. Note: Please enter you simulation start and end using the selection tool or use the format MM/DD/YYYY. SWAT output print settings feature allows the user to specify the frequency of output data. This is limited to Daily, Monthly, and Yearly. Note: The simulation period includes the warm-up. For example, if your simulation period is 10 years and has a 2 year warm-up. The warm up is the first 2 years of the 10 year simulation. Note: By default, we set the simulation dates and warm-up years to a short time period to save server resources. By default, the simulation dates begins 01/01/1961 and ends 12/31/

16 However, please note that a more realistic model run time will span years with 5-10 years of model warm-up. As the SWAT model is updated, you may want to choose which version of the model to run. HAWQS provides a select list of available SWAT model versions to choose from. Note: As the SWAT model is updated, future versions may be included in the HAWQS system Scenario Summary Page After creating a scenario, you are taken to its scenario summary page as shown in the Figure 12. FIGURE 12: SCENARIO SUMMARY PAGE The general settings you chose when creating the scenario are shown in the box at the top left. Edit these any time by clicking the Edit button. 15

17 Below the settings box is the Customize SWAT Input Data section, described in detail in the next section of this user guide. To the right of the scenario summary page is the project tasks list, SWAT output results listings appears after a SWAT simulation is completed. This section is described in section 10 of this guide. 9. CUSTOMIZE SWAT INPUT DATA 9.1. General Watershed Inputs and Databases HAWQS allows the user to customize parameters in three categories: General Watershed Inputs and Databases Weather Input Data Subbasin Inputs Basin Input Data General watershed attributes are defined in the basin input file. These attributes control a diversity of physical processes at the watershed level. The interfaces will automatically set these parameters to the default or recommended values listed in the variable documentation. You can use the default values or change the available values below to better reflect what is happening in your watershed. Please refer to the SWAT2012 IO Documentation chapter on basin inputs for a full description of all parameters. The HAWQS interface splits the parameters into four categories, shown as tabs on the page. The parameters for that category are shown in a table. Click the blue information icon next to a variable s name for a detailed description. The right three columns of the table show the variable s current value (which you may change), the valid input range, and the default value. 16

18 FIGURE 13: BASIN INPUT DATA PAGE 17

19 Fertilizer and Urban Input Data The fertilizer and urban input data pages function similarly. The fertilizer database summarizes the relative fractions of nitrogen and phosphorus pools in the different fertilizers. The urban database summarizes parameters used by the model to simulate different types of urban areas. Please refer to the SWAT2012 IO Documentation chapters on fertilizer and urban inputs for a full description of all parameters. Both the fertilizer and urban input data pages show a table of values. Click the Edit link on the left side of a row to modify variables for that row. A window will pop up with a table of all the variables as shown in Figure 14. Much like the Basin input data page, there will be a box that displays the current value of the parameter that you may change. It will also show the valid range of values for the variables as well as the default value. FIGURE 14: MODIFY A ROW OF FERTILIZER DATA 18

20 Nutrient Efficiency Under certain land use managements the amount of nitrogen fertilizer applied is done automatically based on the amount of nitrogen removed at harvest. If you set nutrient efficiency value to 1.0, the model will apply enough fertilizer to replace the amount of nitrogen removed at harvest. If you enter a number greater than 1.0, the model will apply fertilizer to meet harvest removal plus an additional amount to make up for nitrogen losses due to surface runoff/leaching. If nutrient efficiency value is less than 1.0, the model will apply fertilizer at the specified fraction below the amount removed at harvest. In HAWQS, you may enter a new nutrient efficiency value (a number ranging from 0 to 2) for your entire project area, or enter a value for each land use Land Use Update In order to update land use within HAWQS, please download the zipped folder containing text files in this section. The first file is lup.dat and is the description of when to apply the update within the simulation period. The second set of files contain each unique HRU IDs and the land use fraction of the subbasin. The land use update file (lup.dat) is an optional file which allows the user to specify which update files will be applied for a specific time series. The lup.dat file is particularly useful to initialize conservation measures or represent the expansion of urbanized areas mid-simulation. After their initialization, the practices remain in effect for the remainder of the simulation. The lup.dat file must contain five parameters per line: sequential number, month, day, year, and the name of the file that contains the fraction update. You are restricted to 25 lines in lup.dat. Each file referenced in lup.dat must reserve the first line for comments, then for each line after contain the HRU number and updated HRU fraction value. The number of HRUs in the file must match the number of HRUs in your project, or you will receive an error. In addition, the HRU fraction for each subbasin in your project must add up to 1.0. Please refer to the SWAT2012 IO Documentation chapter on land use update for the full formatting requirements of these files. Note: Land cover in a default HAWQS run is considered constant for the entire simulation period. The land cover data is sourced from the National Land Cover Dataset (NLCD) from 2006 and Crop data layer (CDL) from If the user wishes to make alterations to land cover, they should use the Land Use Update section of HAWQS. 19

21 9.2. Weather Input Data By default, HAWQS scenarios use measured weather data based on PRISM (Parameter-elevation Regressions on Independent Slopes Model). However, HAWQS also provides several methods for evaluating alternative weather conditions that may be relevant for your analysis. The three methods discussed in this section are: 1. Climate Change Scenarios to explore how potential future climate change conditions using statistically downscaled models might affect the management option being considered. 2. Climate Sensitivity/Variability Analysis to conduct a what-if analysis with user-adjusted changes to precipitation and/or temperature values, that HAWQS then applies to subbasin outcomes. 3. Weather Generator can be used in two ways. The first enables the user to have HAWQS fill in historical values for subbasins where observations are lacking for a variety of variables such as daily precipitation, maximum and minimum air temperature, solar radiation, wind speed and relative humidity. The second use is similar to the Climate Sensitivity analysis, in that it provides the ability for the user to adjust these various weather-related variables. This analysis allows the user to explore aspects of the climate or weather that the system is most sensitive to Climate Change Scenarios (CMIP3) HAWQS provides the ability to use downscaled global climate model simulations to evaluate how the management options might perform under future climate conditions. The user can select runs using models based on coupled Model Intercomparison Project Phase 3 (CMIP3). NOTE OF CAUTION: No climate model is able to accurately predict future conditions for a number of reasons. This capability is provided in HAWQS for use in vulnerability assessments that also include evaluation of risk thresholds based on the decision context, and should only be used to inform flexible, adaptive, robust strategies for managing risk. The user is strongly advised to consult the climate literature on the use of downscaled models in decision making. CMIP3 downscaled models used in HAWQS were developed by The Nature Conservancy for the World Bank. More information about CMIP3 and the available climate models and scenarios are described on the right side of the page. In the future, CMIP5 downscaled data will be incorporated into HAWQS. To adjust weather variables based on CMIP3 scenarios, select your options from the lists on the left side of the page. 20

22 Note: This section will require that simulation period match the pre-set time period from the drop down menu. If your simulation does not match and you select this as your scenario, your simulation period will be reset to match the climate time period. FIGURE 15: CLIMATE CHANGE (CMIP3) PAGE Climate Sensitivity/Variability Analysis The Climate Sensitivity/Variability Analysis can be used to conduct a what-if analysis based on user-adjusted changes to precipitation and/or temperature values. HAWQS then applies these variables to generate subbasin outcomes. In addition, the user can make monthly rainfall and temperature adjustments for each subbasin in your project. For example, if the user wants to examine effects of extreme temperatures during the summer and/or periods of heavy precipitation and periods of drought, the user can use insert monthly values based on their own judgement. Similarly, the user can make adjustments to certain subbasins but not to others. 21

23 TABLE 1: CLIMATE CHANGE PARAMETERS Parameter Rainfall(month) Temperature(month) Description Rainfall adjustment (% change). Daily rainfall within the month is adjusted by the specified percentage. For example, setting Rainfall = 10 will make rainfall equal to 110% of the original value in January. Temperature adjustment ( C). Daily maximum and minimum temperatures within the month are raised or lowered by the specified amount. Move the sliders to adjust rainfall and temperature, then choose to which subbasins and months to apply the values. After clicking Save changes, your values will be shown in a table at the bottom of the page. You may continue to add multiple adjustments to specific months and subbasins; they will be applied to your scenario in order, starting from the top. Bottom settings may overwrite rows above. 22

24 FIGURE 16: CLIMATE SENSITIVITY/VARIABILITY ANALYSIS Weather Generator The weather generator input file (WGN) contains the statistical data needed to generate representative daily weather data for the subbasins. Climate data can be generated in two instances: when the user specifies that simulated weather will be used, or when measured data is missing. 23

25 HAWQS allows the user to adjust weather generator inputs. HAWQS will generate weather data if this section is selected for the scenario and the weather data will be adjusted based on the user s inputs. For more information about these inputs, please refer to the SWAT2012 IO Documentation, Chapter 12.. The weather generator page works much like climate sensitivity/variability analysis. Move the sliders to the selected WGN parameter, then choose to which subbasins and months to apply the values. After clicking Save Changes, your values will be shown in a table at the bottom of the page. You may continue to add multiple adjustments to specific months and subbasins; they will be applied to your scenario in order, starting from the top. Bottom settings may overwrite rows above. FIGURE 17: WEATHER GENERATOR 9.3. Subbasin Inputs Curve Number The Soil Conservation Service (SCS) curve number is a function of the soil's permeability, land use and antecedent soil moisture conditions. Please refer to the SWAT2012 IO Documentation chapter on MGT inputs for more information about the curve number (CN2). HAWQS allows you to increase or decrease your curve number values by up to 10%. You may set a single percentage increase or decrease for your entire project, or set different values based on subbasin, land use, soils, and slope. 24

26 FIGURE 18: EXAMPLE SETTING INCREASING THE CURVE NUMBER BY 2% FOR SELECT HRUS 25

27 Pothole Variables Potholes are defined as a local depressions, but be aware that the variables in this section has been adapted for use with Stormwater BMP s. HAWQS allows you to set pothole values for your entire project, or set different values based on subbasin, land use, soils, and slope. Please refer to the SWAT2012 IO Documentation chapter on HRU inputs (see pages 5, 9, and 10) for a full description of pothole variables. FIGURE 19: SET POTHOLE VARIABLES 26

28 Sediment Routing Method By default, HAWQS sets your project to use the 0 Simplified Bagnold Equation model for channel erosion. You may select a different model for one or all of your subbasins in your project. Routing codes by particle size: 1 Simplified Bagnold Equation by Each Particle Size 2 Kodatie Model 3 Molinas and Wu Model 4 Yang Sand and Gravel Model FIGURE 20: SET SEDIMENT ROUTING METHOD TO ALL OR SELECTED SUBBASINS 27

29 Point Source Data SWAT directly simulates the loading of water, sediment and other constituents from land areas in the watershed. To simulate the loading of water and pollutants from sources not associated with a land area (e.g. sewage treatment plants, etc.), SWAT allows point source information to be read in at any point along the channel network. The point source loadings may be summarized on a daily, monthly, yearly, or constant basis. Please refer to the SWAT2012 IO Documentation chapter on measured inputs (keep in mind HAWQS accepts CSV files instead of spaced.dat files described in the documentation). HAWQS will take a zip file of CSV files. For daily, monthly, and yearly point source data, you will have one file for each subbasin in your project. For constant point source data, you will have a single CSV file containing data for each subbasin on a separate row. The default value for all point source data is 0. Note: HAWQS point source data defaults to loadings data from the USGS SPARROW models for the variables found in Table 2. Point source loading for your specific watershed can be found by downloading the constant sample file from the point source data page. HAWQS assumes that point sources are contributed at the headwater of each subbasin. For more information regarding point source data please refer to the HAWQS Help menu. TABLE 2: DESCRIPTIONS OF POINT SOURCE LOADINGS FROM SPARROW MODEL Code Description Units FLOWM3 Flow m 3 SED TONS Sediment Tons MINPKG Mineral Phosphorous Kg NO3 NKG Nitrate Kg ORG NKG Organic Nitrogen Kg ORG PKG Organic Phosphorous Kg HAWQS provides sample data for each type of point source data, formatted specifically for your project. Please use the samples to get started and follow the uploading guidelines below: Uploading Guidelines You may mix types; for example, you can have one subbasin with constant data, another two with daily, and one with monthly. Do not upload more than one type per subbasin. You do not need to upload data for all subbasins in your project. Keep the file names as shown in the samples provided. 28

30 9.4. SWAT Print Output By default, SWAT will print output for all reach, subbasin, and HRU variables as well as print these outputs for the first HRU in your project. However, if you prefer, you may choose only certain variables and HRUs. You may also choose to print output for all HRUs. Note: It is important to note that by narrowing your SWAT output, you will also be reducing what you can view in your HAWQS output statistics as well. After running your project, reach output can be found in the Scenario Output Data Section on the scenario summary page (see Section 11). Note: Future iterations of HAWQS will include subbasin data in the Scenario Output Data Section as well. At this time, subbasin and HRU data can be accessed by downloading your project files and running them in ArcSWAT. FIGURE 21: REACH, SUBBASIN, AND HRU PARAMETERS TO PRINT 29

31 FIGURE 22: HRUS TO PRINT 30

32 10. RUN SCENARIO TASKS (GENERATE INPUTS, RUN SWAT) The Run Scenario Tasks section is located near the top right of your scenario summary page. Once you make all of your desired input modifications as described in the sections above, you are ready to run these tasks. You may run one or more tasks simultaneously, but you must first write SWAT input files in order to run the SWAT model. The following tasks are available: 1. Write SWAT input files 2. Write SWAT editor tables 3. Run SWAT 4. Process SWAT output files Each task may take several minutes or hours to complete if your project is very large and you have a long simulation date range. HAWQS provides a check box at the bottom of the task list that asks if you would like to receive notifications when tasks complete. If this is checked, the system will you as your scenario completes a task. FIGURE 23: RUN TASKS LIST HAWQS provides an estimate of how long it will take to run the SWAT model itself. Click either the Time estimate link or the Help me decide link for more information about how long tasks may take. Note: While your tasks are running, please do not modify any input data. Your scenario summary page will show the current status of your tasks. Note: If your scenario has been stuck on a task without any update to this status box for many hours, please contact technical support (eco.web@tamu.edu). 31

33 FIGURE 24: CURRENT TASK STATUS 32

34 11. ANALYZE YOUR SWAT OUTPUT To analyze your SWAT output, you must first run both the Run SWAT and Process SWAT output files tasks described in the previous section of this guide Run SWAT Check SWAT Check reads the model output from a SWAT project and performs many simple checks to identify potential model problems. The intended purpose of this program is to identify model problems early in the modeling process. Hidden model problems often indicate the need to recalibrate or regenerate a model; identifying these problems early will help avoid wasted time. HAWQS is designed to compare a variety of SWAT outputs to nominal ranges based on the judgment of the programs developers. A warning does not necessarily indicate a problem; the purpose is to bring attention to unusual predictions. SWAT Check also provides a visual representation of various model outputs to aid novice users. In addition, any tabular data shown in SWAT Check may be copied and pasted in Microsoft Excel or other spreadsheets as needed. Please refer to the SWAT Check Documentation page for further details. FIGURE 25: EXAMPLE SWAT CHECK ANALYSIS 33

35 11.2. Output Reach Statistics The SWAT output reach data page allows you to download CSV files and chart statistics of your output.rch data created by SWAT. The statistics you may request are: Load/Flow Duration Curve Average Maximum Minimum Exceedances (enter a threshold value for each checked parameter; HAWQS will return the number of days above this threshold) Percentiles FIGURE 26: STEP 1 REQUEST STATISTICS IN THE FORM ON THE LEFT Note: Please be aware that files may be downloaded to a spreadsheet program in comma separated file format (.csv). The file extension is coded to describe the output data source. Please review file extension document in the help menu. 34

36 FIGURE 27: STEP 2 - PROCESS YOUR REQUEST After submitting your requests, click Process Data on the right half of the page. HAWQS may take several minutes to finish processing. You may add or remove as many requests as you like. 35

37 After processing is complete, you will be presented with a link to download CSV data as well as a link to the charts page. FIGURE 28: OUTPUT REACH STATISTICS CHARTS You can choose a plot type for each parameter such as line, area, column, and scatter. Note: You may chart as many parameters from your request as you like; however, we recommend only charting two or three at a time in order to ensure the chart is readily readable. We give you the option to define multiple y-axes to help present your data in a more readable way. This can sometimes have unpredictable results, such as the zero-line showing at a different height among multiple axes. If this occurs, try checking the box, Attempt to align y-axis, in the form on the left. Click the button in the upper right corner of the chart to print or export it to a file. 36

38 11.3. Output Summary Charts The SWAT output summary charts page gives some example line and bar graphs based on data from your output.std SWAT file. Hover over the points on the graphs for numerical values. Click the icons at the upper right corner of the graphs to print or export to a file. FIGURE 29: EXAMPLE OUTPUT SUMMARY CHART 37

39 12. REPORTING ERRORS AND BUGS HAWQS provides a simple method for you to submit error reports to technical support. Any time you receive an error message in HAWQS that requires action from technical support a button will appear below the message that allows you to submit it for review. You will be taken to a form where you can add any comments along with the full error message received. We will get back to you as soon as possible with a solution. You may also submit an error report on your own at any time if you need help or something is not working as expected. Each error report is tied to a specific project. From your project s summary page, see the Error Reports section in the lower right of the page to create a new report or check the status of your existing reports. 38