Difference between revisions of "ParaView/Users Guide/Query Data"

From KitwarePublic
Jump to: navigation, search
(Extracting the Selection)
Line 1: Line 1:
As previously described, Selection is a mechanism in ParaView for sub-setting and focusing on a particular elements in the dataset. Different views provides different mechanisms for selecting elements, e.g. one can select visible cells or points using the 3D View. Another mechanism for creating selections is by specifying a selection criteria. For example, support you want to select all cell where the pressure value is between a certain threshold. In such cases, one can use the '''Find Data''' dialog. The '''Find Data''' dialog performs a dual role: not only does it enable specifying the selection criteria but also show details of the selected elements in a spreadsheet. This makes it easier to inspect the selected elements.
+
As previously described, Selection is a mechanism in ParaView for sub-setting and focusing on a particular elements in the dataset. Different views provides different mechanisms for selecting elements, for example, you can select visible cells or points using the 3D View. Another mechanism for creating selections is by specifying a selection criteria. For example, suppose you want to select all cells where the pressure value is between a certain threshold. In such cases, you can use the Find Data dialog. The Find Data dialog performs a dual role: not only does it enable specifying the selection criteria but also show details of the selected elements in a spreadsheet. This makes it easier to inspect the selected elements.
  
To open the '''Find Data''' dialog, choose '''Find Data''' from the '''Edit''' menu.  
+
To open the Find Data dialog, go to '''Edit'''|Find Data.
  
[[Image:ParaViewUsersGuideFindDataDialog.png|400px]]
+
[[Image:ParaViewUsersGuideFindDataDialog.png|thumb|center|400px\'''Figure 6.13''']]
  
 
=When to use '''Find Data'''=
 
=When to use '''Find Data'''=
This feature is useful every time you run into situations where you want to know the cell or the point at which a certain condition happens eg.
+
This feature is useful when you run into situations where you want to know the cell or the point at which a certain condition happens For example:
 
* What are the cells at which PRESSURE >= 12?
 
* What are the cells at which PRESSURE >= 12?
 
* What are the points with TEMP values in the range (12, 133)?
 
* What are the points with TEMP values in the range (12, 133)?
Line 19: Line 19:
 
* Process the selected cells/points e.g. show labels in active 3D view, extract selection etc.
 
* Process the selected cells/points e.g. show labels in active 3D view, extract selection etc.
  
One must define the selection query and then execute the query, using '''Run Query''' button before being able to inspect or process the selected elements.
+
You must define the selection query and then execute the query, using the Run Query button before being able to inspect or process the selected elements.
  
 
=Defining the Query=
 
=Defining the Query=
  
First decide what type of elements you are interested in selecting i.e. cells or points and from what data-source. This can be done using the following combo-boxes. Note that as you change these, any previous selections/queries will be cleared.
+
First, decide what type of elements you are interested in selecting, that is cells or points and from what data source. This can be done using the following combo boxes. Note that as you change these, any previous selections/queries will be cleared.
  
[[Image:ParaViewUsersGuideFindDataHeader.png|400px]]
+
[[Image:ParaViewUsersGuideFindDataHeader.png|thumb|center|400px|'''Figure 6.14''' Find Data options]]
  
Next, we must define the selection criteria. For defining the criteria, one first choose the term e.g. IDs, Global IDs, attribute array names etc. available for the chosen element type. Next one chooses the operator, and finally the value or values. Based on the operator one or more values may be entered in the value entry box using comma (,) as the separator.
+
Next, you must define the selection criteria. For defining the criteria, you first choose the term, for example IDs, Global IDs, attribute array names, etc., available for the chosen element type. Next you select the operator, and finally the value or values. Based on the operator one or more values may be entered in the value entry box using comma (,) as the separator.
  
In addition based on the data-type and the nature of the current session, there may additional rows that allow users to qualify the selection using optional parameters such as process number (when running in parallel), or block number (for composite datasets).
+
In addition, based on the data type and the nature of the current session, there may be additional rows that allow users to qualify the selection using optional parameters such as process number (when running in parallel), or block number (for composite datasets).
  
Once you have defined your query, hit '''Run Query''' button to execute the query. If any elements get selected, then they will be shown in the spreadsheet in this dialog. Also, is any of they views are showing the dataset that is selected, then they will highlight the selected elements as well, just like regular view-based selection.
+
Once you have defined your query, hit Run Query button to execute the query. If any elements get selected, then they will be shown in the spreadsheet in this dialog. Also, if any of the views are showing in the dataset that is selected, then they will be highlighted the selected elements as well, just like regular view-based selection.
  
 
=Displaying the Selection=
 
=Displaying the Selection=
  
Once a query is executed, the selected elements will be highlighted in all views where the selected data is visible. If the active view is a 3D view, one can choose whether the show labels for selected elements as well as the color to use for showing the selected elements using the controls on the Find Data dialog itself.
+
Once a query is executed, the selected elements will be highlighted in all views where the selected data is visible. If the active view is a 3D view, you can choose whether the show labels for selected elements as well as the color to use for showing the selected elements using the controls on the Find Data dialog itself.
  
[[Image:ParaViewUsersGuideFindDataSelectionControls.png|400px]]
+
[[Image:ParaViewUsersGuideFindDataSelectionControls.png|thumb|center|400px|'''Figure 6.15''']]
  
 
=Extracting the Selection=
 
=Extracting the Selection=
  
The results of a query are temporary. They get replaced when a new query is executed or when the user creates a selection using any of the selection mechanisms. Sometimes however, users may want to further analyze the selected elements such as apply more filters to only the selected elements, or plot the change in attributes on the selected elements over time. In that case, one should extract the selection. That creates a new filter that is setup to run the query on its input and produce a dataset matching the selection criteria. Both '''Extract Selection''' and '''Plot Selection Over Time''' are filters available through the '''Filters''' menu. The Find Data dialog provides shortcut buttons to quickly create those filters and set then up with the selection criteria chosen.
+
The results of a query are temporary. They get replaced when a new query is executed or when the user creates a selection using any of the selection mechanisms. Sometimes, however, users may want to further analyze the selected elements such as apply more filters to only the selected elements, or plot the change in attributes on the selected elements over time. In that case, you should extract the selection. That creates a new filter that is setup to run the query on its input and produce a dataset matching the selection criteria. Both Extract Selection and Plot Selection Over Time are filters available through the Filters menu. The Find Data dialog provides shortcut buttons to quickly create those filters and set then up with the selection criteria chosen.
  
[[Image:ParaViewUsersGuideFindDataFooter.png|400px]]
+
[[Image:ParaViewUsersGuideFindDataFooter.png|thumb|center|400px|'''Figure 6.16''']]

Revision as of 07:02, 13 June 2011

As previously described, Selection is a mechanism in ParaView for sub-setting and focusing on a particular elements in the dataset. Different views provides different mechanisms for selecting elements, for example, you can select visible cells or points using the 3D View. Another mechanism for creating selections is by specifying a selection criteria. For example, suppose you want to select all cells where the pressure value is between a certain threshold. In such cases, you can use the Find Data dialog. The Find Data dialog performs a dual role: not only does it enable specifying the selection criteria but also show details of the selected elements in a spreadsheet. This makes it easier to inspect the selected elements.

To open the Find Data dialog, go to Edit|Find Data.

400px\Figure 6.13

When to use Find Data

This feature is useful when you run into situations where you want to know the cell or the point at which a certain condition happens For example:

  • What are the cells at which PRESSURE >= 12?
  • What are the points with TEMP values in the range (12, 133)?
  • Locate the cell at ID 122, in Block 2.

This feature provides a convenient way of creating selections based on certain criteria that can then be extracted from the data if needed.

Using the Find Data dialog

The dialog is designed to be used in two distinct operations:

  • Define the selection criteria or query
  • Process the selected cells/points e.g. show labels in active 3D view, extract selection etc.

You must define the selection query and then execute the query, using the Run Query button before being able to inspect or process the selected elements.

Defining the Query

First, decide what type of elements you are interested in selecting, that is cells or points and from what data source. This can be done using the following combo boxes. Note that as you change these, any previous selections/queries will be cleared.

Figure 6.14 Find Data options

Next, you must define the selection criteria. For defining the criteria, you first choose the term, for example IDs, Global IDs, attribute array names, etc., available for the chosen element type. Next you select the operator, and finally the value or values. Based on the operator one or more values may be entered in the value entry box using comma (,) as the separator.

In addition, based on the data type and the nature of the current session, there may be additional rows that allow users to qualify the selection using optional parameters such as process number (when running in parallel), or block number (for composite datasets).

Once you have defined your query, hit Run Query button to execute the query. If any elements get selected, then they will be shown in the spreadsheet in this dialog. Also, if any of the views are showing in the dataset that is selected, then they will be highlighted the selected elements as well, just like regular view-based selection.

Displaying the Selection

Once a query is executed, the selected elements will be highlighted in all views where the selected data is visible. If the active view is a 3D view, you can choose whether the show labels for selected elements as well as the color to use for showing the selected elements using the controls on the Find Data dialog itself.

Figure 6.15

Extracting the Selection

The results of a query are temporary. They get replaced when a new query is executed or when the user creates a selection using any of the selection mechanisms. Sometimes, however, users may want to further analyze the selected elements such as apply more filters to only the selected elements, or plot the change in attributes on the selected elements over time. In that case, you should extract the selection. That creates a new filter that is setup to run the query on its input and produce a dataset matching the selection criteria. Both Extract Selection and Plot Selection Over Time are filters available through the Filters menu. The Find Data dialog provides shortcut buttons to quickly create those filters and set then up with the selection criteria chosen.

Figure 6.16