View source for View Results in SMS 10.1 Archive


= Introduction =
In this page we will look at viewing TUFLOW results using SMS 10.1. This allows us to step through each output time and watch the flood as it progresses through the catchment. We will look at both scalar and vector data.

For information on SMS please visit the Aquaveo software website [http://www.aquaveo.com/sms-intro SMS Introduction].  If you do not have a licence for SMS a 30 day trial can be obtained.  To obtain a trial download the SMS 10.1 (full installation) from here [http://www.aquaveo.com/downloads Aquaveo Downloads].  After installation, upon starting SMS for the first time select "request evaluation".

= Opening Aerials =
SMS can handle aerial photos, SMS handles a variety of image formats (such as .ecw, and JPG). Images can be registered within SMS (see SMS tutorials / help for instructions). However, for this tutorial the registered images have been provided.
<ol>
<li>To open the aerial photo, from the menu toolbars select ''File >> Open'' and navigate to the '''Module_Data''' Folder. Select the '''Aerial_Photo_M01.jpg''' file and select open.  This can also be opened by dragging this file from Windows explorer onto the SMS window.</li>

You may be prompted to "Build Image Pyramids", this creates new images of the .jpg at a variety of resolutions for quicker redrawing. Select "Yes" if prompted.
</ol>
= Opening Results =

To view results in SMS we need at least two files open.  The first is the TUFLOW mesh, this contains information on the location, cells and elevations within the model.  This data is contained in a 2D Mesh (.2dm file).  Once this has been loaded the TUFLOW results can be loaded, the TUFLOW results can either be in either the .dat (1 results file format per output type) or .xmdf (one output file that contains all of the results).

TUFLOW also writes out a .sup file contains instructions for SMS to open the mesh first and the the TUFLOW results.
<ol>
<li> To open all of the TUFLOW results from the menu toolbars select ''File >> Open'' and navigate to the results directory (for the tutorial model, module 1 this is '''TUFLOW\Results\M01\2D\''' Folder) and open the relevant .sup file. For module 1 this is '''M01_5m_002.all.sup''' file. Once opened, the SMS view may (depending on defaults) look something like this. In the upper left is a project explorer, the TUFLOW results should now be listed here in Mesh Data. There should also be a list of available output times (every 5 minutes).<br>

[[File:SMS Introduction.png|750px|SMS Showing Aerial Photo and TUFLOW Results]]<br>

We have a large number of options for viewing results.  To change what is displayed in the Map Area open the Display Options Dialogue.

<li>To open the Display Options Dialogue, in the menu items select ''Display >> Display Options...''.<br>
'''TIP:''' The shortcut key to bring up the Display Options dialogue is Control + D.
In the Display Options dialogue, ensure that you are in the 2D Mesh module in the pane to the left. In the 2D mesh tab, you get a list of options ticking the check box will make an item visible.  Turn everything off, except for the mesh boundary and the contours.
</li>
[[File:SMS 10p1 Display Options.png|750px|SMS 10.1 Display Options]]<br>
</ol>

= Viewing Scalar Data =


To view the scalar dataset, ensure that the "contour" option is checked as per the image above. In the project window under Mesh Data is a list of the scalar and vector datasets available.<br>

Scalar datasets are indicated by the icon "123" and vector datasets have 2 arrows as the icon.  In the image is the full list of datasets for the TUFLOW tutorial model (Module 1).<br>

A number of datasets appear twice, for example Vel M01_5m_002 is available for viewing as a scalar dataset or a vector dataset (see next section).

An '''_max''' in the dataset name indicates that this in maximums throughout the simulation.  '''Dep M01_5m_002''' contains the time varying data and '''Dep M01_5m_002_max''' contains the peak depths. <br>

[[File:SMS 10p1 M01 Results Available.png|300px]]<br>
<br>
<ol><li>Select the '''Dep M01_5m_002''' dataset.</li>

<li> In the "'''Time Steps'''" window, select a timestep and use the up and down arrows to step through the results.</li>
</ol>

== Contouring Options ==
There are numerous options for controlling how the scalar results display (colour profile, contour increment, transparency).  This is controlled in the ''Contour'' tab in the Display Options dialogue. A brief guide is given below, feel free to experiment.
<ol>
<li>Bring up the Display Options dialogue, and select the "Contour" tab under 2D Mesh.</li>

<li>Under ''Contour Method'' select '''Color Fill''.<br>
'''TIP:'''''Normal Linear'' can be used to display contour lines only, and ''Color and Linear'' displays both contour shading and contour lines.</li><br>

[[File:SMS 10p1 Scalar Results Contouring.png|750px]]
<br>
Under "Color Ramp" you can choose the colour profile.  There are numerous options here, feel free to experiment.  I have chosen an ''Intensity Ramp'' varying from light blue to dark blue.

<li> Select a colour ramp to suit</li><br>
[[File:SMS 10p1 Colour Ramp.png|400px]]
<br><br>
In the ''Data Range'' section of the Display Options dialogue there is a summary of the minimum and maximum data values for the selected dataset.  For the TUFLOW Tutorial Model: Module 1, the results vary between 0.0 to 5.9 metres deep (approximately). A range can specified here, by checking the "''Specify a range''" option. I have set a upper range of 4.0 metres, anything above this depth will display in the upper contour range (dark blue).<br>
'''TIP:''' by specifying a range and un-checking "Fill Above" or "Fill Below" you can restrict the display range.  For example, setting a minimum of 0.1m and un-checking "Fill Below" any depths less than 0.1m will not be displayed.

A transparency can also be set in this dialogue, this can make the aerial photo visible beneath the contouring.
</ol>

= Viewing Vectors =
To turn on the vectors, navigate to the 2D Mesh tab of the Display Options (''Display >> Display Options''). Check the Vector item, as per the image below.
[[File:SMS 10p1 Display Options Vectors.png|frame|none]]
<br>
<ol>
<li>Select the '''Vel M01_5m_002''' vector item in the project window, scroll through the time steps to view the vectors at each output time.
</ol>
==Vector Display Options==
There are numerous option for controlling the size, shape and density of the vectors displayed. This page gives only a brief introduction, users are encouraged to experiment!<br>
To open the vector options, navigate to the Display Options, select the 2D Mesh in the left hand pane, and then select the Vectors tab, as shown in the image below.

[[File:SMS 10p1 Vector Options.png|frame|none]]
<br>
In this dialogue you can control:
*If the vectors are shown at each cell corner (Display: at each node) or on a regular grid (Display: on a grid).
*Vertical offset (Z offset)<br>
:'''Tip''' a value of greater than 0 ensures the vectors appear on top of the contours.
*The data range (use this to restrict values)
*Arrow size, this can be fixed length or scale length to magnitude<br>
:'''Tip''' scale length to magnitude is recommended for most result viewing
*Line width
*Colour
*Arrow head
<ol>
<li>Set the following (as per the image above):
*Display: to '''at each node''
*Shaft length: scale length to magnitude
*Ration: 15
<br>
Select Ok</li>

The map display should look like the image below.
[[File:Tute M01 SMS 10p1 Depth and Vector.png|frame|none|Depth and Velocity at time 1:15]]
<br>
</ol>

=Advanced=
For more information on viewing results in SMS, please see the [[SMS_Tips | SMS Tips]].<br>
For those progressing through the Tutorial Module 1, you can return to the tutorial module [[Tutorial_Module01_Archive#Reviewing_Model_Performance | here]].