1. …Analyze, Visualize, Communicate… EnSight For Barracuda Short Introduction Training Kevin Colburn, CEI

2. …Analyze, Visualize, Communicate… Agenda Short Intro to EnSight – General Layout – Dataset Loading – Basic Part Coloring/Settings – Part Creation Basics (Clips) – Calculator Functions – Viewport Basics – Flipbook basics – Saving out animations – Saving out EnLiten Extra Credit: – Filtering – Query/Plotter – Where to get ESB from – BVR Tools (Use, Download, Construction)

3. …Analyze, Visualize, Communicate… What is EnSight? General Purpose Post Processing software for all CFD/FEA/CAE simulation results. ~50 direct reader formats, with many more exporting to our format Market leading animations, data interaction, feature set. Extensive scripting & batch operation Multi-case comparisons, parallel processing, 3D stereoscopic displays, many more..

4. …Analyze, Visualize, Communicate… EnSight For Barracuda (ESB) EnSight Standard for Barracuda (ESB) – All features/capabilities of EnSight Standard, apart from single reader format (barracuda). – Identical EnSight download/installation (same program). – License file restricts the readers to the single barracuda reader. – Can run scripts (either journal files or Python based) – Can be run in Batch – Utilizes up to 8 threads on server and client. Contact CEI software for more information (sales@ceisoftware.com)

5. …Analyze, Visualize, Communicate… GUI Layout Main Menu Time Control Part Lists Variable Lists Feature toolbar Ribbon Quick Access Ribbon Graphics Area (Viewport) Tool Ribbon Status Other Object Lists

6. …Analyze, Visualize, Communicate… Loading Data File -- > Open Navigate to the example dataset used during training. Select on one of the “Gmv.*” files. Check: – The “Set Input File” is pointing to this file. – The Format is changed to Barracuda Click on “Load All Parts” Tut. 1, Step 1

7. …Analyze, Visualize, Communicate… Model Loaded: Parts, Variables, Views “Parts” are either “Model” (read in from the solver file), or “Created” (created within EnSight). – Part Visibility can be toggled from the “Show” Column checkbox. Variables are either “Model” (read in from solver), or “Created” (from calculator in EnSight). – Variables are grouped automatically into scalar, vector, tensor, constant, etc. Freeform view manipulation done via mouse button (rotate, pan, zoom), or via presets in the view control.

8. …Analyze, Visualize, Communicate… Part Coloration/Modification Let’s turn the visibility of these parts “OFF”: none, flag3, FixPlane, Transien, Cells – Hint: Toggle Visibility of these parts off. Let’s Color the “Particles” via VolFrac – From the Scalar Variable List, drag the “VoldFrac”, and drop onto the “Particles” Part in the Part List. Tut. 1, Step 2

9. …Analyze, Visualize, Communicate… Particle Display By default, particles are displayed as “dots”. – Quick/low overhead; Sufficient when viewing lots of particles. Particles can viewed as Cross or Spheres (suggested) – Scaled (size factor) – Sized by constant, scalar, vector All can be colored by any available variable.

10. …Analyze, Visualize, Communicate… Creating Parts Items like Clips, IsoSurfaces, Contours, Streamlines, are “Created” Parts. Method: – Select the Parent Parts (from which these created parts are created ‘from’). – Use Icons along top of EnSight, or Right Click -- > Create “Created” Parts can then be colored, interrogated, calculated upon, displayed as you can do with “Model” parts.

11. …Analyze, Visualize, Communicate… Create Clip Through Domain Let’s Create a clip through the “Cells” domain, in a constant Z direction. – Right Click over the “Cells” Part in the Part List – Select “Clip” -- > Z clip A Mid-range Z clip is created. Tut. 1, Step 3

12. …Analyze, Visualize, Communicate… Adjusting Created Parts Quick modification: – Left single click on the part in the Viewport to obtain this “move handle” – Then hold down the left mouse button and drag up/down/right/left to adjust the location of the clip (or value of other created parts). Exact modification: – Double click on the Part in the Part Object List (or Right Click -- > Edit). – The “Feature Detail Editor” for the part is open, and you can adjust all of the attributes for the created part.

13. …Analyze, Visualize, Communicate… Color Clip with Temperature To Color the clip by Temperature (variable name is “f_Temp”), use the same method as we did for coloring the particles. – Drag the “f_Temp” variable from the variable list and drop it on the “clip plane” part – Alternatively, right click on the clip_plane, and select Color -- > variable -- > f_temp Tut. 1, Step 4

14. …Analyze, Visualize, Communicate… Calculator Function Basics Calculate new variables based on variables read in from solver. – Constants, Scalars, Vector, Tensor math – Generic Math functions (ABS, SIN, GT, LOG, etc) Calculate new quantities from the field variables. – Custom operations (integration, Min/Max, FlowRate, Mean, Temporal Means, etc) The Part(s) that you have selected when performing the calculation will serve as the “parent” to the equation. (ie Min(pressure) will determine the minimum value of pressure for the part(s) selected. Two main tabs in the Calculator : “PreDefined Functions” (like Min, Max, Integral, etc), and “User Defined” (open for user to define). All variables are updated as part is updated (moved/changed), or time is updated. We’ll introduce the Calculator to convert “f_Temp” from Kelvin to Fahrenheit by creating a new variable.

15. …Analyze, Visualize, Communicate… Create Temp_deg_F Select the All of the parts – Hint: Select the “Case1” heading in the Part Object List. Click on the Calculator Icon. Click on the “User Defined” tab. Define the variable name (eg Temp_deg_F) Type in the equation to convert the f_temp from Kelvin to Fahrenheit Click on “Evaluate for selected Parts” Color the Clip_Plane part by this new variable. (same as before) Tut. 1, Step 5

16. …Analyze, Visualize, Communicate… Adjust Range of Variables By default, EnSight’s Legend Range is that of the complete dataset. (Some parts have “undefined” values or “zero” values, which is not useful for visualization). – In the Variable Object List, Right Click on the variable “Temp_deg_F”, and select “Edit”. – Adjust the Min and Max values for the legend range (alternatively, pull down menus just below that can be used). Tut. 1, Step 6

17. …Analyze, Visualize, Communicate… Viewport Basics Viewports are the visual area used to render the image(s). There can be up to 16 viewports, allowing multiple views of the data. Parts have a “Visibility Per Viewport” setting allowing part(s) to have different visibility per viewport. Right Click in the Viewport -- > New or PreDefined layout (2x2 matrix, or 3x1 matrix, etc). We would like to create a 2x1 viewport to view two different variables at once. We will also use the “Visibility per Viewport” to visualize different entities (parts) in different viewports.

18. …Analyze, Visualize, Communicate… Create 2 Viewports Right Click in the Viewport, and select “Viewports -- > 2 Vertical“ Right Click in the Viewport, and select Viewports -- > Link All – This will link the view orientation/center/distance for all of the viewports. Tut. 1, Step 7

19. …Analyze, Visualize, Communicate… Create Copy of Clip Part Select the Clip Plane in the Part Object List Under the Top window Edit, Select Edit -- > Part -- > Copy. – This creates a copy of the clip part. Use the Visibility Per Viewport option to show the Clip Part in the Left Viewport, and the “Copy” only in the Right Viewport. Drag the Variable CO_nf onto the “Copy” part to visualize the mass fraction. Per-Viewport Visibility shown in left only Tut. 1, Step 8

20. …Analyze, Visualize, Communicate… Check of EnSight Two viewports Particles colored with VolFrac Clip Plane visible in left viewport, and Copy Clip visible in Right viewport. Clip colored with Temp_deg_F and Copy with CO_nf

21. …Analyze, Visualize, Communicate… Annotation Basics Text Annotations, Legends, Logos, etc. are considered “Annotations”. Placing a title annotation is done simply via Right Click in the Viewport, and Quick Annotation. Legends can simply be selected with left mouse button and drag to location. Handles on Annotations allow resizing, moving, key operations. (just move mouse over the legend to have then appear). Tut. 1, Step 9

22. …Analyze, Visualize, Communicate… Logo Insertion Logos are considered an annotation, and their details are contained within the “Annotation” tab on the lower left of EnSight. To insert a Logo, you can simply drag/drop the file from a Windows Browser into the viewport. Alternatively, you can right click in the Annotation tab, and select Create -- > Logo. Tut. 1, Step 10

23. …Analyze, Visualize, Communicate… Play through Time (stream from disk) By default, EnSight plays transients by streaming from disk (i/o intensive, RAM savvy). Users can control the timestep bounds. For interactive use through long transients, set the “timestep increment” to 5 of 10 to stride data. Adjust the timestep increment to 10, then play through time to watch solution progress. (Play button in Time control) Tut. 1, Step 11 Hint: Click on the Display time Annotation to get an annotation for current time.

24. …Analyze, Visualize, Communicate… Saving Animation Saving images or animations is done via File -- > Export. Use the “Set Format” to choose your desired format (AVI is good). Toggle on the “Solution Time” “Play” and “Reset” options. Number of frames should default to 51 if you have set your 500 timestep solution to have a timestep stride of 10. Specify a file prefix (default directory is current directory on Linux, or $HOME/My Documents in Windows. Click on Ok. Tut. 1, Step 12

25. …Analyze, Visualize, Communicate… Play through Time (cache) EnSight can cache this play through time to memory (avoid streaming from disk). Playback is much quicker, but at the expense of memory used. Useful for more interactive play through time (still zoom/pan/rotate). Required for saving to EnLiten (next step) Click on the Flipbook Icon. Only default setting that needs adjusting in the “flipbook increment”, which should be set to 10. Click on Load. Now you have a Flipbook tab playback control. Tut. 1, Step 13

26. …Analyze, Visualize, Communicate… Saving Scenario (EnLiten) Our “scenario file” is a format which allows saving of the geometry+solution for playback. Like an animation, but allows: – Pan/zoom/Rotate – Part on/off or color changes. Viewer is called “EnLiten”. – No license required – Can be embedded with scenario file into a single ‘self-contained’ viewer+file. Based off from flipbook creation (last step). File -- > Export -- > Scenario. Tut. 1, Step 14

27. …Analyze, Visualize, Communicate… Saving your work Several different methods, depending upon the intended use: – File -- > Save -- > Commands from this session. For replay/adjustment, start of scripting/automation. – File -- > Save -- > Context Final state only. Can be applied to other “similar” datasets. – File -- > Save -- > Session Final state only. For restoring same dataset to same location.

28. …Analyze, Visualize, Communicate… Get More Information We touched upon ~1% of what EnSight can do. Lots more we did not cover. Self Help is best obtained via Help -- > HowTo. Online Video Tutorials : www.ceisoftware.com/tutorials/ Detailed description : Help -- > User Manual Contact CEI – Email: support@ensight.comsupport@ensight.com – Tel: 1-800-551-4448

29. …Analyze, Visualize, Communicate… EXTRA CREDIT ITEMS EC : Extra Credit

30. …Analyze, Visualize, Communicate… Filtering out Data Multiple methods to filter out data (either graphically and/or computationally). Limit Fringes – Based on legend range (does not display items above max or below min); Graphics only; single variable. Variable Opacity. – Based on changing transparency based on variable value. Graphics only; single variable; mid-range capable. Element Filtering. – Based on filtering data when read into EnSight. Both graphics and computation; multiple variable; Boolean operations (and/or). EC - Filtering

31. …Analyze, Visualize, Communicate… Filtering – Limit Fringes Palette Editor -- > Options -- > Limit Fringes – Entities outside of the ColorBy range are not displayed. – Only works on the ColorBy variable. – Only filters out below min and above max (no internal range filtering). Pros: – Quick Cons: – No reduction in memory or speed. – Only single variable, and must be colored by that variable. EC - Filtering

32. …Analyze, Visualize, Communicate… Filtering – Opacity Rendering Color By -- > Alpha by Palette Editor -- > Advanced -- > Adjust Transfer Function Uses Transparency to highlight/hide Pros: – Varying across variable range Cons: – Single variable, must be colored by – Visual only. Expensive transparency. EC - Filtering

33. …Analyze, Visualize, Communicate… Filtering – Element Filtering Element Filtering Icon Specify variable;,=; constant or another variable. Should would filter OUT elements with ResTime > 5.0 Combine multiple filters (and/or) Filtering Elements OUT. EC - Filtering

34. …Analyze, Visualize, Communicate… Queries & plotters Queries are 2D array of values (distance vs variable, time vs. variable). Plotters are the visualization of queries to the screen. Queries are typically dynamic, so as the dependent variable is changed, the query and plotter automatically update. Many query and plotter customizations are available. – Switch x and y axis – Plot two different variables vs. time/distance – Auto layout – Style manager, i.e., copy/paste plotter/curve attributes Copy to clipboard (paste to Excel) EC - Query

35. …Analyze, Visualize, Communicate… Queries – Basic Create Right Click over a 1D part (Line Tool, Clip, etc.) and automatically generate query and plotter. Right Click over a Constant variable in a transient case to automatically plotthat variable as a function of time. Right Click over any Spatial variable in transient case and automatically plot min or max vs. time. EC - Query

36. …Analyze, Visualize, Communicate… BVR Tools BVR Tools: A custom set of python-based macros to perform operations with Barracuda-type data. User Customizable; Initiated by CEI to demonstrate extra capability/customization. Currently : Contact CEI to obtain these tools. EC – BVR Tools

37. …Analyze, Visualize, Communicate… Macros to read in FLUX and trans files The FLUX_? and trans.dat00 files lend themselves well to being operated on within EnSight. Python utility to parse the files, and import as Queries. Display single queries or multiple queries on single plot. Operate between queries. Integrate into the 3D domain visualization and presentation. EC – BVR Tools

38. …Analyze, Visualize, Communicate… FLUX_? Files import Macro utility to convert FLUX_? files into EnSight Queries. UserDefinedTools -- > BVR Tools -- > Import Flux_File Specify the File to import Will take ~10-15 seconds to convert all data and read into EnSight as a series of Queries Now display, operate, integrate with 3D results EC – BVR Tools

39. …Analyze, Visualize, Communicate… Trans.dat00 File import Macro utility to convert “trans.dat00” files into EnSight Queries. UserDefinedTools -- > BVR Tools -- > Import Trans.dat00 Specify the File to import Will take ~10-15 seconds to convert all data and read into EnSight as a series of Queries Now display, operate, integrate with 3D results EC – BVR Tools

40. …Analyze, Visualize, Communicate… BVR Tool : Query Import You now have all of this 0D data available for use in EnSight. Synchronized with the play of the transient domain. EC – BVR Tools

41. …Analyze, Visualize, Communicate… Thick Clips EnSight can create “thick” clips through the domain (either continuous or discrete). Use either the “Box” tool with “Inside” or two Plane Tool Operations (with inside/outside). A separate new part(s) will be created. Both Visual and Computationally valid – View just a sub-selection of particles – Perform calculations on this new part (mass, ave, min/max etc.) EC – Thick Clips

42. …Analyze, Visualize, Communicate… Thick Clip – Box Method 1. Place the Box tool in the desired location for the clip. – Right Click -- > Place Tool -- > Box will place Box tool at part Extrema – Grab axes to adjust interactively. – Right Click --> Edit to adjust exactly. EC – Thick Clips

43. …Analyze, Visualize, Communicate… Thick Clip – Box Method 2. Create the Clip – Click on the “Clip” Icon. – Select the Box Tool. – Select “Inside” Type – Create with Selected Part(s) as Parents The Parents are hidden automatically (still there). EC – Thick Clips

44. …Analyze, Visualize, Communicate… Thick Clip New part(s) created from Parents – Parents are turned display to OFF by default – New part(s) are visual, and computational View on/off Compute variables from this part – Clip remains as a Child of the Parent Any changes to Parent (filtering) will effect this part too. EC – Thick Clips

45. …Analyze, Visualize, Communicate… Thick Clip – Method 2 : Aux Clip There is an alternative to the Box method, called Auxiliary Clip with ‘test:’ command. – This is Visual ONLY. (the culling is down at the graphics level, not the particle level). – Does not effect calculations (again, only visual) – Quick/easy to implement. – By default, effects ALL parts (can be adjusted). EC – Thick Clips

46. …Analyze, Visualize, Communicate… Thick Clip – Method 2 : Aux Clip Three Steps: – Along the top bar of EnSight : View -- > Auxiliary clip – In the File -- > Command window, enter in a thickness for this clip : ‘test: thick_aux_plane XXX’ where ‘XXX’ is a float value for the thickness. – For any part you don’t want this clipping to effect. Select those Part(s), and along the top row of EnSight, turn OFF the auxiliary clipping. EC – Thick Clips

47. …Analyze, Visualize, Communicate… Color Palettes Up to 45 definable color palettes Default installation includes ~20 various palettes Define your own palettes via simple text file (See User Manual Chapter 8). Samples provided in the “Goodies” directory. Place the.cpal file(s) into your ~/.ensight101/palettes/ directory EC – Color Palettes

48. …Analyze, Visualize, Communicate… Color Palettes In the Palette Editor -- > Files Tab Choose palette to apply for that variable. Note: Can setup default color palettes in Edit -- > Preferences. EC – Color Palettes

49. …Analyze, Visualize, Communicate… THANK YOU Questions?