Difference between revisions of "Ensight Tips"

From Tuflow
Jump to navigation Jump to search
 
(26 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
=Introduction=
 
=Introduction=
  
Ensight is 3D Computational Fluid Dynamics (CFD) result viewing software developed by CEI Inc. The software can be downloaded from the <u>[https://www.ceisoftware.com: CEI website]</u>.
+
Ensight is 3D Computational Fluid Dynamics (CFD) result viewing software developed by CEI Inc. The software was bought by Ansys, and can be downloaded from the <u>[https://www.ansys.com/products/fluids/ansys-ensight Ansys website]</u>. This page contains a brief introduction to the software for the purpose of viewing and analyzing TUFLOW results. For more advanced user tutorials, see <u>[https://www.ansys.com/training-center Ensight Tutorials]</u>.<br>
  
This page contains a brief introduction to the software for the purpose of viewing and analyzing TUFLOW results. More advanced user tutorials are available via the CEI website. <u>[https://www.ceisoftware.com/tutorials/: Ensight Tutorials]</u>.
 
  
If you have any suggestions to be included in these pages, please add them to the discussion page: [[Talk:Ensight_Suggestions | Ensight Suggestions]]<br>
+
[[File:Ensight_030.png|600px]]<br>
  
= Viewing Results =
+
=Common Tasks=
== Data Preprocessing ==
+
* [[Ensight_Data_Preprocessing | TUFLOW Data Pre-preprocessing Requirements]]
Ensight requires an input file format which is different to the standard TUFLOW output types. RES_to_RES.exe is used to convert TUFLOW xmdf results into an Ensight compatible form. Directions how to do this are outlined here: [[RES_to_RES |RES_to_RES.exe]]
+
* [[Ensight_Data_Loading | Data Loading]]
 
+
* [[Ensight_Navigation | Navigation Tips and Shortcut Keys]]
The utility will create the following three ensight file types:
+
* [[Ensight_Point_Time_Series_Plot | Point Time Series Plots]]
# Ensight case file;
+
* [[Ensight_Line_Longsection_Plot | Long-profile Plots]]
# Ensight geometry file;
+
* [[Ensight_Background_Image | Loading a Background Image]]
# Ensight results files. A unique file is created for each result output variable and time step.
+
* [[Ensight_Animation | Creating an Animation]]
 
 
Ensight is a 3D computational fluid dynamics viewing software. An elevation dataset is required to lock the 2D TUFLOW results to a fixed horizontal plan (2D space). The TUFLOW model output result data type ''ZH'' is required for this purpose. This must first be specified as a TUFLOW command prior to running the simulation. Steps required to flatten the dataset are outlined in the flowing section, "Loading Data" <br>(eg. ''Map Output Data Types == h v q d <b>ZH </b>)''
 
 
 
== Loading Data ==
 
Run the TUFLOW utility RES_to_RES.exe to create the Ensight input data files from TUFLOW xmdf output.<br>
 
Open the case file (*.case) in Ensight.
 
 
 
[[File:Ensight_001.JPG|800px]] <br><br>
 
 
 
This will load the 'Part' titled: ''2D TUFLOW Elements'' as Case Item 1.
 
 
 
[[File:Ensight_002.JPG|800px]]<br><br>
 
 
 
Select the "Variables" tab within the data management window (bottom left) to view the model result scalar and vector datasets that were loaded.<br>
 
Activate the relevant dataset that you would like to work with. In this example we have selected, Depth, Unit Flow, Velocity and Water Level.
 
 
 
[[File:Ensight_003.JPG|400px]]<br><br>
 
 
 
These results can be viewed by creating an isosurface of the dataset within the ''2D TUFLOW Elements'' Case Item.
 
 
 
Right Click ''2D TUFLOW Elements''
 
Select >> Create >> Isosurfaces
 
 
 
[[File:Ensight_004a.JPG|800px]]<br><br>
 
 
 
Within the isosurfaces window:
 
# Select 'Advance' (top right)
 
# Enter a unique name for the dataset. This will become the child Part name. (''2D TUFLOW Elements'' is the parent Part title)
 
# Select the ''Variable'' you would like to visualize (e.g. Depth)
 
# Set ''Creation Type'' = Isovolume
 
# Set ''Constraint'' = Banded
 
# Define the isovolume range. The upper and lower extreme values for the datasets are listed within the variables table (bottom left of the interface)
 
 
 
[[File:Ensight_005.JPG|300px]]
 
[[File:Ensight_005a.JPG|800px]]<br><br>
 
 
 
Update the variable display contouring:
 
# Select the newly created Part (right click)
 
# Select ''Color by >> Select Variable''
 
# When contouring, select the relevant maximum dataset. For example, for time varying ''Depth'' data, select ''Max_Depth''. This will lock the contouring to the range of the maximum dataset. Block colors and transparencies can also be defined using this selection. 
 
 
 
[[File:Ensight_006.JPG|800px]]<br><br>
 
 
 
The colour palette can be modified by selecting the defining dataset within the variable list: <br>
 
Right Click >> Edit Palette <br>
 
[[File:Ensight_017.JPG|600px]]<br><br>
 
 
 
The final visualization step requires that the parent Part, ''2D TUFLOW Elements'' be flattened. Ensight is a 3D computational fluid dynamics viewing software. Flattening the parent Part locks the TUFLOW dataset to a fixed horizontal plan (2D space).
 
# Select the parent Part, ''2D TUFLOW Elements'' (right click)
 
# Select Edit
 
# Set the Coordinates scale factor = <b>-1</b> *variable
 
# Set the Z variable = <b>''Fixed_Bathymetry''</b>. For this option to be available, the model result data type ''ZH'' must be defined as a TUFLOW output  (eg. ''Map Output Data Types == h v q d <b>ZH </b>
 
 
 
[[File:Ensight_007.JPG|800px]]<br><br>
 
 
 
Time series controls are located above the Parts window (top left).<br>
 
[[File:Ensight_008.JPG|400px]]
 
 
 
==Navigation Tips and Shortcut Keys==
 
 
 
<u><b>Left Mouse Button </b></u><br>
 
Holding the left mouse button whilst navigating in the viewport (graphics display)
 
*Navigating mouse up-down = rotate about horizontal screen X-axis
 
* Navigating mouse left-right = rotate about vertical screen Y-axis
 
* Ctrl-key plus up-down or left-right navigation = rotate about Z-axis extending outward from the screen <br>
 
 
 
<u><b>Right Mouse Button </b></u><br>
 
Holding the right mouse button whilst navigating in the viewport (graphics display)
 
* Navigating mouse up-down or left-right = Model zooms in and out
 
* Ctrl-key plus right button acts as a pan operation <br>
 
 
 
<u><b>Middle Mouse Button (Scroll)</b></u><br>
 
* Model zooms in and out <br>
 
 
 
<u><b>Shortcut Keys </b></u><br>
 
F1 - Window will rotate about the screen X-axis by 45 degrees <br>
 
F2 - Window will rotate about the screen Y-axis by 45 degrees <br>
 
F3 - Window will rotate about the screen Z-axis by 45 degrees <br>
 
Ctrl F1, F2, F3 rotates by -45 degrees about the screen axes <br>
 
 
 
F4 - Spins the window – (try with the left mouse click) <br>
 
F5 - Front view <br>
 
F6 - Side view <br>
 
F7 - Top view <br>
 
F8 - Will return to last view before F5, F6 or F7 was pressed <br>
 
F9 - Maximizes the graphics windows on the display; press F9 again or use Esc to go back <br>
 
 
 
=Data Calculations (Variable Calculator)=
 
The calculator provides a powerful capability to derive new variables from existing variables and parts in the current data set. <br>
 
Click the Variable Calculator icon to display the calculator.
 
 
 
To be continued...
 
 
 
=Loading a Background Image=
 
Background Images can be registered and added to a display.
 
 
 
The utility ''"Align Photo"'' is required to do this. This option is not available within the basic Ensight package. CEI Inc. should be contacted so that this utility can be added to your user define tools list.<br>
 
 
 
 
 
Steps to load aerial imagery are:
 
*Select the Part which you would like to to apply the photo to.
 
*Double Click the “Align Photo” button from the user define tools list.
 
[[File:Ensight_013.jpg|150px]]<br>
 
* A dialog will appear, asking you to select the Image File, and the corresponding World Coordinates File. Select the “Relative Position” option (EnSight models are currently stored in relative coordinates).
 
* Enter the Image File and World File.
 
[[File:Ensight_014.jpg|300px]]<br>
 
* Select "OK".
 
* Select "Xref" and Yref" for the offsets.
 
[[File:Ensight_015.JPG|400px]]<br><br>
 
[[File:Ensight_012.jpg|600px]]
 
 
 
=Result Long-section Plot=
 
Create a clip line in the location where you would like to extract results.
 
 
 
* Select the clip line icon <br>
 
[[File:Ensight_016.JPG]]
 
* Relocate the clip line. Selecting the centre is used to shift the location of the clip line. Selecting the start or end of the line can be used to alter the line extent.<br>
 
[[File:Ensight_018.JPG|500px]]
 
* Select the parent Part ''2D TUFLOW Elements''
 
* Right Click >> Create >> Clips
 
* Name the Clip
 
* Select Tool = <b> Line </b>
 
* Select Extents = <b> Finite</b>
 
[[File:Ensight_019.JPG|300px]]
 
* Deselect the clip line tool.<br>
 
[[File:Ensight_020.JPG]]<br>
 
*The clip should now remain within the view window and also show in the list of Parts <br>
 
[[File:Ensight_021.JPG|400px]]<br>
 
 
<br>
 
<br>
 
+
{{Tips Navigation
Variables need to be associated with the clip:
+
|uplink=[[Main_Page| Back to Main Page]]
* Select the clip part (left click the Part)
+
}}
* Select query [[File:Ensight_023.JPG]]<br>
 
* Select Sample = <b> 1D part over distance</b>
 
* Select the desired variable. For example ''Depth'' or ''Water_Level'' <br>
 
[[File:Ensight_022.JPG|300px]]<br>
 
*This dataset will be added to the Plots/Queries window, and also to the display window. Double click the graph in the display window to update the graph display options (colors, labels, titles etc.).
 
[[File:Ensight_024.JPG|450px]]<br>
 
[[File:Ensight_025.JPG|450px]]<br>
 
 
 
=Creating an Animation=
 
Ensight can be used to present spatial and time series datasets dynamically within the same animation.
 
 
 
[[File:Ensight_011.JPG|400px]] <br><br>
 
 
 
# Select  ''File>>Export>>Animations''
 
# Select ''Set format''
 
# Select ''MPEG Movie''
 
# Adjust the frame rate as appropriate
 
# Select ''Play'' and ''Reset''
 
# Within ''Advanced Options'', set the window type to ''Normal''
 
# Select an appropriate output location and filename
 
 
 
[[File:Ensight_010.JPG]]
 

Latest revision as of 11:11, 5 April 2024

Introduction

Ensight is 3D Computational Fluid Dynamics (CFD) result viewing software developed by CEI Inc. The software was bought by Ansys, and can be downloaded from the Ansys website. This page contains a brief introduction to the software for the purpose of viewing and analyzing TUFLOW results. For more advanced user tutorials, see Ensight Tutorials.


Ensight 030.png

Common Tasks


Up
Go-up.png Back to Main Page