Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "ICE Embedded Visualizations"

(CSV: Added initial text content)
 
(16 intermediate revisions by 4 users not shown)
Line 6: Line 6:
  
 
This document describes the embedded visualization capabilities available in ICE. Embedded visualizations in ICE aim to provide users with immediate yet simple visualization of simulation input and output well within the simulation workflow. In other words, simulation input and output can be visually verified or validated without leaving the associated Model Builder or Job Launcher in ICE. For more advanced or complex visualization tasks in ICE, please see the document on [[Visualizing Output with ICE]].
 
This document describes the embedded visualization capabilities available in ICE. Embedded visualizations in ICE aim to provide users with immediate yet simple visualization of simulation input and output well within the simulation workflow. In other words, simulation input and output can be visually verified or validated without leaving the associated Model Builder or Job Launcher in ICE. For more advanced or complex visualization tasks in ICE, please see the document on [[Visualizing Output with ICE]].
 
== Installation and Configuration ==
 
 
=== VisIt Visualization Service ===
 
==== Prerequisites ====
 
 
To use the embedded visualization service for ''VisIt'', ICE requires a local installation of [https://wci.llnl.gov/simulation/computer-codes/visit/ VisIt] (minimum version 2.8.2) developed by Lawrence Livermore National Laboratory.
 
 
==== Preferences ====
 
 
===== Getting to the Preferences =====
 
Using the ''VisIt'' visualization service for viewing complex 2D or 3D mesh data requires little initial configuration. Assuming the [[#Prerequisites|VisIt prerequisite]] is installed, use the the main menu bar at the top of the window and navigate to:
 
 
''Window'' > ''Preferences''
 
 
In the ''Preferences'' dialog, navigate to:
 
 
''Visualization'' > ''VisIt''
 
 
[[File:ICE_Viz_VisIt-Preferences.png]]
 
 
===== Adding Connections =====
 
You will need to press the "+" button to the right of the table to add a new entry. Fill out the new row in the table. Generally speaking, the default values are fine, but the ''Path'' will need to be updated to point to the folder containing your VisIt executable. You can copy and paste the path into this field and press ''Enter''.
 
 
{{tip|If you need to find the VisIt installation in Windows, find a shortcut to VisIt either on your desktop or in the start menu. Right-click the shortcut and open its ''Properties''. The path to the VisIt executable's directory will be shown next to ''Target''.}}
 
 
===== Setting the Default Connection =====
 
Currently, only one connection to VisIt can be used at a time. If you only have one configured connection, it is automatically selected as the default. However, if you have multiple configured connections, you will need to set the ''default'' connection by choosing from the drop down above the table.
 
 
===== Removing Connections =====
 
To remove a connection, click on any cell in its row in the table, then click the "-" button on the right of the table. You can select multiple connections by holding ''CTRL'' while you click them, then clicking the "-" button.
 
 
===== Applying the Connection Preferences =====
 
When you have finished updating your connection configurations for VisIt, you can click ''OK'' to apply the changes and close the ''Preferences'' dialog. Alternatively, you can apply the changes immediately by clicking ''Apply''. It is then safe to close the ''Preferences'' dialog in any valid way, e.g., by clicking the dialog's close button or by clicking ''Cancel''.
 
 
=== CSV Visualization Service ===
 
The embedded visualizations for <tt>.csv</tt> data require no additonal software to be installed or any preference configuration.
 
  
 
== Resources and Resource Pages ==
 
== Resources and Resource Pages ==
 
ICE ''Items'' may include any number of ''Resources'', which may include any type of file like meshes, pictures, shell scripts, <tt>.csv</tt> files, or even plain text files. For example, a ''Model Builder'', which is used in ICE to configure simulation input, may at some point include a plain text input file as well as associated data files or meshes. Likewise, a ''Job Launcher'', which actually launches the simulation, may produce any type of output data, which may also include <tt>.csv</tt> files, binary files, or even more mesh files.
 
ICE ''Items'' may include any number of ''Resources'', which may include any type of file like meshes, pictures, shell scripts, <tt>.csv</tt> files, or even plain text files. For example, a ''Model Builder'', which is used in ICE to configure simulation input, may at some point include a plain text input file as well as associated data files or meshes. Likewise, a ''Job Launcher'', which actually launches the simulation, may produce any type of output data, which may also include <tt>.csv</tt> files, binary files, or even more mesh files.
  
Before proceeding, you should familiarize yourself with the ''Resources View'' and the idea of a ''Resource Page'' as shown in the image below.
+
Before proceeding, you should familiarize yourself with the ''Resources View'' (highlighted in blue on the left) and the idea of a ''Resource Page'' (highlighted in red, while its tab is highlighted at the bottom) as shown in the image below.
  
[[File:ICE_Viz_ResourceViewPage.png]]
+
[[File:ICE_Viz_ResourceViewPage.png|800px]]
  
 
=== The Resources View ===
 
=== The Resources View ===
Line 73: Line 36:
  
 
This document will not discuss the latter three situations any further. The next sections will describe the embedded visualizations from the first scenario.
 
This document will not discuss the latter three situations any further. The next sections will describe the embedded visualizations from the first scenario.
 +
 +
=== Controlling Embedded Visualizations ===
 +
Each ''Resource Page'' can display a number of embedded visualizations at any time. Selected plots are displayed in a grid defined by the ''Rows'' and ''Columns'' widgets in the toolbar (highlighted in blue in the image below) near the top of the page, although embedded plots will take up as much space as they can. The default grid is two by two, although the number of rows and columns can be changed at any time.
 +
 +
{{note|Be careful when decreasing the size of the grid, as any embedded plots outside the dimensions of the grid will be lost.}}
 +
 +
[[File:ICE_Viz_Grid.png|600px]]
 +
 +
==== Adding Plots to the Grid ====
 +
To add a new plot to the grid, simply go to the ''Resources View'' and double-click the desired file that can be rendered by one of ICE's visualization services. Note that the order in which plots appear in the grid depend on the order in which they are added to the grid, with the grid moving left-to-right, top-to-bottom.
 +
 +
==== Removing Plots from the Grid ====
 +
To remove an individual plot, you have two choices:
 +
 +
# You can hover the mouse cursor over the plot, then click the "X" button that appears (highlighted in red in the image above).
 +
# You can right-click somewhere inside the plot, then click ''Remove''.
 +
 +
You can also remove all plots at once by clicking the ''Clear'' button in the ''Resource Page'''s toolbar. This is located next to the widgets for controlling the size of the grid.
 +
 +
==== Right-click Menus ====
 +
Every plot drawn inside the ''Resource Page'' includes a right-click menu that provides the following basic options:
 +
 +
# '''Remove''' - Removes the plot from the ''Resource Page''
 +
# '''Set Plot Type''' - Provides nested sub-menus that let you set what is displayed in the plot.
 +
 +
The contents of the ''Set Plot Type'' sub-menu depends on both the file and the visualization service used to plot it. Generally, you first choose the plot ''category'' from the first sub-menu and then a ''type'' from the category sub-menu.
 +
 +
Additional menu choices may be available depending on the visualization service that provides the plot.
  
 
== Visualization Services ==
 
== Visualization Services ==
 
=== VisIt ===
 
=== VisIt ===
{{note|If you have not installed and configured VisIt, please see the above section on the [[#Prerequisites|VisIt Visualization Service prerequisites]].}}
+
==== Prerequisites ====
 +
 
 +
To use the embedded visualization service for ''VisIt'', ICE requires a local installation of [https://wci.llnl.gov/simulation/computer-codes/visit/ VisIt] (minimum version 2.8.2, maximum version 2.9.2) developed by Lawrence Livermore National Laboratory.
 +
 
 +
==== Preferences ====
 +
 
 +
===== Getting to the Preferences =====
 +
Using the ''VisIt'' visualization service for viewing complex 2D or 3D mesh data requires little initial configuration. Assuming the [[#Prerequisites|VisIt prerequisite]] is installed, use the the main menu bar at the top of the window and navigate to:
 +
 
 +
''Window'' > ''Preferences''
 +
 
 +
In the ''Preferences'' dialog, navigate to:
 +
 
 +
''Visualization'' > ''VisIt''
 +
(highlighted in blue in the image below)
 +
 
 +
[[File:ICE_Viz_VisIt_Preferences.png]]
 +
 
 +
===== Adding Connections =====
 +
You will need to press the "+" button (highlighted above in red) to the right of the table to add a new entry. Fill out the new row in the table. Generally speaking, the default values are fine, but the ''Path'' will need to be updated to point to the folder containing your VisIt executable.
 +
 
 +
For example, on '''Windows''', if assuming a username of "username", and VisIt was installed in the default location, the path will be:
 +
 
 +
C:\Users\username\AppData\Local\Programs\LLNL\VisIt 2.9.2.
 +
 
 +
On '''Linux''', the path will be based on where you extracted the visit2_9_2.linux-x86 folder, ending with ~/visit2_9_2.linux-x86_64/bin. If you unzipped it to the desktop, it will be:
 +
 
 +
/home/username/Desktop/visit2_9_2.linux-x86_64/bin
 +
 
 +
On '''Mac OS''', the path will be based on the location you put the Visit application. If placed in the Applications folder, it will be
 +
 
 +
/Applications
 +
 
 +
{{tip|If you have forgotten the VisIt installation location in Windows, find a shortcut to VisIt either on your desktop or in the start menu. Right-click the shortcut and open its ''Properties''. The path to the VisIt executable's directory will be shown next to ''Target''.}}
 +
 
 +
===== Setting the Default Connection =====
 +
Currently, only one connection to VisIt can be used at a time. If you only have one configured connection, it is automatically selected as the default. However, if you have multiple configured connections, you will need to set the ''default'' connection by choosing from the drop down above the table.
 +
 
 +
===== Removing Connections =====
 +
To remove a connection, click on any cell in its row in the table, then click the "-" button (highlighted above in red) on the right of the table. You can select multiple connections by holding ''CTRL'' while you click them, then clicking the "-" button.
 +
 
 +
===== Applying the Connection Preferences =====
 +
When you have finished updating your connection configurations for VisIt, you can click ''OK'' to apply the changes and close the ''Preferences'' dialog. Alternatively, you can apply the changes immediately by clicking ''Apply''. It is then safe to close the ''Preferences'' dialog in any valid way, e.g., by clicking the dialog's close button or by clicking ''Cancel''.
 +
 
 +
==== Opening a VisIt Plot ====
  
 
The ''Resources View'' will pass any ICE resources pointing to <tt>.e</tt> (Exodus) or <tt>.silo</tt> files to the ''VisIt Visualization Service''. If the visualization service is configured and running and if the file is valid, then the ''Resource Page'' will open a view of the resource powered by the default VisIt connection, as in the image of a battery mesh SILO file below.
 
The ''Resources View'' will pass any ICE resources pointing to <tt>.e</tt> (Exodus) or <tt>.silo</tt> files to the ''VisIt Visualization Service''. If the visualization service is configured and running and if the file is valid, then the ''Resource Page'' will open a view of the resource powered by the default VisIt connection, as in the image of a battery mesh SILO file below.
  
[[File:ICE_Viz_VisIt.png]]
+
An example VisIt plot embedded in a ''Model Builder'' can be seen in the image below.
 +
 
 +
[[File:ICE_Viz_VisIt.png|600px]]
  
 
The embedded VisIt view can be rotated by clicking and dragging and zoomed in and out with the mouse wheel.
 
The embedded VisIt view can be rotated by clicking and dragging and zoomed in and out with the mouse wheel.
Line 106: Line 143:
 
* Vectors
 
* Vectors
 
** Vector ''(default)''
 
** Vector ''(default)''
 
[[File:ICE_Viz_VisIt-types.png]]
 
 
==== Plot "Representations" ====
 
 
=== CSV ===
 
The ''Resources View'' will pass any ICE resources pointing to <tt>.csv</tt> files to the ''CSV Visualization Service''. If the file can be read by the ''CSV Visualization Service'', then the ''Resource Page'' will open a plot that contains the first available series in the file.
 
 
{{note|The ''CSV Plot Viewer'' requires data to be in an ''m''x''n'' format, meaning that files that contain rows with empty values cannot be plotted. Furthermore, the first row is expected to include column headers--the variable names--, while each subsequent row should include the numerical data in columns.}}
 
 
[[File:ICE_Viz_CSV.png]]
 
 
The embedded CSV plot includes the same toolbar described in the the standard features provided by the [[Visualizing_Output_with_ICE#Plot Toolbar|''CSV Plot Editor'' in the ''Visualization Perspective'']] as well as a right-click menu to modify the plot.
 
 
==== Right-click Menu ====
 
The image below shows the context menu available when right-clicking somewhere inside the CSV plot.
 
 
[[File:ICE_Viz_CSV-ContextMenu.png]]
 
 
By choosing a series from the ''Set Plot Type'' sub-menu, you can change what series is plotted. This will clear any existing series from the plot and add the selected series.
 
 
To add more series to the plot, choose a series from the ''Add Series'' sub-menu.
 
 
To remove a plotted series, choose one of the existing series from the ''Remove Series'' sub-menu. This sub-menu will be disabled if there are no series to remove.
 
 
To clear all series from the plot, click ''Clear Plot'' at the bottom of the menu.
 
 
=== Controlling Embedded Visualizations ===
 
 
=== Controlling Embedded Visualizations ===
 

Latest revision as of 10:01, 25 April 2016

The capabilities in this document are brand new, and while we assert that they work, that may not be the case on all systems for all users. Problems should be reported directly to the ICE team by sending an email to the project list, ice-dev <at> eclipse.org, or following the instructions to report bugs on our Bugzilla.


Introduction

This document describes the embedded visualization capabilities available in ICE. Embedded visualizations in ICE aim to provide users with immediate yet simple visualization of simulation input and output well within the simulation workflow. In other words, simulation input and output can be visually verified or validated without leaving the associated Model Builder or Job Launcher in ICE. For more advanced or complex visualization tasks in ICE, please see the document on Visualizing Output with ICE.

Resources and Resource Pages

ICE Items may include any number of Resources, which may include any type of file like meshes, pictures, shell scripts, .csv files, or even plain text files. For example, a Model Builder, which is used in ICE to configure simulation input, may at some point include a plain text input file as well as associated data files or meshes. Likewise, a Job Launcher, which actually launches the simulation, may produce any type of output data, which may also include .csv files, binary files, or even more mesh files.

Before proceeding, you should familiarize yourself with the Resources View (highlighted in blue on the left) and the idea of a Resource Page (highlighted in red, while its tab is highlighted at the bottom) as shown in the image below.

ICE Viz ResourceViewPage.png

The Resources View

Some Items in ICE store references to these resources for easy access to the user. In these cases, the resources are presented to the user in the Resources View, which is part of the default ICE perspective.

The Resource View is actually a tree, where each resource has its own node. If you expand a resource node, it will reveal the underlying file's path along with its date of last modification.

Resource Pages

If an ICE Item includes resources, it will have a designated tab for showing those resources.

  • For Model Builders, this tab could be named anything. For instance, in the MOOSE Model Builder, the tab for viewing resources is called Mesh.
  • For Job Launchers, this tab will be named Output Files and Data.

Click on the tab to open it and view the Item's Resource Page. Each Resource Page is capable of showing plain text files or embedded visualizations based on the selected resource's file type.

Viewing a Resource

To open a resource, go to the Resources View and double-click its item in the list of available resources. The way ICE handles this selected resource depends on the following:

  1. If the file can be opened using one of the visualization services, it will be added to the active Resource Page.
  2. If the file can be opened using a plain text editor, it will be opened in a new Text Editor in ICE.
  3. If the file cannot be opened, the Resource Page will attempt to render it through a browser widget. This handles some basic files like certain image types.
  4. If the file cannot be opened in the browser, the browser will prompt you to save the file. In this case, you can either save it, or cancel and open the existing file at the location specified in the Resources View.

This document will not discuss the latter three situations any further. The next sections will describe the embedded visualizations from the first scenario.

Controlling Embedded Visualizations

Each Resource Page can display a number of embedded visualizations at any time. Selected plots are displayed in a grid defined by the Rows and Columns widgets in the toolbar (highlighted in blue in the image below) near the top of the page, although embedded plots will take up as much space as they can. The default grid is two by two, although the number of rows and columns can be changed at any time.

Note.png
Be careful when decreasing the size of the grid, as any embedded plots outside the dimensions of the grid will be lost.


ICE Viz Grid.png

Adding Plots to the Grid

To add a new plot to the grid, simply go to the Resources View and double-click the desired file that can be rendered by one of ICE's visualization services. Note that the order in which plots appear in the grid depend on the order in which they are added to the grid, with the grid moving left-to-right, top-to-bottom.

Removing Plots from the Grid

To remove an individual plot, you have two choices:

  1. You can hover the mouse cursor over the plot, then click the "X" button that appears (highlighted in red in the image above).
  2. You can right-click somewhere inside the plot, then click Remove.

You can also remove all plots at once by clicking the Clear button in the Resource Page's toolbar. This is located next to the widgets for controlling the size of the grid.

Right-click Menus

Every plot drawn inside the Resource Page includes a right-click menu that provides the following basic options:

  1. Remove - Removes the plot from the Resource Page
  2. Set Plot Type - Provides nested sub-menus that let you set what is displayed in the plot.

The contents of the Set Plot Type sub-menu depends on both the file and the visualization service used to plot it. Generally, you first choose the plot category from the first sub-menu and then a type from the category sub-menu.

Additional menu choices may be available depending on the visualization service that provides the plot.

Visualization Services

VisIt

Prerequisites

To use the embedded visualization service for VisIt, ICE requires a local installation of VisIt (minimum version 2.8.2, maximum version 2.9.2) developed by Lawrence Livermore National Laboratory.

Preferences

Getting to the Preferences

Using the VisIt visualization service for viewing complex 2D or 3D mesh data requires little initial configuration. Assuming the VisIt prerequisite is installed, use the the main menu bar at the top of the window and navigate to:

Window > Preferences

In the Preferences dialog, navigate to:

Visualization > VisIt (highlighted in blue in the image below)

ICE Viz VisIt Preferences.png

Adding Connections

You will need to press the "+" button (highlighted above in red) to the right of the table to add a new entry. Fill out the new row in the table. Generally speaking, the default values are fine, but the Path will need to be updated to point to the folder containing your VisIt executable.

For example, on Windows, if assuming a username of "username", and VisIt was installed in the default location, the path will be:

C:\Users\username\AppData\Local\Programs\LLNL\VisIt 2.9.2.

On Linux, the path will be based on where you extracted the visit2_9_2.linux-x86 folder, ending with ~/visit2_9_2.linux-x86_64/bin. If you unzipped it to the desktop, it will be:

/home/username/Desktop/visit2_9_2.linux-x86_64/bin

On Mac OS, the path will be based on the location you put the Visit application. If placed in the Applications folder, it will be

/Applications

Idea.png
If you have forgotten the VisIt installation location in Windows, find a shortcut to VisIt either on your desktop or in the start menu. Right-click the shortcut and open its Properties. The path to the VisIt executable's directory will be shown next to Target.


Setting the Default Connection

Currently, only one connection to VisIt can be used at a time. If you only have one configured connection, it is automatically selected as the default. However, if you have multiple configured connections, you will need to set the default connection by choosing from the drop down above the table.

Removing Connections

To remove a connection, click on any cell in its row in the table, then click the "-" button (highlighted above in red) on the right of the table. You can select multiple connections by holding CTRL while you click them, then clicking the "-" button.

Applying the Connection Preferences

When you have finished updating your connection configurations for VisIt, you can click OK to apply the changes and close the Preferences dialog. Alternatively, you can apply the changes immediately by clicking Apply. It is then safe to close the Preferences dialog in any valid way, e.g., by clicking the dialog's close button or by clicking Cancel.

Opening a VisIt Plot

The Resources View will pass any ICE resources pointing to .e (Exodus) or .silo files to the VisIt Visualization Service. If the visualization service is configured and running and if the file is valid, then the Resource Page will open a view of the resource powered by the default VisIt connection, as in the image of a battery mesh SILO file below.

An example VisIt plot embedded in a Model Builder can be seen in the image below.

ICE Viz VisIt.png

The embedded VisIt view can be rotated by clicking and dragging and zoomed in and out with the mouse wheel.

Right-click Menu

The image below shows the context menu available when right-clicking somewhere inside the VisIt view.

ICE Viz VisIt-ContextMenu.png

The plot types available in the context menu depend on the data available in the VisIt-compatible file. In the case of this SILO file, the only plot categories are Meshes and Scalars.

Note.png
For VisIt, only one plot type can be set at a time.


The context menu also includes the ability to change how the VisIt plot is rendered. The representations available depend on the current plot type. A full list of supported "representations" is listed below for each plot category.

  • Materials
    • Boundary (default)
    • FilledBoundary
  • Meshes
    • Mesh (default)
  • Scalars
    • Pseudocolor (default)
    • Contour
    • Volume
  • Vectors
    • Vector (default)

Back to the top