1 CW11 Visualizing ACE3P Results in ParaView Greg Schussman Menlo Park, CA October 10, 2011

2 CW11 General Workflow Run Omega3P 2) Apply ACE3P solver 3) Visualize with ParaView 1) Build mesh and verify mesh quality

3 CW11 ParaView is an open source, multi-platform application designed to visualize data sets of varying sizes from small to very large. ParaView is built on an extensible architecture based on open standards. ParaView runs on, Linux, Mac, Windows. ParaView can run on a single processor, or in parallel. ParaView is built on the Visualization ToolKit (VTK) What is ParaView?

4 CW11 ParaView Layout Menu Bar Toolbars Pipeline Browser Object Inspector 3D View

5 CW11 1.Download ParaView tinyurl.com/GetParaView ( 2.Install ParaView 3.Enable SLAC Toolbar Setup (One Time Only)

6 CW11 The SLAC Toolbar in ParaView provides convenience and streamlined workflow. It automatically creates a visualization pipeline, reduces the amount of user input needed for certain operations common in visualizing ACE3P results. All toolbar functionality is also available through the traditional ParaView interface. The traditional interface also provides additional control, and more advanced visualization features. The SLAC Toolbar: Introduction

7 CW11 The SLAC Toolbar is included in ParaView distributions, but is disabled by default. To enable the SLAC Toolbar –“Tools -> Manage Plugins” Select “SLACTools” Click “Load Selected” Click the “+” next to “SLAC Tools” –Check the box next to “Auto Load” so this plugin will always load whenever ParaView is run. The SLAC Toolbar: Setup

8 CW11 Enabling the SLAC Toolbar – Part

9 CW11 Enabling the SLAC Toolbar – Part With “Auto Load” enabled, the SLAC Toolbar will load every time ParaView is run.

10 CW11 Click the folder icon in the SLAC Toolbar –In the window that pops up, press the “…” buttons to browse for the locations of your ACE3P: Mesh file (which is required) Field files from time or frequency domain (optional) Particle files (also optional). ParaView will then load the data, construct a visualization pipeline for you, and, if fields are loaded, show the electric field magnitude. By default, only the mesh surface is loaded. You may want to load volume data as well. The SLAC Toolbar: Loading Data

11 CW11 Interaction with the 3D Window: Common RotatePanZoom

12 CW11 Interaction with the 3D Window: Convenience Shift Scroll Rotate in planeZoom

13 CW11 To position the mesh on the screen in a canonical “Z axis points to the right” orientation, press the [1] button in the toolbar. This is also useful for getting un-lost when the mesh has accidentally been moved out of view. The SLAC Toolbar: Standard View 1

14 CW11 To change the center of rotation, click the “Pick Center” button in the [1] toolbar, then click on the mesh where the new center of rotation should be. The SLAC Toolbar: Standard View 1

15 CW11 The SLAC Toolbar: Drawing Styles Plain Surface with Edges Wire front and Surface back

16 CW11 The SLAC Toolbar provides two buttons for rescaling fields. They rescale the colors based on the maximum field magnitude for: –[1] all loaded timesteps –[2] the current timestep only. The SLAC Toolbar: Field Scaling 1 2

17 CW11 Optimal color scaling is subjective. If the default heuristics aren’t satisfactory, hit [1] to edit the color map. –For other colormaps (or to select the rainbow colormap if it isn’t already the default, press the “Choose preset” button and click on the desired map. –You may want to press “make default” so that other filters (e.g., arrows) will use the same map. Field Scaling 1

18 CW11 To find the minimum and maximum field values in the dataset for the current timestep, press “Rescale to Data Range” Field Scaling

19 CW11 To animate a mode (frequency domain) or sequence of fields (time domain), and/or particles, use the VCR controls. Animation Jump to beginning Back one timestep Play Forward one timestep Jump to End Loop Animation

20 CW11 If fields have been loaded, the “e” and “b” buttons will switch the field coloring to be the e or b field. This only works for the portions of the visualization pipeline which were set up by the SLAC Toolbar. Anything manually added via the traditional interface (e.g., cones, slices) will be unaffected, and must be changed by hand. The SLAC Toolbar: E and B Fields

21 CW11 To see a line plot of field magnitudes along the Z axis (X=0, Y=0), press [1]. This plot will automatically change between e and b fields in response to the [2] and [3] button presses. The SLAC Toolbar: Line Plot 1 2 3

22 CW11 To show arrows: –select the corresponding surface or volume from the pipeline browser. –“Filter -> Alphabetical -> glyph” For “Vector” choose your desired field Select “Arrow” and press “Apply” Arrows

23 CW11 This may not assign the right coloring to the arrows, so click the “Display” tab, and then color with efield or bfield. Arrows Exercise caution, because it is possible to mix e and b fields in a single visualization, which can be confusing when unintended or unexpected. Note that the e and b buttons in the SLAC Toolbar will not change the field used for these arrows; this must be done by hand.

24 CW11 To toggle the visibility of mesh surfaces by id –Select “external surface” in the pipeline browser “filters -> alphabetical -> extract block” Check/uncheck the blocks listed Our convention is to have surface 6 as the external metal surface. Remember to press “Apply” each time a new combination of blocks is selected, to update the display. Showing / Hiding Surfaces by Id

25 CW11 To see what lies within a slice through your mesh volume, –select “Entire Volume” in the pipeline browser –Press [1] (not to be confused with [2], which clips away half the mesh to see inside the other half) –Specify the normal vector for the plane (e.g., for a plane perpendicular to the Z axis, use (0, 0, 1)) –You can also specify that the plane cross through some point other than the origin. –Press “Apply” Slice (Cutplane) 1 2

26 CW11 To assign color to the slice, –select it in the pipeline browser (if not already selected) –From the pulldown menu select “efield” or “bfield”. Note: remember to hide the other surfaces which may occlude the new surface (i.e., the new slice may be hidden inside the displayed mesh surface) Slice (Cutplane) Coloring

27 CW11 If particles have been loaded, you can toggle whether they display by pressing the [1] button. To show particle trails, go to: –“filter -> alphabetical -> particle pathlines” (This adds “Pathlines” and “Particles” to the pipeline browser) Set the “Particle ID channel” to “global or local IDs”. Press “Apply” –The particles and trails can be colored independently by selecting them in the pipeline browser, and specifying color, or momentum, or emission type. The SLAC Toolbar: Particles 1