Documentation‎ > ‎User Manual‎ > ‎

Applying Filters

A filter takes an input and processes it to generate, extract or derive something from the data. In ParaViewGeo, filters can use readers, sources or other filters as inputs in order to change them in some way.

The Filters menu lists many filters that can be applied to the selected dataset. Due to the great number of filters, they are divided into sub-menus to make them easier to find. A portion of these are also displayed in the Common Filters toolbar for easy access. The grayed-out filters are the ones that can not be applied to the specific type of dataset selected.

  • Recent - displays the 10 most recently used filters, in order of use
  • BillBoards - contains the Billboards filters created by MIRARCO
  • Common - contains the most commonly used filters, also available from the Common Filters toolbar
  • Data Analysis - contains filters that analyze the data and retrieve some kind of quantitative value
  • Mirarco - contains the filters designed at MIRARCO specifically for ParaViewGeo
  • Temporal - contains filters that apply to data that changes over time
  • Alphabetical - contains an alphabetical list of all filters including ones that do not appear in the other sub-menus
  • If Custom Filters are added, they will appear in the Alphabetical section.

Note: The Temporal filters are not covered in this manual; some information is available in the Help file.

Finding and Applying Filters

To apply a filter, select the dataset in the pipeline browser and then select the filter. You can choose a filter either directly from the Filters menu, or by searching for the filter using Ctrl+Space to display the search dialog box. Type in part of the name of the filter, and the dialog box will display all sources and filters that match those criteria. If a filter is grayed-out, it cannot be applied to the selected dataset. Click on the filter or use the arrow keys to highlight the one you want to use, and press Enter. You can change your criteria by using the backspace key to erase one letter at a time, or pressing Esc to erase all letters. Pressing Esc again will close the search window.

After choosing a filter, the property sheet is displayed in the Object Inspector. Enter the desired parameters and hit Apply to create and display the filter. You will need to hit Apply every time you add a new filter or change an existing filter's parameters.

Note: A blue question mark icon appears next to the Delete button in the Object Inspector. Clicking this icon while a filter is selected will display the Help menu for that filter. This is only available for the ParaView filters; filters created specifically for ParaViewGeo are not covered in the ParaView help, and a message will display indicating that the file could not be found.

The Input Editor

Some filters require two input parameters, and the Input Editor window will display. This window is divided into three sections; Choose Input Port, Select Source and Pipeline Preview.

The Choose Input Port section has radio buttons labeled Input and Source, where you can choose the datasets that will be used for the filter; the name of the selected dataset appears in the text box. Note that the labels are constant for all filters, and don't necessarily identify which input is required. The Select Source section shows all the datasets available in the pipeline. Select the Input radio button and click on the dataset you want to use in the Select Source section. Repeat the process with the Source radio button selected. Once both are filled in, the Pipeline Preview will update to show what the pipeline will look like when the filter is applied, and if everything looks correct, click on OK.

A known bug exists on the Input Editor window where sometimes when you select the Source radio button and click on a dataset under Select Source, the text box remains empty. Click on Input, then click on Source again and re-select the dataset; it should now appear in the text box.

Changing the Input of a Filter

If a filter is applied to the wrong dataset, you can either delete the filter and then apply the filter to the correct dataset, or you can easily change the input of the filter without having to delete it.

In the Pipeline Browser, right-click on the filter; the menu that appears has an option called Change Input.... Selecting this option brings up the Input Editor window where the input source can be changed by selecting the dataset on the Select Source side.

Once you click on OK you will have to make the necessary property changes and then apply the filter to see the changes take effect.

Note: Although this works for most filters, there are some that will not update correctly. If this happens, you will have to delete the filter in the pipeline and apply it from the Filters menu.

The following pages explain how to use some of the filters found in ParaViewGeo:

Common ParaView Filters (Filters - Common)

ParaViewGeo Filters (Filters - Mirarco)

BillBoards Filters (Filters - BillBoards)

Data Analysis Filters (Filters - Data Analysis)

Other Filters (Filters - Alphabetical)

Note: Additional information regarding the ParaView filters can be found using Help > Help (or F1) and navigating to the Filters page in that help file.

Next Section Previous Section Return To
Linking Objects or Properties Selecting Data User Manual