This project has moved and is read-only. For the latest updates, please go here.

Testing Procedures for HydroDesktop

Before approving a release as a 'Recommended release', following integration testing procedures must pass. This is a "base line" set of tests to act as a "sanity check" to make sure the basic functions are working in HydroDesktop. 

 General Guidelines

Run the testing procedures as a regular, non-privileged user (log-in as admin, install HydroDesktop, log-out, log-in as a regular user, start HydroDesktop.

To test correct processing of dates, times and numbers, it is recommended to also run the testing procedure with foreign language regional language settings (To change the settings in Windows, go to Control Panel - Language and Region - and change the language to Czech (Czech Republic) or to your favorite foreign language.


Sample Files for Testing

Use the following shapefiles, project files and databases for the testing:

Jacobs_Well_Spring  (Jacob's Well Spring project  - includes water temperature, discharge and precipitation data from the Blanco river watershed in Texas used in the HydroDesktop tutorial. This project comes pre-installed with HydroDesktop 1.4. When you start HydroDesktop, select Open Existing Project - Jacobs_Well_Spring.

elbe (Labe/Elbe river watershed - includes river catchments and administrative regions of the Czech Republic. This project comes pre-installed with HydroDesktop 1.4. When you start HydroDesktop, select Open Existing Project - elbe.

Dry_Creek.zip (Dry Creek experimental watershed, Idaho)

Czechia.zip (Czechia HydroDeskop project - includes admin regions, rivers, and time series data from Central Europe) 

MEX_wat.zip (Mexico rivers)


Map Functions

 Procedures by Jiri Kadlec, 9/22/2011

 Limitations:Only adding shapefiles in UTM  and WGS 1984 projections  is fully supported. Some other projections are not supported.

Testing Procedure 1 - Add external shapefiles  

  1. Start HydroDesktop with the "North America" option.
  2. Unzip the attached file file: MEX_wat.zip
  3. Click the 'Add Layer' button.
  4. Select the file 'MEX_water_lines_dcw.shp'.
  5. A message is shown: Reproject map layer to match the map coordinate system? This will not affect the source file. Select Yes.
  6. The Mexico rivers are added to the map.
  7. In 'Online Basemap' select 'Bing aerial map'. and select 'opacity = 60'
  8. Zoom to the estuary of Colorado in Gulf of California
  9. The dry channel of the Colorado visible on the satellite image is well aligned with the stream line shapefile layer.

Testing Procedure 2 - View attribute table (continue from 'Map Functions testing procedure 1 Add external shapefiles)

  1. Right click on MEX_water_lines_dcw
  2. Choose 'Attribute Table Editor'
  3. In the menu choose Selection - Query
  4. Double click on Field name HYC_DESCRI
  5. Click the '=' button
  6. Click 'Get Unique Values'
  7. Double click 'Perennial/Permanent'
  8. Click OK
  9. The table shows 6199 rows selected
  10. Close the attribute table. the perenninal rivers of Mexico are also highlighted on the map.

Data Discovery (Search and Download)

Procedure by Jiri Kadlec, 9/20/2011 (updated by YooriChoi, 10/6/2011, updated by Jiri Kadlec 1/24/2012)

Limitations:

Internet access is required. Doesn't work with very large search area. Search speed is very slow when selecting more than 5 polygons. Application becomes unresponsive when more than 100,000 series are found.

Main testing procedure: use with your own area of interest and keyword of interest:

 

Testing procedure 1

  1. Start HydroDesktop with 'North America' Project template
  2. Click the Search tab
  3. In the Area panel, Click Select by Attribute
  4. Select active layer - U.S counties
  5. Select county - Ada, ID by typing "ada" in the value box and clicking Enter.
  6. Click OK - the map will zoom to Ada county
  7. Select Keyword - streamflow by typing in the Keyword box
  8. In Dates, set Start Date: 10/1/2005 and End Date: 9/31/2010
  9. Click 'Run Search' button
  10. The map shows 4 layers in the data sites group: EPA STORET, NWIS Daily Values, NWIS Instaneous Irregular Data, Dry Creek Experimental Watershed
  11. Right-click on the layer "Dry Creek Experimental Watershed"in the legend
  12. In the context menu of the "Dry Creek Experimental Watershed" choose Selection - Select All.
  13. In the Search tab click "Download"
  14. Wait until the Download Manager shows 'Download Complete'. and close the Information message box and the Download Manager.
  15. Go to the 'Table' tab. Notice that eight series are shown in the list of time series (6 series from DCEW_Lower Gage, 1 from DCEW_Con2E Gage, 1 from DCEW_Con2M Gage)
  16. Select the 'Table' tab and check the first two series
  17. Select Graph tab - the two series should appear in the graph
  18. Select Edit - the two series should appear in the edit view graph

 Testing procedure 2

  1. Start HydroDesktop with the North America project template.
  2. In the map legend, choose U.S.  Counties and check the checkbox next to it. The counties layer becomes visible.
  3. In the search tab choose "Select by attribute"
  4. in the value box, start typing Hays, TX. Click Hays, TX to select it.
  5. Click Apply. The map zooms to the county  and highlights it in blue.
  6. Click OK.
  7. Specify a Start Date of 10/1/2009 and an End date of 9/30/2010
  8. In the keyword box start typing "streamflow" in the Keywords text box. The list of keywords automatically selects keywords that match your search. Click Streamflow in the list of keywords.
  9. Click the "Keyword Selection" button . This opens the detailed keywords dialog.
  10. Click the Add button to add "Discharge, Stream" into the selected keywords.
  11. In the Keywords text box, start typing "temperature".
  12. Click Temperature, water in the list of keywords. It should also show in the tree view.
  13. In the bottom part of the keywords window, click the Add button to add "Temperature, water" into the Selected Keywords box.
  14. Click OK to close the keywords window.
  15. In the search tab, click Run Search
  16. In the Map legend on the left, right-click on the NWIS Daily Values layer and click Attribute table editor.
  17. Expand the SiteName, VarName and DataType columns in the attritute table.
  18. Sort the table by SiteName by clicking on the SiteName column.
  19. With the CTRL button pressed, Select the following time series in the attribute table window:
Table 1 Selected Time Series in Attribute Table Editor
SiteName VarName DataType
Blanco Rv nr Kyle, , TX Discharge, cubic feet per second Average
Jacobs Well Spg nr Wimberley, TX Discharge, cubic feet per second Average
Jacobs Well Spg nr Wimberley, TX Temperature, water, degrees Celsius Average
Blanco at Halifax Rch nr Kyle, TX
Temperature, water, degrees Celsius Average

Click Close to close the attribute table editor. Notice that the selected time series are highlighted in the map.

Testing procedure 3 - Data Download (continued from testing procedure 2)

  1. In the Search tab, Click Download.
  2. Dismiss the message box and hide the download manager when it is finished.
  3. Once the download is complete, the sites with downloaded data are highlighted in green color.
  4. Click the Graph tab in the ribbon to activate it.
  5. Click to place a check next to Temperature at the Blanco River at Halifax Ranch.
  6. Place a check next to Temperature at Jacob’s Well Spring.
  7. Two water temperature series are visible in the graph.

 


 

Data Export

Procedure by Yoori Choi, 9/22/2011 (updated by Jiri kadlec, 10/2/2011)

HydroDesktop Project/Data to use for this test:

  Jacobs_Well_Spring.zip (zip file contains the project file, database and all required files). You can use the sample Jacobs_Well_Spring project that comes with HydroDesktop instead.

Testing procedure 1 

  1. Start HydroDesktop
  2. Select Open Existing Project - Browse - and select the project jacobs_well_spring.dspx
  3. Ensure Table plugin is activated 
  4. Click Export button
  5. Specify the data sites layer you want to export (NWIS Daily Values)
  6. Select all felds to export
  7. Select a delimiter. (e.g. Comma)
  8. Click Browse button to specify output file in your computer. (file name = 'Hays County export data')
  9. Click "Export Data" button
  10. Close the window.

Output

The output of this function should be: 

Your exported 'Hays County Streamflow export data' csv file is located in your computer. 

 


Table View

Procedure by Yoori Choi, 9/22/2011 (updated by Jiri kadlec, 10/2/2011)

HydroDesktop Project/Data to use for this test:

 Jacobs_Well_Spring.zip (zip file contains the project file, database and all required files) You can use the sample Jacobs_Well_Spring project that comes with HydroDesktop instead.

Limitations: Display of table is slow for series with > 100,000 data values

Testing procedure 1 

  1. Select the 'Table' tab and check the two water temperature series. ("Blanco Rv at Halifax Rch nr Kyle, TX" & "Jacobs Well Spg nr Wimberley, TX")
  2. The result is shown on the tabular form. As a default, series are shown all fields in sequence.
  3. Click a radio button next to the "Show just values in parallel", then the result will be shown just values in parallel. 

Output

The output of this function should be:

About 19894 data values will be shown in a tabular form.

 


Graph View

Procedure by Yoori Choi, 10/4/2011

Limitations: Display of graph is slow if more than 20 series are selected or if a time series has > 100,000 data values.

Testing procedure 1 (continue from 'Table View' testing procedure 1)

  1. Select the 'Graph' tab and check the first two water temperature series. ("Blanco Rv at Halifax Rch nr Kyle, TX" & "Jacobs Well Spg nr Wimberley, TX")
  2. You will notice that the Graph View creates a time series plot of the selected series and can visualize multiple series at once. You will notice that a legend appears at the bottom of the plot when 2 series are selected.
  3. Select the type of plot to be displayed by clicking on the appropriate icon.
    • Click on 'Probability' plot type. It will show the line, the data points, or both.
    • Click on 'Histogram' plot type. 
    • Click on 'Box/Whisker' plot type.
    • Click on 'Summary' icon and summary statistics for the currently selected time series will be displayed.
  4. Select a 'Time series' plot type to go back to the original.
  5. Click and drag rectangle on the plot to define a zoom area. You will notice that when you hover over the plot the cursor changes to a cross, enabling you to select a zoom area.
  6. While you are zoomed in, you will notice that scroll bars appear at the bottom and on the right of the plot window. You can zoom in on a time series plot and then scroll through time using the scroll bars.
  7. To zoom out, you can right click on the plot and select "Un-zoom", "Undo All Zoom/pan", or "Set Scale to Default".
  8. Change start date as "1/1/2010" in the "Date Time" panel and then click the Refresh button.
  9. You will notice that the plot has been restricted to the selected date range.
  10. Click the "Full Date Range" option then it will reset the plot to the full date range.
  11. To save a copy of the image to disk, right click on the plot window and select "Save Image As". A file dialog will open asking you where you want to store the image. Select a location to which you want to save the image, select a desired file type, give your image name, and then click the "Save" button to save it to disk.



 

Edit View

Procedure by Yoori Choi, 10/4/2011 (Updated by Jiri Kadlec, 2/21/2012)

HydroDesktop Project/Data to use for this test:

 Dry_Creek.zip  (zip file contains the project file, database and all required files) You can also use the sample Jacobs_Well_Spring project that comes with HydroDesktop instead.

Limitations: Saving of values is slow for very large series (with > 100,000 data values)

Edit View - Testing procedure 1

  1. Open the project Dry_Creek.dspx
  2. Ensure Edit plugin is activated 
  3. Select a data series in the Series Selection tool 
  4. Click "Edit Series" button 
  5. Type a value (e.g. Value > 15) value into one of the threshold value boxes and then click the "Apply Filter" button

Output

The output of this function should be:

Any value greater than '15' will be marked as a red dot on the graph.

 

Edit View - Testing procedure 2

  1. Ensure Edit plugin is activated 
  2. Select a data series in the Series Selection tool 
  3. Click "Edit Series" button 
  4. Use the data filters or click on records in the Edit View table to select the data values that you would like to modify
  5. Click the "Change Value" button
  6. Select the operation that you would like to perform (e.g. add, subtract, multiply, or set value to)
  7. Type a numeric value into the text box. (e.g. Subtract: 10)

Output

The output of this function should be:

The original data value will be subtracted by 10 and updated with a new value.

Edit View - Testing Procedure 3

  1. Ensure Edit plugin is activated 
  2. Select a Discharge data series in the Series Selection tool 
  3. Click "Edit Series" button 
  4. Select one or more rows in the table below the graph in the edit view
  5. Click "Flag" button
  6. in the dialog, select set qualifier to : New Qualifier... and enter qualifier code: "MyCode"
  7. in the dialog box, click "Set"

Output

The output of this function should be:

The QualifierCode is set to "MyCode" in all selected rows

 

Edit View - Testing procedure 4

  1. Ensure that the Edit plugin is activated
  2. Select a data series in the series selection tool
  3. Click "Derive Series"
  4. Select "Derive using aggregated data values"
  5. Select the time interval (for example Daily) and the aggregation (for example Average)
  6. Click "New Data Series".

Output

The output should be: A new derived series in the graph view and table view with aggregated values. Notice that some of the values re negative ("no data values")

 


HydroR

 Procedure by Yoori Choi, 9/6/2011

(USU)

HydroDesktop Project/Data to use for this test:

 Jacobs_Well_Spring.zip (zip file contains the project file, database and all required files) You can use the sample Jacobs_Well_Spring project that comes with HydroDesktop instead.

Testing procedure 1

  1. Prerequisite: install R program from http://www.r-project.org/ 
  2. Ensure plugin is activated 
  3. Click Start R.
  4. If a message 'Select R location' appears, click browse... and browse to the folder C:\Program Files\R\R-2.14.1\bin\i386 or the folder where R is installed and select R.exe
  5. Select any of data series shown in the HydroDesktop Series Selection tool
  6. Click "Generate R code"
  7. Type the following command:  plotDataSeries(data0, "DataValues")    in the R-code window.
  8. Highlight a generated R code from a previous step then execute "Send Selection"
  9. The data series is shown in the R-graphics plot.
  10. Save R scripts as "hydroRresult.r"
  11. Click "Close R" button to close HydroR plugin.
  12. Close HydroDesktop
  13. Re-open HydroDesktop (select open existing project - Dry_Creek.dspx)
  14. Enable HydroR plugin then open a saved R script "hydroRresults.r".
  15. Click Start R.
  16. Click Send All.

Output

The output of this function should be:

a window showing the R time-series plot

...

 

 


HydroModeler

Procedure by Yoori Choi, 9/6/2011

(Jon Goodall)

(Data for this test are included with the installer.)

1. Go to HydroDesktop Help - Extensions - HydroModeler

2. Open an existing model and accessing the output data Run Tutorial 1 - Quick Start in HydroModeler help

3. Creating and running a model configuration               Run Tutorial 2 - Creating and running a model configuration

 

 


Web Map (Fetch Basemap)

 Procedure by Jiri Kadlec, 9/5/2011

Limitations:

  • The ESRI HydroBasemap and some other base maps display 'No Data' at a high detail zoom level

Testing procedure 1

  1. Ensure plugin is activated 
  2. Turn on the ESRI Hydro base map layer
  3. Change "Opacity" to 80 % 
  4. Zoom to Idaho state .

Output

The output of this function should be:

The ESRI HydroBasemap with borders of Idaho State and watershed regions visible. If the map layers contain a point layer, then the points should be above the Basemap layer in the legend.

 

Testing Procedure 2

  1. Ensure ESRI HydroBasemap is turned, opacity is set to 80 % and map is zoomed to "Idaho"
  2. In the application menu, select Save Project As
  3. Save the project as "basemap_test2.dspx"
  4. Close HydroDesktop
  5. Re-open HydroDesktop
  6. In the welcome screen, select Open Existing Project - basemap_test2.dspx

Output

The output of this function should be:

The ESRI HydroBasemap with opacity set to 80% is visible. The selected basemap in the drop down is "ESRI Hydro Basemap" and selected opacity in the drop down is "80%".


EPA Delineator

Procedure by Dan Ames, 9/1/2011

Limitations:

  • This tool only works for watersheds in the U.S
  • This tool doesn't find the watershed when the clicked point is more than 2 kilometers from an existing stream or river. When running the tool, switch on the Online Basemap "ESRI Hydro Basemap" layer, zoom in and click on a river or stream visible in the ESRI Hydro base map
  • Occasionally a "no point found" message is shown when the external EPA web service fails

HydroDesktop Project/Data to use for this test:

 Jacobs_Well_Spring.zip 

Testing procedure

  1. Ensure plugin is activated
  2. Open the project Jacobs_Well_Spring.dspx 
  3. Click the "Delineate" Button.
  4. Click near the site "Jacobs Well Spg nr Wimberley, TX

Output

The output of this function should be:

3 map layers (Watershed Point, Reaches, and Watersheds) in the map showing the watershed.


Metadata Fetcher

Procedure  by Jiri Kadlec, 10/3/2011
Testing  procedure 1
Run the tutorial Unpublished Web Services Tutorial - use the Service URL:
http://drought.usu.edu/SNOTEL/cuahsi_1_1.asmx

Help Files

Procedure by Jiri Kadlec, 9/23/2011 (updated by Yoori Choi, 10/5/2011)
Testing procedure 1:
  1. Select the Help tab
  2. Click User Guide
  3. Check that the table of contents includes the following items:
  • General concepts: WaterOneFlowService, Data Management, Search, Projects, Getting Help
  • Guide Books:        Search and download data, Table tab, Using the Orb, Working with Databases
  • Extensions:           EPA Tools, Fetch Basemap, HydroModeler, HydroR, Graph Tab, Edit View Tab, Metadata Fetcher
  • Version History
Testing procedure 2:
  1. Select the Help tab
  2. Click Forum
Output
The output of this function should be:
It will point to a "Discussion" tab from HydroDesktop Codeplex page (http://hydrodesktop.codeplex.com)
 
Testing procedure 3:
  1. Select the Help tab
  2. Click Issues
Output
The output of this function should be:
It will point to a "Issue Tracker" tab from HydroDesktop Codeplex page (http://hydrodesktop.codeplex.com)
Testing procedure 4:
  1. Select the Help tab
  2. Click About
Output
The output of this function should be:
The new window ("About HydroDesktop) will be popped up that shows the current version and web site of HydroDesktop.
Testing procedure 5:
  1. Select the Help tab
  2. Click Submit Comment
Output
The output of this function should be:
It will point to a "Contact Us" page from HIS project page (http://his.cuahsi.org) then you can use the form for questions, comments, or anything related to CUAHSI HIS.


 

Project Files

Procedure by Jiri Kadlec, 9/23/2011
Testing procedure 1 - Open Existing Project
  1. Download and unzip the attached file Czechia.zip.
  2. Open HydroDesktop
  3. In the welcome screen, Select Open Existing Project and click the Browse ... button.
  4. Select the file "Czechia.dspx" in the unzipped folder.
  5. Check that there are following layers in the map: Prague Climate Data, Online Basemap, Reservoirs, Rivers, Districts, Regions, Czechia
  6. Select the Graph tab. Check that there are 5 series in the selection tool (3 Precipitation series and 2 snow depth series). Select the first series to view the graph.
  7. Select the Table tab. The table shows the series.
  8. Select the Edit tab. The series is shown in the plot of the Edit View.

Testing procedure 2  - Save Project

  1. In the legend right-click on regions and select Labeling - label setup
  2. In Field Names list box, double click on NAME_1 and click OK. The labels of the regions are shown.
  3. In the application menu select Save Project As. Save the project as Czechia2.dspx.
  4. Close HydroDesktop
  5. Re-Open HydroDesktop. Select 'Open Existing Project' and double-click on Czechia2.
  6. Check that the labels of the regions are shown in the map.

 Testing procedure 3 - New Project

  1. In the file menu select New.
  2. A message "Save changes to existing project?" is shown
  3. Select Yes.
  4. All existing data layers are removed from the map and a new project is created.

 Interpolation - Kriging

Run the Interpolate Precipitation in a Watershed exercise 



 

HydroDesktop Tutorial

Run the HydroDesktop Tutorial - Jacob's Well exercise

 


Last edited Sep 24, 2012 at 12:52 PM by jirikadlec2, version 70

Comments

No comments yet.