How Row Selection Works

Row selection state is synchronized across tabs within a project. Selecting rows in the Data Table reflects the same selection in the Statistics tab and Graph Builder. Selecting rows in Graph Builder highlights them in the Data Table as well.

You can select rows that appear to be outliers to see where they fall on graphs, or highlight only data meeting certain conditions.

Selection Methods

Data Table

In the Data Table, click rows to select them.

  • Single row: Click a row to select it. Any existing selection is cleared. If exactly one row is selected, clicking that row again clears the selection
  • Range selection: Hold Shift while clicking to select a contiguous range from the previously clicked row
  • Add/remove: Hold Ctrl/Cmd while clicking to add to the existing selection. Ctrl/Cmd+click a selected row to deselect it

Graph Builder

Graph Builder supports selection methods that vary by graph type.

Click selection -- Click data points, bars, or bins to select. Hold Ctrl/Cmd while clicking to add to the selection.

Rectangle selection -- Switch to Select mode using the buttons in the top-right corner of the graph, then drag to select.

  • Pan mode: Drag to pan the graph (default)
  • Select mode: Drag to select a rectangular range

Clearing selection -- When rows are selected, a Clear selection button (×) appears in the toolbar at the top right of the graph. Click it to clear the selection. Clicking a selected element without modifier keys switches to selecting that element only.

Double-click a data point or bar to open a Filtered Data tab showing the matching rows. When a Graph Builder graph that draws a derived dataset declares its underlying data with Select & drill down on, double-clicking instead opens a Contributing rows tab with the underlying rows.

Statistics Tab

You can also select rows from histograms and pair detail scatter plots in the Statistics tab. The charts in the Selected Columns tab work the same way.

  • Click a histogram bar to select rows within that bar's range
  • In the pair detail scatter plot, click points to select them. Switch to Select mode to drag and select a rectangular range
  • Hold Ctrl/Cmd while clicking to add to the selection
  • Double-click to open a Filtered Data tab
  • Click the Clear selection button (×) shown at the top right of the graph to clear the selection

Agent API

datasets.selectRows() in the Agent API writes the same selection state. Selecting by an array of row indices makes the same selection as clicking rows in the Data Table, and selecting by a filter expression makes a selection with a condition, like a rectangle selection. A selection made in the UI can be read with datasets.getSelection().

Tabs Related to Selection

TabBehavior
Data TableHighlights selected rows with a background color
StatisticsHighlights selected rows on histograms and pair detail scatter plots. Statistics are computed on all rows after filtering
Selected ColumnsHighlights selected rows on its charts, the same as the Statistics tab
Graph BuilderHighlights selected rows. In scatter plots, unselected points become faded. In bar charts, the selected range is drawn as a colored overlay
Filtered DataOpens on double-click of a data point or bar, showing the rows that data point or bar represents in a table. It does not depend on row selection state; clearing the selection does not change what it shows

Relationship with Filters

Data Table filters and row selection are separate operations. Filters narrow the rows available for display and analysis. Row selection highlights specific rows within that filtered set.

When a filter is active in the Statistics tab, statistics are computed on the filtered rows only. Row selection does not affect statistics computation; it is reflected only as highlights on graphs. To view statistics for specific rows only, use a filter to narrow the data.

Saving Selected Rows

Row selection state is not saved in the project file. Selections are cleared when you close the project. To reuse selected rows later, save them as a derived dataset.

Rows selected by clicking a graph element or by rectangle selection can be opened as a Filtered Data tab with a double-click and saved as a derived dataset with its Save as Dataset button. Saved derived datasets reference the source data by filter expression, so they return matching rows even after the source data is updated. They can be analyzed in other tabs like any regular dataset.

See also