# Line plots

> Graph data using line plots.

![](https://synnax.nyc3.cdn.digitaloceanspaces.com/docs/console/line-plots/example-light.png)

Line plots graph real-time or historical data. They plot one or more channels along the y-axes, with time or another channel on the x-axis.

## Creating a plot

Create a line plot with the `Create a line plot` command in the [command palette](https://docs.synnaxlabs.com/reference/console/ui-overview#search-and-command-palette), or by adding a new tab and selecting the line plot visualization.

> Make sure that you are working in an [**active project**](https://docs.synnaxlabs.com/reference/console/projects). A line plot created outside one is **not saved**.

[](https://synnax.nyc3.cdn.digitaloceanspaces.com/docs/console/line-plots/create-dark.mp4#t=0.001)

## Configuring the plot

Click the line plot button in the bottom-left corner to open the component toolbar and configure the plot.

[](https://synnax.nyc3.cdn.digitaloceanspaces.com/docs/console/line-plots/toolbar-dark.mp4#t=0.001)

### Data

| Parameter  | Description                                                                                                                                           |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Y1**     | The channels to plot along the left-hand axis.                                                                                                        |
| **Y2**     | The channels to plot along the right-hand axis.                                                                                                       |
| **Ranges** | The time ranges to plot. If you select multiple ranges, the x-axis will scale to accommodate both. Rolling time ranges allow you to stream live data. |
| **X1**     | The channel to use for the x-axis.                                                                                                                    |

### Lines

| Parameter        | Description                                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Label**        | The text that appears in the legend for the channel. Changing the label does not change the channel name.          |
| **Line width**   | The thickness of the line.                                                                                         |
| **Downsampling** | Reduces the number of data points plotted for each channel. If downsampling is 5, every 5th data point is plotted. |
| **Color**        | The color of the line.                                                                                             |

### Axes

| Parameter           | Description                                  |
| ------------------- | -------------------------------------------- |
| **Lower bound**     | The lower bound of the axis.                 |
| **Upper bound**     | The upper bound of the axis.                 |
| **Tick spacing**    | The distance between tick marks on the axis. |
| **Label**           | The title of the axis.                       |
| **Label direction** | The direction of the axis title.             |
| **Label size**      | The size of the axis title.                  |

### Properties

| Parameter       | Description                                     |
| --------------- | ----------------------------------------------- |
| **Title**       | The title of the line plot.                     |
| **Show title**  | Whether the title is visible on the line plot.  |
| **Show legend** | Whether the legend is visible on the line plot. |

## Navigating the plot

In the top-right corner of the line plot, there are options for navigating the line plot.

### Pan

Pan the line plot by clicking the pan button or by pressing and left click.

### Select

Select data by clicking the selection button or by pressing (Windows) / (macOS) and dragging a box on the plot. Right-click the selection to copy the time range in Python, TypeScript, or ISO format, create a range from it, or download the data as a CSV.

### Zoom

Zoom on the line plot by clicking the zoom button in the or by pressing (Windows) / (macOS) and left click. This will adjust the axes of the line plot to the area of the box.

### Reset zoom

Reset the zoom by clicking the expand button or by pressing (Windows) / (macOS) and left click.

### Show tooltip on hover

Clicking the tooltip button will determine whether a tooltip is shown when hovering over navigation options.

### Pause live plotting

Pressing the `H` key or clicking the pause button will pause live plotting.

### Slope

The slope button allows you to select two points on the line plot and calculate the slope between them. You can also see the difference in the x and y axes. To change the first point, press the `1` key and click on the line plot. To change the second point, press the `2` key and click on the line plot.

[](https://synnax.nyc3.cdn.digitaloceanspaces.com/docs/console/line-plots/slope-dark.mp4#t=0.001)

## Sharing and exporting

Select `Copy link` from the Projects or Component Toolbar. Anyone on the Core can open it from a browser.

Select `Export` to save the line plot as a JSON file. Drag the file back into the Console to import it.