# Data Viewer

Data viewer is a general purpose data visualization tool, it convey complicated information in a powerful but intuitive way to help you explore and explain the data.

### Terminology

**Data Viewer** - a collection of sheets

**Sheet** - one or more linked plots and controls

**Plot** - a visualization

**Droppable -** data that can be dragged and dropped

**Target** - location to drop a droppable

**Node** - data results from the analysis pipeline

### Saving data

* To save an individual image within the Data Viewer to your machine, click **Plot** then **Export image** & select the format, size, and resolution then click **Save**. Use the plot-specific tools for this.

<figure><img src="/files/WGJg8twZ2jwGNchPuBF2" alt=""><figcaption><p>Export the individual plot that has been selected to your machine</p></figcaption></figure>

* All visualizations within a sheet in the Data Viewer can be exported as one image (e.g. use one image with all plots for a poster). Use the **Export** drop-down at the top of the data-viewer for this and select **Export image**.

<figure><img src="/files/2OEa2OP19tbboHZhflSK" alt=""><figcaption><p>Export all visualizations present in the Data viewer session as one image</p></figcaption></figure>

### Navigation

#### General controls and Adding plots

* **Undo**
  * Recover backward actions
* **Redo**
  * Recover forward actions
* **Export**
  * **Export image** - download one visualization of all plots in a view to your computer
  * **Capture video** - capture a video with various formats
* **Setup**
  * **New plot** - choose a plot type to add to the sheet, then select data from the analysis pipeline
  * **Get data** - select data from the analysis pipeline, then choose the plot type
* **Save**
  * **Save** - overwrite a saved session
  * **Save as** - save a new session using a new name

<figure><img src="/files/18whwieNilDOB3vLYlJm" alt=""><figcaption><p>General contorls</p></figcaption></figure>

#### Plot controls

Plot controls are context-sensitive and available options will change according to the plot type selected.

* **Data**
  * Controls to use to export plot level data & get data to modify the plot
* **Selection**
  * Controls to make and modify selections, classify, and filter
  * Includes pointer, ruler, paint brush, eraser, rectangle, ellipse, lasso and invert selection tools
* **Configure**
  * Controls to add content and configure plots to modify the plot as needed
  * Includes axes, style, grouping, description and control tools
* **Plot**
  * Additional plot controls including duplicate, export, and reset legend position
  * Also allows you to reset view, toggle ledgent, toggle axis auto-scale, view full screen and remove

<figure><img src="/files/FmVesxRWrnpqnFjJ75CT" alt=""><figcaption><p>Plot controls</p></figcaption></figure>

#### Modify sheets in the Data viewer session

* Click + to add a sheet to the Data viewer session
* Use the drop-down to Rename, Duplicate, or Delete a sheet

<figure><img src="/files/UQn5krjhSS7uz7DaNPAz" alt=""><figcaption><p>Add or modify a sheet in the Data viewer session</p></figcaption></figure>

#### Drag and drop

Data can be dragged and dropped to target locations.

* Data that can be dragged
  * Includes legend content, axis titles, criteria used in Select & Filter, and table features.
  * Data nodes, features, and attributes present in the **Configure** options (e.g., Axes and Style).
  * **Setup > New plot** and **Setup > Get data** options used to create plots.
  * Features from an appropriate node in **Data > Get data** or **Setup > Get data** (e.g., normalized counts). The Recently used list can be helpful for this if you have already recently used a gene.
  * Data from another plot on the sheet (e.g., an axis title from a violin plot) to a plot or plot control
  * Data from **Selection > Select & Filter > Criteria**
* Drop targets will change dependent on the action taken.

  * Targets can be options within plot controls (e.g. **Selection > Select & Filter > Criteria** to generate selections or **Configure > Axes**).
  * **Setup > New plot** or **Setup > Get data** targets include: Top, Right, Bottom, Left providing a location to add a new plot.

  <figure><img src="/files/YkJ2NrOEAGvn2CopHvjS" alt="" width="207"><figcaption><p>Setup targets</p></figcaption></figure>

  * Plot targets to drop data include: Y axis, Z axis, X axis, Color, Shape, Size, Label, Split, Connect, Highlight, Annotation.

  <figure><img src="/files/MDte50cQAssxn6YTfGbN" alt=""><figcaption><p>Example of plot targets</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.connected.illumina.com/icm/analyses/analysis-functionality/data-viewer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.