The Spatial Results Toolbar provides options to visualize results for Basin Models that have been created using GIS Features (Georeferenced Elements). Spatial results must be turned on within the Simulation Run's Component Editor. Spatial results should be turned on after preliminary calibration has been completed. Use of spatial results can assist in the calibration process and provide additional information about the simulation. If you make edits to the basin geometry, edit model parameters, or change the simulation configuration, the spatial results will be automatically re-computed during the simulation.

The following figure shows the Spatial Results Toolbar along with Snow Water Equivalent (SWE) results displayed on top of the Basin Model. The Spatial Results toolbar includes options for Selecting Output Results, an Animation Toolbar, Buttons for Controlling the Animation, Max and Min buttons, a display settings button that opens an editor with options for animation, symbology, and display settings, and buttons to export an animation and/or snapshot file. 

Displaying Spatial Results

When a valid spatial result is selected, a tool tip containing the value and units for the specific time step and grid cell over which the mouse is hovered will be displayed, as shown in the following figure.

A tool tip containing the value and units for a specific time step while hovered over a grid cell

When a valid spatial result is selected, the Plot Spatial Results option is available from its context menu for tabulating the results for the specific grid cell which was clicked, as shown in the following figure.

Requirements for Spatial Results

Graph results from a specific grid cell

A Georeferenced Basin Model (Subbasin Elements must be georeferenced) is required to utilize spatial results. A Georeferenced Basin Model can be created using the GIS Tools to delineate elements from a Terrain Model. Another option to georeference a Basin Model is to use the Georeference Existing Elements or Import Georeferenced Elements tools from the GIS menu. These two tools use geographic information in shapefiles to georeference Subbasin Elements. 

Spatial results can be visualized at the subbasin level, spatially averaged for the subbasin, or across the model domain using the Discretization Method chosen for the subbasin elements (Structured Discretization or Unstructured Discretization). Spatial results will be displayed at the Grid or Mesh Level when the Transform Method is either ModClark or 2D Diffusion Wave and the Structured, Unstructured, and File-Specified *.sqlite, *.HDF5, and *.HDF Discretization Methods are selected. Gridded spatial results cannot be visualized for Subbasin Elements using the ModClark file option (under the File-Specified Discretization Method). Instead, results will be displayed as a subbasin average value when the *.mod File option is used for the File-Specified Discretization Method. Spatial results will be displayed at the Subbasin Level when Transform Methods other than the ModClark or 2D Diffusion Wave Transform are used.  

Activate Spatial Results

Spatial results can be displayed for both Simulation Runs and Forecast Alternatives. Spatial results must be activated in the Simulation Run's Component Editor, as shown below. You can also set the Time Interval for spatial results. The simulation time-step is used as the default interval. Spatial results are saved to an HDF5 file within the project's Results directory; results are saved to an *.H5 file. Turning on spatial results will add additional time to the simulation due to additional output being generated and saved to disk. The additional time can be up to 1/3 of the simulation time without spatial results activated.

The very first time an Output Result is selected in the Spatial Results Toolbar, the program will process the simulation HDF5 and build animation tiles for display. A message will pop up the very first time the output HDF file is processed indicating animation tiles are being created. The time it takes to build the animation tiles can be large for larger model domains; however, the processing is only required the very first time spatial results are displayed. The display time for subsequent simulations will be much quicker because animation information already exists. 

Activating spatial results through the Simulation Run Component Editor 

Spatial Results Toolbar

As shown in the figure below, the Spatial Results Toolbar is configured to 1) Select an Output Result to Visualize, 2) Control the Animation, and 3) Edit the Display and Animation Properties. Results that can be animated include Meteorologic Results, Snow Modeling Results, and Precipitation Excess and Loss. Hydraulic Depth, Water Surface Elevation, and Cell Velocity can be displayed for subbasins that use the 2D Diffusion Wave Transform Method. Statistical metrics comparing observed and computed data, if specified, will be available as well. A full list of spatial variables is provided below:

List of Spatial Variables

Incremental PrecipitationPrecipitationAll Precipitation Methods
Cumulative PrecipitationPrecipitationAll Precipitation Methods
Air TemperatureSnow

All Snow Methods

Atmospheric PressureSnow

RTI/Hybrid and Energy Balance

Wind SpeedSnow

RTI/Hybrid and Energy Balance

Humidity/Dew Point


RTI/Hybrid and Energy Balance

Longwave Radiation


RTI/Hybrid and Energy Balance

New Shortwave Radiation


RTI/Hybrid and Energy Balance

SWE (Snow Water Equivalent)Snow

All Snow Methods

AlbedoSnowEnergy Balance
ATI (Antecedent Temperature Index)SnowRTI/Hybrid
Cold ContentSnowTemperature Index
Cold Content ATISnowTemperature Index
Heat DeficitSnowRTI/Hybrid
Liquid Water ContentSnowAll Snow Methods
Melt Rate ATISnowTemperature Index
Pack EnergySnowEnergy Balance
Pack TemperatureSnowEnergy Balance
Pack CondensationSnowEnergy Balance
Pack SublimationSnowEnergy Balance
Snow DepthSnowRTI/Hybrid and Energy Balance
Surface TemperatureSnowEnergy Balance
Solar Shading CoefficientSnowRTI/Hybrid and Energy Balance
Incremental LossLossAll Loss Methods
Cumulative LossLossAll Loss Methods
Incremental ExcessLossAll Loss Methods
Cumulative ExcessLossAll Loss Methods
Water Surface ElevationTransform2D Diffusion Wave
Hydraulic DepthTransform2D Diffusion Wave
Cell VelocityTransform2D Diffusion Wave
Bed Change (Total)Sediment Transport2D Sediment
Bed Change - ClaySediment Transport2D Sediment
Bed Change - SiltSediment Transport2D Sediment
Bed Change - SandSediment Transport2D Sediment
Bed Change - GravelSediment Transport2D Sediment
Sediment Concentration (Total)Sediment Transport2D Sediment
Sediment Concentration - ClaySediment Transport2D Sediment
Sediment Concentration - SiltSediment Transport2D Sediment
Sediment Concentration - SandSediment Transport2D Sediment
Sediment Concentration - GravelSediment Transport2D Sediment
Snow - NSESnowAll Snow Methods w/ Observed Data

Snow - PBIAS

SnowAll Snow Methods w/ Observed Data
Snow - R2SnowAll Snow Methods w/ Observed Data
Snow - RSRSnowAll Snow Methods w/ Observed Data
Flow - NSEAllAll Methods w/ Observed Data

Flow - PBIAS

AllAll Methods w/ Observed Data
Flow - R2AllAll Methods w/ Observed Data
Flow - RSRAllAll Methods w/ Observed Data

Spatial Result Controls

The animation can be controlled through the Animation Control Slider Bar and Buttons. The slider bar can be manually dragged right or left to advance or reverse results. The animation control buttons include a button to go to the beginning of the animation, move forward one time interval, pause the animation, reverse the animation one time interval, and go to the end of the animation. 

Legend, Scale Bar, and North Arrow

A Legend, Scale Bar, and North Arrow can now be displayed within the Desktop when a valid spatial result is selected.  These options can be enabled/disabled through the View menu, as shown in the following image.

Draw Legend, Draw North Arrow, and Draw Scale Bar View Menu Options

Legend, Scale Bar, and/or North Arrow Properties can be edited by right clicking on the item of interest within the map and selecting Edit PropertiesPlacement, Fill, and Border options can be adjusted, as shown in the following image.  Additionally, the North Arrow can be displayed relative to True North (default) or Magnetic North when editing the North Arrow Properties.

Edit Legend Image Properties

Max/Min Buttons

The Max and Min buttons allow for quick visualization of the minimum or maximum of any spatial result regardless of the time in which they were achieved.  When selected, these buttons will be shown with a white background, as shown in the following image.

Displaying Maximum Values

Export Animation and Snapshot Buttons

The Export Animation and Export Snapshot button can be used to export the current spatial result to be viewed within another application.

Export Snapshot

The Export Snapshot button enables the user to export the currently selected spatial result as a single or sequence of rasters to a DSS, GeoTIFF, or ASCII fileUpon clicking this button, a dialog will appear allowing the user to export a single grid or a series of grids, a start date and end date (if exporting a series of grids), a destination file type, and a destination file name, as shown in the following figure.

A ".dss", ".tiff", or ".asc" extension should be used when exporting to DSS, GeoTIFF, or ASCII, respectively.

Export Snapshot Dialog

The resultant output files will be georeferenced and can be read by other applications (e.g., HEC-RAS, QGIS, ArcGIS, etc).

This feature is commonly used to export a sequence of excess precipitation grids (i.e., the amount of water that isn't infiltrated) for use in 2D HEC-RAS simulations.

Export Animation

The Export Animation button enables the user to export an animation of the currently selected spatial result.  Only the MP4 file format is currently supported when exporting animations.

To export an animation, a spatial result must be currently playing (i.e., click the green arrow button).

The animation export process can be started by clicking the Export Animation button (this will be the start time) and finished by clicking the button again (this will be the end time)Upon clicking the Export Animation button for a second time, a dialog will appear allowing the user to specify the location and name of the output, as shown below.  The resultant animation will also include any currently displayed maps (e.g. subbasin outlines, reservoir icons, terrain, etc) and can be opened within common media players (e.g. Windows Media Player, Microsoft PowerPoint).

Export Animation Dialog

Display Settings

The Display Settings editor can be opened by clicking the Gear icon located on the right side of the Spatial Properties Toolbar. The figure below shows the Playback tab in the Display Settings editor. You can change the Frame Rate to control the speed of the animation. There is check box to control whether the animation is looped or not. 

Setting whether the animation is looped or not in the Display Settings

The figure below shows the Symbology tab. When the Stretch Symbology option is selected, you can edit the Max and Min values and the Color Scheme

Editing the Max and Min values and Color Scheme

The figure below shows how the Symbology editor is configured when the Classify Symbology option is selected. There are three methods to choose from to subdivide classes, Natural Breaks (Jenks), Equal Interval, and Manual. You can overwrite the Max and Min values when the Equal Interval option is selected. You can edit the Upper values in the Classes table when the Manual method is selected. The Number of Classes can only be edited when the Natural Breaks (Jenks) or Equal Interval methods are chosen. You can edit the Color Scheme by choosing a palette from the drop down list, you can also edit individual colors by clicking on them in the Classes table. Finally, Labels can be manually edited if needed.  

Using the Classify Symbology option

The figure below shows the Display tab. You can control the Transparency setting, and whether to apply hillshading or to invert the color ramp. 

Setting transparency and whether to apply hillshading or inverting the color ramp

The Apply button must be pressed after edits are made to the display settings, then press the Close button to close the editor.