Filtering Data

Filters can be used to refine the data set that is viewed in DArTView and can be saved for reuse. Filters can be either created or loaded from a previously saved filter file.


Filter Panel

The Filter panel displays all active and inactive (checked/unchecked) filters and provides options for managing those filters. The filter panel will switch with the Markers or Samples tab.

The image below demonstrates a marker data file with a single filter to remove markers with a call rate above 0.630475. See the table below the image which outlines the available filtering options:


Filters Panel
Filters Panel (select to zoom)


Filters Panel Options

UI Element

Description

add_btn Add New Filter Button

Displays the Add New Filter window which provides options for creating a new filter.

remove_red_btn Remove Filter Button

Removes the selected filter.

Remove Mono Checkbox (Markers only)

This is a special filter that is applied only after standard filters (both markers and samples) are applied. A monomorphic marker is defined as a marker with only one allele visible across the samples (ignore missing values). Such markers are considered uninformative and are often redundant in downstream analysis. The Remove Monomorphs filter is always available by default and can’t be removed. However, this checkbox allows the user to enable/disable this filter.

edit_btn Edit Filter Button

Opens the Edit Filter window for editing a selected filter.

check_all_btn Check All Button

Enables all filters in the Filters panel.

uncheck_all_btn Uncheck All Button

Disables all filters in the Filters panel.

eraser_btn Uncheck Not Applicable Filters Button

Disables all filters that do not apply to the marker data file that is currently open.

filter_save_btn Export Filters Button

Provides options for exporting selected filters to a separate file so that they can be reused again.

Percentage Checkbox

By default, each filter will display the number of data points that are excluded if the filter is active. This checkbox will display the number as a percentage rather than a count.

filterdata_save_btn Export Data with Filters Button

Provides options for exporting data with the filters that have been applied.


Exporting and Importing Filters

Filters can be saved so that they can be imported and exported when needed. See the below section on how to start with importing a filter.


Importing

Importing a filter file is done by clicking+dragging the filter file from the file explorer and dropping it into the Filter panel.


Importing a Filter File
Importing a Filter File (select to zoom)


Exporting

Saving a filter will create a file with saved filters from the current session. These files can be exported and used again in the future.


Exporting a Filter File
Exporting a Filter File (select to zoom)


Exporting a Filter File

Step

Action

1.

On the Filter panel, select the Export Filters button.

2.

Select a location to save the filter file.

3.

Select the Save button to complete the export.


Creating New Filters

There are two approaches to creating new filters. The first is via the Filter panel and the second is via the graph.


Creating a Filter in the Filter Panel

Filters can be created in the Filter panel without needing to view any graphed data. See the instructions below for more information:


Creating a Filter in the Filter Panel
Creating a Filter in the Filter Panel (select to zoom)


Creating a Filter in the Filters Panel 1/2

Step

Action

1.

Select the Add Filter button add_btn in the Filter panel at circle1 to begin creating a new filter. This will open the Add New Filter window at circle2.

2.

Select the Add Filter button add_btn within the Add New Filter window to start creating a filter condition. Each filter can have one or more conditions. It will open the Add Filter window at circle3.

3.

Choose the metadata for the filter then select the Ok button to finalise the selection. The Add New Filter window will be updated as seem in the image below.


Creating a Filter Condition
Creating a Filter Condition (select to zoom)


Creating a Filter in the Filters Panel 2/2

Step

Action

4.

The filter condition can be edited by double-clicking the Metadata Name, Exclude If (such as in the above image), and Value fields.

5.

Select the Confirm button (the tick) to finalise the creation of the filter. The graph will be updated such as in the image below.


Filtered Data
Filtered Data (select to zoom)


Tip

Both the scatter plot and histogram will be affected by applied filters.


Creating a Filter in a Histogram or Scatter Plot

New filters can also be created within a histogram or scatter plot. This allows users to filter based on the graph they are viewing. See the instructions below for more information:


Filtering Data from a Graph
Filtering Data from a Graph (select to zoom)


Creating a Filter in a Histogram or Scatter Plot

Step

Action

1.

Open a histogram or scatterplot from the Metadata panel by selecting the relevant checkbox.

2.

Right+click in a section within the graph that you want to place a filter (such as in the above image). Filtering (and other) options will be presented.

3.

Select a filtering option. This will add and apply the filter immediately as seen in the image below.


Filtered Data
Filtered Data (select to zoom)