ParaView/Displaying Data: Difference between revisions
No edit summary |
|||
Line 3: | Line 3: | ||
ParaView to look at the data to gain insight into it. | ParaView to look at the data to gain insight into it. | ||
=Understanding Views= | |||
==Views== | ==Views== | ||
Line 40: | Line 41: | ||
generated by the filter. | generated by the filter. | ||
==Active View== | |||
Once you have multiple views, the active view if indicated by a colored border | Once you have multiple views, the active view if indicated by a colored border | ||
Line 48: | Line 49: | ||
The '''Display''' tab affects the active view. Similarly, the ''eye icon'' in | The '''Display''' tab affects the active view. Similarly, the ''eye icon'' in | ||
the '''Pipeline Browser''' next the pipeline objects, indicates the visibility | the '''Pipeline Browser''', next to the pipeline objects, indicates the visibility | ||
state for that object in the active view. | state for that object in the active view. | ||
When a new filter or source or reader is created, it will be displayed by | When a new filter or source or reader is created, it will be displayed by | ||
default in the active view, if possible (otherwise, if may create a new view). | default in the active view, if possible (otherwise, if may create a new view). | ||
=Types of Views= | |||
In this section we will cover the different types of Views available in | |||
ParaView. For each view, we will talk about the controls available to change the | |||
view parameters using '''View Settings''' as well as the parameters associated | |||
with the '''Display Tab''' for showing data in that view. | |||
==3D View== | ==3D View== | ||
3D View is used to show the surface or volume rendering for the data in a 3D | 3D View is used to show the surface or volume rendering for the data in a 3D | ||
world. This is the most commonly used view type. | world. This is the most commonly used view type. | ||
When running in client-server mode, 3D View can render data either by bringing | When running in client-server mode, 3D View can render data either by bringing | ||
Line 67: | Line 75: | ||
Interacting with the 3D view will typically update the camera. This makes it | Interacting with the 3D view will typically update the camera. This makes it | ||
possible to explore the | possible to explore the visualization scene. The default buttons are as follows, | ||
they can be changed using the '''Application Settings''' dialog. | they can be changed using the '''Application Settings''' dialog. | ||
{|Modifier | {| style="color:green; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1" | ||
!Modifier | |||
!Left Button | |||
!Middle Button | |||
!Right Button | |||
|- | |||
| | |||
|Rotate | |||
|Pan | |||
|Zoom | |||
|- | |||
|Shift | |||
|Roll | |||
|Rotate | |||
|Pan | |||
|- | |- | ||
| | |Control | ||
|Zoom | |||
|Rotate | |||
|Zoom | |||
|} | |} | ||
This view supports selection. One can select cells or points either on the | This view supports selection. One can select cells or points either on the | ||
surface or those within a frustum. Selecting cells or points makes it possible | surface or those within a frustum. Selecting cells or points makes it possible | ||
to extract those for further inspection or label them etc. | to extract those for further inspection or label them etc. Details about data | ||
querying and selection can be found the Quantitative analysis chapter. | |||
===View Settings=== | ===View Settings=== | ||
Line 85: | Line 109: | ||
The view settings dialog accessible through the Edit | View Settings menu or the | The view settings dialog accessible through the Edit | View Settings menu or the | ||
tool button on the left-corner of the view is used to change the view settings | tool button on the left-corner of the view is used to change the view settings | ||
per view. | per view. | ||
====General==== | ====General==== | ||
[[Image:ViewSettingsGeneral.png|400px]] | |||
This tab allows the user to choose the background color. One can use a solid | This tab allows the user to choose the background color. One can use a solid | ||
Line 96: | Line 122: | ||
====Lights==== | ====Lights==== | ||
[[Image:ViewSettingsLights.png|400px]] | |||
The 3D View requires lights to illumniate the geometry being rendered in the | The 3D View requires lights to illumniate the geometry being rendered in the | ||
Line 101: | Line 129: | ||
====Annotation==== | ====Annotation==== | ||
[[Image:ViewSettingsAnnotation.png|400px]] | |||
The annotation pane enables controlling the visibility of the center axes and | The annotation pane enables controlling the visibility of the center axes and | ||
the orientation widget. | the orientation widget. Users can also make the orientation widget interactive, | ||
so that they can manually place the widget at location of their liking. | |||
===Display Properties=== | ===Display Properties=== | ||
Users can control how the data from any source or filter is shown in this view | |||
| | using the '''Display''' tab. In this section we will cover the various options | ||
available to a user for controlling appearance of the rendering in the 3D view. | |||
|- | |||
the selection | ====View==== | ||
|- Zoom to Data | | [[Image:3DViewDisplayView.png]] | ||
{| style="color:green; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1" | |||
!Name | |||
!Usage | |||
|- | |||
| Visible | |||
| Checkbox used to toggle the visibility of the data in the view. If it disabled, it implies that the data cannot be shown in this view. | |||
|- | |||
| Selectable | |||
| Checkbox used to toggle whether the data gets selected when using the selection mechanism for selecting and sub-setting data. | |||
|- | |||
| Zoom to Data | |||
| Click this button to zoom the camera so that the dataset is completely fits within the viewport. | |||
|} | |||
====Color==== | |||
[[Image:3DViewDisplayColor.png]] | |||
The color group allows users to pick the scalar to color with or set a fixed | |||
solid color for the rendering. | |||
- | {| style="color:green; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1" | ||
| Interpolate Scalars | If on, the scalars will be interpolated within polygons | !Name | ||
and the scalar mapping happens on per pixel basis. If off, then color mapping | !Usage | ||
happens at points and colors are interpolated which is typically less accurate. | |- | ||
This only affects when coloring with point arrays. Has no effect otherwise. | | Interpolate Scalars | ||
| Map Scalars | If the data array being color with can be directly interpreted | | If on, the scalars will be interpolated within polygons and the scalar mapping happens on per pixel basis. If off, then color mapping happens at points and colors are interpolated which is typically less accurate. This only affects when coloring with point arrays. Has no effect otherwise. This is disabled when coloring using a solid color. | ||
as colors then one can uncheck this to not use any lookup table. Otherwise, when | |- | ||
on, a lookup table will be used to map scalars to colors. | | Map Scalars | ||
| Apply Texture | Makes is possible to apply a texture over the surface. This | | If the data array being color with can be directly interpreted as colors then one can uncheck this to not use any lookup table. Otherwise, when on, a lookup table will be used to map scalars to colors. This is disabled when the array is not of the type that can be interpreted as colors (i.e. vtkUnsignedCharArray). | ||
requires that the data has texture coordinates. | |- | ||
'''Texture Map to Sphere''', '''Texture Map to Cylinder''' or | | Apply Texture | ||
'''Texture Map to Plane''' to generate texture coordinates when not present in | | Makes is possible to apply a texture over the surface. This requires that the data has texture coordinates. One can use filters like '''Texture Map to Sphere''', '''Texture Map to Cylinder''' or '''Texture Map to Plane''' to generate texture coordinates when not present in the data. To load a texture, select '''Load''' from the combo-box which will popup a dialog allowing you to choose an image. Otherwise pick from already loaded textures listed in the combo-box. | ||
the data. To load a texture, select '''Load''' from the combo-box which will | |- | ||
popup a dialog allowing you to choose an image. Otherwise pick from already | | Color By | ||
loaded textures listed in the combo-box. | | This enables coloring of the surface/volume. Either choose the array to color with or set the solid color to use. When volume rendering, solid coloring is not possible, one has to choose the data array to volume render with. | ||
| Color By | This enables coloring of the surface/volume. Either choose the | |- | ||
array to color with or set the solid color to use. When volume rendering, solid | | Set solid color | ||
coloring is not possible, one has to choose the data array to volume render | | Used to set the solid color. This is available only when '''Color By''' is set to use ''Solid Color''. ParaView defines a notion of a color palette consisting of different color categories. To choose a color from one of these predefined categories, click on the tiny arrow next to thus button. It will open up a drop down with options to choose from. If one uses a color from the palette, it possibly to globally change the color by changing the color palette e.g. for printing or for display on screen etc. | ||
with. | |- | ||
| Edit Color Map... | |||
| One can edit the color-map or lookup table by clicking the Edit Color Map button. It's only shown when an array is chosen in the '''Color By''' combo-box. | |||
|} | |||
====Slice==== | |||
[[Image:3DViewDisplaySlice.png]] | |||
The slice controls are available only for Image dataset (Uniform Rectilinear | |||
Grids) when the representation type is '''Slice'''. The representation type is | |||
controlled using the ''Style'' group on the '''Display''' tab. | |||
These allow the user to pick the slice direction as well as the slice | |||
offset. | offset. | ||
====Cube Axes==== | |||
[[Image:3DViewDisplayCubeAxes.png]] | |||
Cube axes is a annotation box that can be used so show a scale around the | Cube axes is a annotation box that can be used so show a scale around the |
Revision as of 02:24, 2 December 2010
The goal of visualization is to generate representations of the data in a visual form. In this chapter we will see different mechanisms available in ParaView to look at the data to gain insight into it.
Understanding Views
Views
When the ParaView application starts up, one sees a 3D viewport with an axes at the center. This is a View. In ParaView, Views are frames in which the data can be seen. There are different types of views. The default view that shows up is a 3D View which shows rendering of the geometry extracted from the data or volumes or slices in a 3D scene. You can change the default view Settings dialog (Edit | Settings (in case of Mac OS X, ParaView | Preferences)).
There maybe parameters that are available to the user that control how the data is displayed e.g. in case of 3D View, the data can be displayed as wireframes or surfaces, you choose to change the color of the surface or use a scalar for coloring etc. All these options are known as Display properties and are accessible from the Display tab in the Object Inspector.
Since there can be multiple datasets shown in a view, as well as multiple views, the Display tabs shows the properties for the active pipeline object (changed by using the Pipeline browser, for example) in the active view.
Multiple Views
ParaView supports showing multiple views side by side. To create multiple views, simply use the controls on the top-right corner of the view to split the frame vertically or horizontally. You can even maximize a particular view to temporarily hide other views. Once a view-frame is split, you will see a list of buttons showing the different types of views that you can create to place in that view. Simply click the button to create the view of your choice.
Some filters, such as Plot Over Line may automatically split the view frame and show the data in a particular type of view suitable for the data generated by the filter.
Active View
Once you have multiple views, the active view if indicated by a colored border around the view frame. Several menus as well as toolbar buttons affect the active view alone. Also they may become enabled/disabled based on whether that corresponding action is supported by the active view.
The Display tab affects the active view. Similarly, the eye icon in the Pipeline Browser, next to the pipeline objects, indicates the visibility state for that object in the active view.
When a new filter or source or reader is created, it will be displayed by default in the active view, if possible (otherwise, if may create a new view).
Types of Views
In this section we will cover the different types of Views available in ParaView. For each view, we will talk about the controls available to change the view parameters using View Settings as well as the parameters associated with the Display Tab for showing data in that view.
3D View
3D View is used to show the surface or volume rendering for the data in a 3D world. This is the most commonly used view type.
When running in client-server mode, 3D View can render data either by bringing the geometry to the client and then rendering it there or by rendering it on the server (possibly in parallel) and then delivering the composited images to the client. Refer to the Client-Server Visualization chapter for details.
Interaction
Interacting with the 3D view will typically update the camera. This makes it possible to explore the visualization scene. The default buttons are as follows, they can be changed using the Application Settings dialog.
Modifier | Left Button | Middle Button | Right Button |
---|---|---|---|
Rotate | Pan | Zoom | |
Shift | Roll | Rotate | Pan |
Control | Zoom | Rotate | Zoom |
This view supports selection. One can select cells or points either on the surface or those within a frustum. Selecting cells or points makes it possible to extract those for further inspection or label them etc. Details about data querying and selection can be found the Quantitative analysis chapter.
View Settings
The view settings dialog accessible through the Edit | View Settings menu or the tool button on the left-corner of the view is used to change the view settings per view.
General
This tab allows the user to choose the background color. One can use a solid color or a gradient or even a background image.
By default the camera uses perspective projection. To switch to parallel projection, check the "Use Parallel Projection" checkbox in this panel.
Lights
The 3D View requires lights to illumniate the geometry being rendered in the scene. Once can control these lights using this pane.
Annotation
The annotation pane enables controlling the visibility of the center axes and the orientation widget. Users can also make the orientation widget interactive, so that they can manually place the widget at location of their liking.
Display Properties
Users can control how the data from any source or filter is shown in this view using the Display tab. In this section we will cover the various options available to a user for controlling appearance of the rendering in the 3D view.
View
Name | Usage |
---|---|
Visible | Checkbox used to toggle the visibility of the data in the view. If it disabled, it implies that the data cannot be shown in this view. |
Selectable | Checkbox used to toggle whether the data gets selected when using the selection mechanism for selecting and sub-setting data. |
Zoom to Data | Click this button to zoom the camera so that the dataset is completely fits within the viewport. |
Color
The color group allows users to pick the scalar to color with or set a fixed solid color for the rendering.
Name | Usage |
---|---|
Interpolate Scalars | If on, the scalars will be interpolated within polygons and the scalar mapping happens on per pixel basis. If off, then color mapping happens at points and colors are interpolated which is typically less accurate. This only affects when coloring with point arrays. Has no effect otherwise. This is disabled when coloring using a solid color. |
Map Scalars | If the data array being color with can be directly interpreted as colors then one can uncheck this to not use any lookup table. Otherwise, when on, a lookup table will be used to map scalars to colors. This is disabled when the array is not of the type that can be interpreted as colors (i.e. vtkUnsignedCharArray). |
Apply Texture | Makes is possible to apply a texture over the surface. This requires that the data has texture coordinates. One can use filters like Texture Map to Sphere, Texture Map to Cylinder or Texture Map to Plane to generate texture coordinates when not present in the data. To load a texture, select Load from the combo-box which will popup a dialog allowing you to choose an image. Otherwise pick from already loaded textures listed in the combo-box. |
Color By | This enables coloring of the surface/volume. Either choose the array to color with or set the solid color to use. When volume rendering, solid coloring is not possible, one has to choose the data array to volume render with. |
Set solid color | Used to set the solid color. This is available only when Color By is set to use Solid Color. ParaView defines a notion of a color palette consisting of different color categories. To choose a color from one of these predefined categories, click on the tiny arrow next to thus button. It will open up a drop down with options to choose from. If one uses a color from the palette, it possibly to globally change the color by changing the color palette e.g. for printing or for display on screen etc. |
Edit Color Map... | One can edit the color-map or lookup table by clicking the Edit Color Map button. It's only shown when an array is chosen in the Color By combo-box. |
Slice
The slice controls are available only for Image dataset (Uniform Rectilinear Grids) when the representation type is Slice. The representation type is controlled using the Style group on the Display tab. These allow the user to pick the slice direction as well as the slice offset.
Cube Axes
Cube axes is a annotation box that can be used so show a scale around the dataset. Use the Show cube axes checkbox to toggle its visibility. You can further control the apperance of the cube axes by clicking Edit once the cube-axes is visible.
2D View
2D View is similar to 3D view except that it can only show slices from uniform grid datasets. The interaction is also limited to a 2D place i.e. rotation is not available.
Interaction
View Settings
Display Properties
Spreadsheet View
Spreadsheet View is used to inspect the raw data in a spreadsheet. When running in client-server mode, to avoid delivering the entire dataset to the client for displaying the spreadsheet (since the data can be very large), this view streams only visible chunks of the data to the client. As the user scrolls around the spreadsheet, new data chunks are fetched.
Unlike some other views, this view can only show one dataset at a time. For composite datasets, it shows only one block at a time. One can pick the block to show using the Display tab.
Interaction
- Choosing attributes to show
- Sorting
- Selection
- Show selected only
View Settings
Currently, no user settable settings are available for this view.