# 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-1e2d6df4d8b3038fac4395f1a45d6d4de52495ab%2Fimage%20(331).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-b648a4c0a17f7b1170e44221f14996fb4ac38cba%2Fimage%20(330).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-9342eedd5df5ca67dc56a3d598bb3800af4421f1%2Fimage%20(339).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-58052ff89d467d7dd9b40855bb5945cacbde5fd8%2Fimage%20(338).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-fe66d604c35dd0f8fbfecb8da73ed2461c3e7272%2Fimage%20(340).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-712bc0dbc7cec3f70ea907d71bb91df5f349b201%2Fimage%20(337).png?alt=media" 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="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-ae00dbdae4ed093c74a1a54f43595ea69917d26c%2Fimage%20(408)%20(1).png?alt=media" alt=""><figcaption><p>Example of plot targets</p></figcaption></figure>
