Skip to content

Views

rerun.blueprint.views

class BarChartView

Bases: View

View: A bar chart view.

Example
Use a blueprint to create a BarChartView.:

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_bar_chart", spawn=True)
# It's recommended to log bar charts with the `rr.BarChart` archetype,
# but single dimensional tensors can also be used if a `BarChartView` is created explicitly.
rr.log("tensor", rr.Tensor([8, 4, 0, 9, 1, 4, 1, 6, 9, 0]))

# Create a bar chart view to display the chart.
blueprint = rrb.Blueprint(rrb.BarChartView(origin="tensor", name="Bar Chart"), collapse_panels=True)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, plot_legend=None)

Construct a blueprint for a new BarChartView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

plot_legend

Configures the legend of the plot.

TYPE: PlotLegend | Corner2D | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class DataframeView

Bases: View

View: A view to display any data in a tabular form.

Any data from the store can be shown, using a flexibly, user-configurable query.

Example
Use a blueprint to customize a DataframeView.:

import math

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_dataframe", spawn=True)

# Log some data.
for t in range(0, int(math.pi * 4 * 100.0)):
    rr.set_time_seconds("t", t)
    rr.log("trig/sin", rr.Scalar(math.sin(float(t) / 100.0)))
    rr.log("trig/cos", rr.Scalar(math.cos(float(t) / 100.0)))

    # some sparse data
    if t % 5 == 0:
        rr.log("trig/tan_sparse", rr.Scalar(math.tan(float(t) / 100.0)))

# Create a Dataframe View
blueprint = rrb.Blueprint(
    rrb.DataframeView(
        origin="/trig",
        query=rrb.archetypes.DataframeQuery(
            timeline="t",
            filter_by_range=(rr.TimeInt(seconds=0), rr.TimeInt(seconds=20)),
            filter_is_not_null="/trig/tan_sparse:Scalar",
            select=["t", "log_tick", "/trig/sin:Scalar", "/trig/cos:Scalar", "/trig/tan_sparse:Scalar"],
        ),
    ),
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, query=None)

Construct a blueprint for a new DataframeView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

query

Query of the dataframe.

TYPE: DataframeQuery | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class GraphView

Bases: View

View: A graph view to display time-variying, directed or undirected graph visualization.

Example
Use a blueprint to create a graph view.:

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_graph_view", spawn=True)

rr.log(
    "simple",
    rr.GraphNodes(
        node_ids=["a", "b", "c"], positions=[(0.0, 100.0), (-100.0, 0.0), (100.0, 0.0)], labels=["A", "B", "C"]
    ),
)

# Create a Spatial2D view to display the points.
blueprint = rrb.Blueprint(
    rrb.GraphView(
        origin="/",
        name="Graph",
        # Note that this translates the viewbox.
        visual_bounds=rrb.VisualBounds2D(x_range=[-150, 150], y_range=[-50, 150]),
    ),
    collapse_panels=True,
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, visual_bounds=None, force_link=None, force_many_body=None, force_position=None, force_collision_radius=None, force_center=None)

Construct a blueprint for a new GraphView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

visual_bounds

Everything within these bounds is guaranteed to be visible.

Somethings outside of these bounds may also be visible due to letterboxing.

TYPE: VisualBounds2D | None DEFAULT: None

force_link

Allows to control the interaction between two nodes connected by an edge.

TYPE: ForceLink | None DEFAULT: None

force_many_body

A force between each pair of nodes that ressembles an electrical charge.

TYPE: ForceManyBody | None DEFAULT: None

force_position

Similar to gravity, this force pulls nodes towards a specific position.

TYPE: ForcePosition | None DEFAULT: None

force_collision_radius

Resolves collisions between the bounding spheres, according to the radius of the nodes.

TYPE: ForceCollisionRadius | None DEFAULT: None

force_center

Tries to move the center of mass of the graph to the origin.

TYPE: ForceCenter | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class MapView

Bases: View

View: A 2D map view to display geospatial primitives.

Example
Use a blueprint to create a map view.:

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_map_view", spawn=True)

rr.log("points", rr.GeoPoints(lat_lon=[[47.6344, 19.1397], [47.6334, 19.1399]], radii=rr.Radius.ui_points(20.0)))

# Create a map view to display the chart.
blueprint = rrb.Blueprint(
    rrb.MapView(
        origin="points",
        name="MapView",
        zoom=16.0,
        background=rrb.MapProvider.OpenStreetMap,
    ),
    collapse_panels=True,
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, zoom=None, background=None)

Construct a blueprint for a new MapView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

zoom

Configures the zoom level of the map view.

TYPE: MapZoom | Float64Like | None DEFAULT: None

background

Configuration for the background map of the map view.

TYPE: MapBackground | MapProviderLike | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class Spatial2DView

Bases: View

View: For viewing spatial 2D data.

Example
Use a blueprint to customize a Spatial2DView.:

import numpy as np
import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_spatial_2d", spawn=True)

# Create a spiral of points:
n = 150
angle = np.linspace(0, 10 * np.pi, n)
spiral_radius = np.linspace(0.0, 3.0, n) ** 2
positions = np.column_stack((np.cos(angle) * spiral_radius, np.sin(angle) * spiral_radius))
colors = np.dstack((np.linspace(255, 255, n), np.linspace(255, 0, n), np.linspace(0, 255, n)))[0].astype(int)
radii = np.linspace(0.01, 0.7, n)

rr.log("points", rr.Points2D(positions, colors=colors, radii=radii))

# Create a Spatial2D view to display the points.
blueprint = rrb.Blueprint(
    rrb.Spatial2DView(
        origin="/",
        name="2D Scene",
        # Set the background color
        background=[105, 20, 105],
        # Note that this range is smaller than the range of the points,
        # so some points will not be visible.
        visual_bounds=rrb.VisualBounds2D(x_range=[-5, 5], y_range=[-5, 5]),
    ),
    collapse_panels=True,
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, background=None, visual_bounds=None, time_ranges=None)

Construct a blueprint for a new Spatial2DView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

background

Configuration for the background of the view.

TYPE: Background | Rgba32Like | BackgroundKindLike | None DEFAULT: None

visual_bounds

The visible parts of the scene, in the coordinate space of the scene.

Everything within these bounds are guaranteed to be visible. Somethings outside of these bounds may also be visible due to letterboxing.

TYPE: VisualBounds2D | None DEFAULT: None

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 latest state of each component. If a timeline is specified more than once, the first entry will be used.

TYPE: VisibleTimeRanges | VisibleTimeRangeLike | Sequence[VisibleTimeRangeLike] | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class Spatial3DView

Bases: View

View: For viewing spatial 3D data.

Example
Use a blueprint to customize a Spatial3DView.:

import rerun as rr
import rerun.blueprint as rrb
from numpy.random import default_rng

rr.init("rerun_example_spatial_3d", spawn=True)

# Create some random points.
rng = default_rng(12345)
positions = rng.uniform(-5, 5, size=[50, 3])
colors = rng.uniform(0, 255, size=[50, 3])
radii = rng.uniform(0.1, 0.5, size=[50])

rr.log("points", rr.Points3D(positions, colors=colors, radii=radii))
rr.log("box", rr.Boxes3D(half_sizes=[5, 5, 5], colors=0))

# Create a Spatial3D view to display the points.
blueprint = rrb.Blueprint(
    rrb.Spatial3DView(
        origin="/",
        name="3D Scene",
        # Set the background color to light blue.
        background=[100, 149, 237],
        # Configure the line grid.
        line_grid=rrb.archetypes.LineGrid3D(
            visible=True,  # The grid is enabled by default, but you can hide it with this property.
            spacing=0.1,  # Makes the grid more fine-grained.
            # By default, the plane is inferred from view coordinates setup, but you can set arbitrary planes.
            plane=rr.components.Plane3D.XY.with_distance(-5.0),
            stroke_width=2.0,  # Makes the grid lines twice as thick as usual.
            color=[255, 255, 255, 128],  # Colors the grid a half-transparent white.
        ),
    ),
    collapse_panels=True,
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, background=None, line_grid=None, time_ranges=None)

Construct a blueprint for a new Spatial3DView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

background

Configuration for the background of the view.

TYPE: Background | Rgba32Like | BackgroundKindLike | None DEFAULT: None

line_grid

Configuration for the 3D line grid.

TYPE: LineGrid3D | None DEFAULT: None

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 latest state of each component. If a timeline is specified more than once, the first entry will be used.

TYPE: VisibleTimeRanges | VisibleTimeRangeLike | Sequence[VisibleTimeRangeLike] | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class TensorView

Bases: View

View: A view on a tensor of any dimensionality.

Example
Use a blueprint to create a TensorView.:

import numpy as np
import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_tensor", spawn=True)

tensor = np.random.randint(0, 256, (32, 240, 320, 3), dtype=np.uint8)
rr.log("tensor", rr.Tensor(tensor, dim_names=("batch", "x", "y", "channel")))

blueprint = rrb.Blueprint(
    rrb.TensorView(
        origin="tensor",
        name="Tensor",
        # Explicitly pick which dimensions to show.
        slice_selection=rrb.TensorSliceSelection(
            # Use the first dimension as width.
            width=1,
            # Use the second dimension as height and invert it.
            height=rr.TensorDimensionSelection(dimension=2, invert=True),
            # Set which indices to show for the other dimensions.
            indices=[
                rr.TensorDimensionIndexSelection(dimension=2, index=4),
                rr.TensorDimensionIndexSelection(dimension=3, index=5),
            ],
            # Show a slider for dimension 2 only. If not specified, all dimensions in `indices` will have sliders.
            slider=[2],
        ),
        # Set a scalar mapping with a custom colormap, gamma and magnification filter.
        scalar_mapping=rrb.TensorScalarMapping(colormap="turbo", gamma=1.5, mag_filter="linear"),
        # Fill the view, ignoring aspect ratio.
        view_fit="fill",
    ),
    collapse_panels=True,
)
rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, slice_selection=None, scalar_mapping=None, view_fit=None)

Construct a blueprint for a new TensorView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

slice_selection

How to select the slice of the tensor to show.

TYPE: TensorSliceSelection | None DEFAULT: None

scalar_mapping

Configures how scalars are mapped to color.

TYPE: TensorScalarMapping | None DEFAULT: None

view_fit

Configures how the selected slice should fit into the view.

TYPE: TensorViewFit | ViewFitLike | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class TextDocumentView

Bases: View

View: A view of a single text document, for use with archetypes.TextDocument.

Example
Use a blueprint to show a text document.:

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_text_document", spawn=True)

rr.log(
    "markdown",
    rr.TextDocument(
        '''
# Hello Markdown!
[Click here to see the raw text](recording://markdown:Text).

Basic formatting:

| **Feature**       | **Alternative** |
| ----------------- | --------------- |
| Plain             |                 |
| *italics*         | _italics_       |
| **bold**          | __bold__        |
| ~~strikethrough~~ |                 |
| `inline code`     |                 |

----------------------------------

## Support
- [x] [Commonmark](https://commonmark.org/help/) support
- [x] GitHub-style strikethrough, tables, and checkboxes
- Basic syntax highlighting for:
  - [x] C and C++
  - [x] Python
  - [x] Rust
  - [ ] Other languages

## Links
You can link to [an entity](recording://markdown),
a [specific instance of an entity](recording://markdown[#0]),
or a [specific component](recording://markdown:Text).

Of course you can also have [normal https links](https://github.com/rerun-io/rerun), e.g. <https://rerun.io>.

## Image
![A random image](https://picsum.photos/640/480)
'''.strip(),
        media_type=rr.MediaType.MARKDOWN,
    ),
)

# Create a text view that displays the markdown.
blueprint = rrb.Blueprint(rrb.TextDocumentView(origin="markdown", name="Markdown example"), collapse_panels=True)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={})

Construct a blueprint for a new TextDocumentView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class TextLogView

Bases: View

View: A view of a text log, for use with archetypes.TextLog.

Example
Use a blueprint to show a TextLogView.:

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_text_log", spawn=True)

rr.set_time_sequence("time", 0)
rr.log("log/status", rr.TextLog("Application started.", level=rr.TextLogLevel.INFO))
rr.set_time_sequence("time", 5)
rr.log("log/other", rr.TextLog("A warning.", level=rr.TextLogLevel.WARN))
for i in range(10):
    rr.set_time_sequence("time", i)
    rr.log("log/status", rr.TextLog(f"Processing item {i}.", level=rr.TextLogLevel.INFO))

# Create a text view that displays all logs.
blueprint = rrb.Blueprint(rrb.TextLogView(origin="/log", name="Text Logs"), collapse_panels=True)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={})

Construct a blueprint for a new TextLogView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.

class TimeSeriesView

Bases: View

View: A time series view for scalars over time, for use with archetypes.Scalar.

Example
Use a blueprint to customize a TimeSeriesView.:

import math

import rerun as rr
import rerun.blueprint as rrb

rr.init("rerun_example_timeseries", spawn=True)

# Log some trigonometric functions
rr.log("trig/sin", rr.SeriesLine(color=[255, 0, 0], name="sin(0.01t)"), static=True)
rr.log("trig/cos", rr.SeriesLine(color=[0, 255, 0], name="cos(0.01t)"), static=True)
rr.log("trig/cos", rr.SeriesLine(color=[0, 0, 255], name="cos(0.01t) scaled"), static=True)
for t in range(0, int(math.pi * 4 * 100.0)):
    rr.set_time_sequence("timeline0", t)
    rr.set_time_seconds("timeline1", t)
    rr.log("trig/sin", rr.Scalar(math.sin(float(t) / 100.0)))
    rr.log("trig/cos", rr.Scalar(math.cos(float(t) / 100.0)))
    rr.log("trig/cos_scaled", rr.Scalar(math.cos(float(t) / 100.0) * 2.0))

# Create a TimeSeries View
blueprint = rrb.Blueprint(
    rrb.TimeSeriesView(
        origin="/trig",
        # Set a custom Y axis.
        axis_y=rrb.ScalarAxis(range=(-1.0, 1.0), zoom_lock=True),
        # Configure the legend.
        plot_legend=rrb.PlotLegend(visible=False),
        # Set time different time ranges for different timelines.
        time_ranges=[
            # Sliding window depending on the time cursor for the first timeline.
            rrb.VisibleTimeRange(
                "timeline0",
                start=rrb.TimeRangeBoundary.cursor_relative(seq=-100),
                end=rrb.TimeRangeBoundary.cursor_relative(),
            ),
            # Time range from some point to the end of the timeline for the second timeline.
            rrb.VisibleTimeRange(
                "timeline1",
                start=rrb.TimeRangeBoundary.absolute(seconds=300.0),
                end=rrb.TimeRangeBoundary.infinite(),
            ),
        ],
    ),
    collapse_panels=True,
)

rr.send_blueprint(blueprint)

def __init__(*, origin='/', contents='$origin/**', name=None, visible=None, defaults=[], overrides={}, axis_y=None, plot_legend=None, time_ranges=None)

Construct a blueprint for a new TimeSeriesView view.

PARAMETER DESCRIPTION
origin

The EntityPath to use as the origin of this view. All other entities will be transformed to be displayed relative to this origin.

TYPE: EntityPathLike DEFAULT: '/'

contents

The contents of the view specified as a query expression. This is either a single expression, or a list of multiple expressions. See rerun.blueprint.archetypes.ViewContents.

TYPE: ViewContentsLike DEFAULT: '$origin/**'

name

The display name of the view.

TYPE: Utf8Like | None DEFAULT: None

visible

Whether this view is visible.

Defaults to true if not specified.

TYPE: BoolLike | None DEFAULT: None

defaults

List of default components or component batches to add to the view. When an archetype in the view is missing a component included in this set, the value of default will be used instead of the normal fallback for the visualizer.

TYPE: list[Union[AsComponents, ComponentBatchLike]] DEFAULT: []

overrides

Dictionary of overrides to apply to the view. The key is the path to the entity where the override should be applied. The value is a list of component or component batches to apply to the entity.

Important note: the path must be a fully qualified entity path starting at the root. The override paths do not yet support $origin relative paths or glob expressions. This will be addressed in https://github.com/rerun-io/rerun/issues/6673.

TYPE: dict[EntityPathLike, list[ComponentBatchLike]] DEFAULT: {}

axis_y

Configures the vertical axis of the plot.

TYPE: ScalarAxis | None DEFAULT: None

plot_legend

Configures the legend of the plot.

TYPE: PlotLegend | Corner2D | None DEFAULT: None

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.

TYPE: VisibleTimeRanges | VisibleTimeRangeLike | Sequence[VisibleTimeRangeLike] | None DEFAULT: None

def blueprint_path()

The blueprint path where this view will be logged.

Note that although this is an EntityPath, is scoped to the blueprint tree and not a part of the regular data hierarchy.

def to_blueprint()

Convert this view to a full blueprint.

def to_container()

Convert this view to a container.