---
title: "TimeSeriesView"
---
<!-- DO NOT EDIT! This file was auto-generated by crates/build/re_types_builder/src/codegen/docs/website.rs -->

⚠️ **This type is _unstable_ and may change significantly in a way that the data won't be backwards compatible.**
A time series view for scalars over time, for use with [`archetypes.Scalars`](https://rerun.io/docs/reference/types/archetypes/scalars).

## Properties

### `axis_x`
Configures the horizontal axis of the plot.

* `link`: How should the horizontal/X/time axis be linked across multiple plots?
* `view_range`: The view range of the horizontal/X/time axis.
* `zoom_lock`: If enabled, the X axis range will remain locked to the specified range when zooming.
### `axis_y`
Configures the vertical axis of the plot.

* `range`: The range of the axis.
* `zoom_lock`: If enabled, the Y axis range will remain locked to the specified range when zooming.
### `plot_legend`
Configures the legend of the plot.

* `corner`: To what corner the legend is aligned.
* `visible`: Whether the legend is shown at all.
### `background`
Configures the background of the plot.

* `color`: Color used for the background.
* `show_grid`: Should the grid be drawn?
### `time_ranges`
Configures which range on each timeline is shown by this view (unless specified differently per entity).

If not specified, the default is to show the entire timeline.
If a timeline is specified more than once, the first entry will be used.

## API reference links
 * 🐍 [Python API docs for `TimeSeriesView`](https://ref.rerun.io/docs/python/stable/common/blueprint_views#rerun.blueprint.views.TimeSeriesView)

## Example

### Use a blueprint to customize a TimeSeriesView.

snippet: views/timeseries

<picture data-inline-viewer="snippets/views/timeseries">
  <source media="(max-width: 480px)" srcset="https://static.rerun.io/timeseries_view/c87150647feb413627fdb8563afe33b39d7dbf57/480w.png">
  <source media="(max-width: 768px)" srcset="https://static.rerun.io/timeseries_view/c87150647feb413627fdb8563afe33b39d7dbf57/768w.png">
  <source media="(max-width: 1024px)" srcset="https://static.rerun.io/timeseries_view/c87150647feb413627fdb8563afe33b39d7dbf57/1024w.png">
  <source media="(max-width: 1200px)" srcset="https://static.rerun.io/timeseries_view/c87150647feb413627fdb8563afe33b39d7dbf57/1200w.png">
  <img src="https://static.rerun.io/timeseries_view/c87150647feb413627fdb8563afe33b39d7dbf57/full.png">
</picture>


## Visualized archetypes

* [`Clear`](../archetypes/clear.md)
* [`Scalars`](../archetypes/scalars.md)
* [`SeriesLines`](../archetypes/series_lines.md)
* [`SeriesPoints`](../archetypes/series_points.md)

