Archetypes

`rerun.blueprint.archetypes`

`class Background`

Bases: BackgroundExt, Archetype

Archetype: Configuration for the background of a view.

`def init(color_or_kind=None, *, color=None, kind=None)`

Create a new instance of the Background archetype.

PARAMETER	DESCRIPTION
`color_or_kind`	Either a color for solid background color or kind of the background (see `BackgroundKind`). If set, `color` and `kind` must not be set. TYPE: `Rgba32Like \| BackgroundKindLike \| None` DEFAULT: `None`
`kind`	The type of the background. Defaults to BackgroundKind.GradientDark. TYPE: `BackgroundKindLike \| None` DEFAULT: `None`
`color`	Color used for BackgroundKind.SolidColor. Defaults to White. TYPE: `Rgba32Like \| None` DEFAULT: `None`

`class ContainerBlueprint`

Bases: Archetype

Archetype: The description of a container.

`def init(container_kind, *, display_name=None, contents=None, col_shares=None, row_shares=None, active_tab=None, visible=None, grid_columns=None)`

Create a new instance of the ContainerBlueprint archetype.

PARAMETER	DESCRIPTION
`container_kind`	The class of the view. TYPE: `ContainerKindLike`
`display_name`	The name of the container. TYPE: `Utf8Like \| None` DEFAULT: `None`
`contents`	`ContainerId`s or `SpaceViewId`s that are children of this container. TYPE: `EntityPathArrayLike \| None` DEFAULT: `None`
`col_shares`	The layout shares of each column in the container. For `Horizontal` containers, the length of this list should always match the number of contents. Ignored for `Vertical` containers. TYPE: `Float32ArrayLike \| None` DEFAULT: `None`
`row_shares`	The layout shares of each row of the container. For `Vertical` containers, the length of this list should always match the number of contents. Ignored for `Horizontal` containers. TYPE: `Float32ArrayLike \| None` DEFAULT: `None`
`active_tab`	Which tab is active. Only applies to `Tabs` containers. TYPE: `EntityPathLike \| None` DEFAULT: `None`
`visible`	Whether this container is visible. Defaults to true if not specified. TYPE: `BoolLike \| None` DEFAULT: `None`
`grid_columns`	How many columns this grid should have. If unset, the grid layout will be auto. Ignored for `Horizontal`/`Vertical` containers. TYPE: `UInt32Like \| None` DEFAULT: `None`

`class DataframeQuery`

Bases: DataframeQueryExt, Archetype

Archetype: The query for the dataframe view.

`def init(*, timeline=None, filter_by_range=None, filter_is_not_null=None, apply_latest_at=False, select=None)`

Create a new instance of the DataframeQuery archetype.

PARAMETER	DESCRIPTION
`timeline`	The timeline for this query. TYPE: `Utf8Like \| None` DEFAULT: `None`
`filter_by_range`	If set, a range filter is applied. TYPE: `tuple[TimeInt, TimeInt] \| FilterByRangeLike \| None` DEFAULT: `None`
`filter_is_not_null`	If provided, the dataframe will only contain rows corresponding to timestamps at which an event was logged for the provided column. TYPE: `ComponentColumnSelectorLike \| None` DEFAULT: `None`
`apply_latest_at`	Should empty cells be filled with latest-at queries? TYPE: `bool` DEFAULT: `False`
`select`	Selected columns. If unset, all columns are selected. TYPE: `list[ComponentColumnSelectorLike \| Utf8Like \| str] \| None` DEFAULT: `None`

`class MapBackground`

Bases: Archetype

Archetype: Configuration for the background map of the map view.

`def init(provider)`

Create a new instance of the MapBackground archetype.

PARAMETER	DESCRIPTION
`provider`	Map provider and style to use. Note: Requires a Mapbox API key in the `RERUN_MAPBOX_ACCESS_TOKEN` environment variable. TYPE: `MapProviderLike`

`class MapZoom`

Bases: Archetype

Archetype: Configuration of the map view zoom level.

`def init(zoom)`

Create a new instance of the MapZoom archetype.

PARAMETER	DESCRIPTION
`zoom`	Zoom level for the map. Zoom level follow the `OpenStreetMap` definition. TYPE: `Float64Like`

`class PanelBlueprint`

Bases: Archetype

Archetype: Shared state for the 3 collapsible panels.

`def init(*, state=None)`

Create a new instance of the PanelBlueprint archetype.

`class PlotLegend`

Bases: PlotLegendExt, Archetype

Archetype: Configuration for the legend of a plot.

`def init(corner=None, *, visible=None)`

Create a new instance of the PlotLegend archetype.

PARAMETER	DESCRIPTION
`corner`	To what corner the legend is aligned. Defaults to the right bottom corner. TYPE: `Corner2DLike \| None` DEFAULT: `None`
`visible`	Whether the legend is shown at all. True by default. TYPE: `BoolLike \| None` DEFAULT: `None`

`class ScalarAxis`

Bases: Archetype

Archetype: Configuration for the scalar axis of a plot.

`def init(*, range=None, zoom_lock=None)`

Create a new instance of the ScalarAxis archetype.

PARAMETER	DESCRIPTION
`range`	The range of the axis. If unset, the range well be automatically determined based on the queried data. TYPE: `Range1DLike \| None` DEFAULT: `None`
`zoom_lock`	If enabled, the Y axis range will remain locked to the specified range when zooming. TYPE: `BoolLike \| None` DEFAULT: `None`

`class SpaceViewBlueprint`

Bases: Archetype

Archetype: The description of a single view.

`def init(class_identifier, *, display_name=None, space_origin=None, visible=None)`

Create a new instance of the SpaceViewBlueprint archetype.

PARAMETER	DESCRIPTION
`class_identifier`	The class of the view. TYPE: `Utf8Like`
`display_name`	The name of the view. TYPE: `Utf8Like \| None` DEFAULT: `None`
`space_origin`	The "anchor point" of this space view. Defaults to the root path '/' if not specified. The transform at this path forms the reference point for all scene->world transforms in this space view. I.e. the position of this entity path in space forms the origin of the coordinate system in this space view. Furthermore, this is the primary indicator for heuristics on what entities we show in this space view. TYPE: `EntityPathLike \| None` DEFAULT: `None`
`visible`	Whether this space view is visible. Defaults to true if not specified. TYPE: `BoolLike \| None` DEFAULT: `None`

`class SpaceViewContents`

Bases: Archetype

Archetype: The contents of a SpaceView.

The contents are found by combining a collection of QueryExpressions.

+ /world/**           # add everything…
- /world/roads/**     # …but remove all roads…
+ /world/roads/main   # …but show main road

If there is multiple matching rules, the most specific rule wins. If there are multiple rules of the same specificity, the last one wins. If no rules match, the path is excluded.

Specifying a path without a + or - prefix is equivalent to +:

/world/**           # add everything…
- /world/roads/**   # …but remove all roads…
/world/roads/main   # …but show main road

The /** suffix matches the whole subtree, i.e. self and any child, recursively (/world/** matches both /world and /world/car/driver). Other uses of * are not (yet) supported.

Internally, EntityPathFilter sorts the rule by entity path, with recursive coming before non-recursive. This means the last matching rule is also the most specific one. For instance:

+ /world/**
- /world
- /world/car/**
+ /world/car/driver

The last rule matching /world/car/driver is + /world/car/driver, so it is included. The last rule matching /world/car/hood is - /world/car/**, so it is excluded. The last rule matching /world is - /world, so it is excluded. The last rule matching /world/house is + /world/**, so it is included.

`def init(query)`

Create a new instance of the SpaceViewContents archetype.

PARAMETER	DESCRIPTION
`query`	The `QueryExpression` that populates the contents for the `SpaceView`. They determine which entities are part of the spaceview. TYPE: `Utf8ArrayLike`

`class TensorScalarMapping`

Bases: Archetype

Archetype: Configures how tensor scalars are mapped to color.

`def init(*, mag_filter=None, colormap=None, gamma=None)`

Create a new instance of the TensorScalarMapping archetype.

PARAMETER	DESCRIPTION
`mag_filter`	Filter used when zooming in on the tensor. Note that the filter is applied to the scalar values before they are mapped to color. TYPE: `MagnificationFilterLike \| None` DEFAULT: `None`
`colormap`	How scalar values map to colors. TYPE: `ColormapLike \| None` DEFAULT: `None`
`gamma`	Gamma exponent applied to normalized values before mapping to color. Raises the normalized values to the power of this value before mapping to color. Acts like an inverse brightness. Defaults to 1.0. The final value for display is set as: `colormap( ((value - data_display_range.min) / (data_display_range.max - data_display_range.min)) gamma )` TYPE: `Float32Like \| None` DEFAULT:** `None`

`class TensorSliceSelection`

Bases: Archetype

Archetype: Specifies a 2D slice of a tensor.

`def init(*, width=None, height=None, indices=None, slider=None)`

Create a new instance of the TensorSliceSelection archetype.

PARAMETER	DESCRIPTION
`width`	Which dimension to map to width. If not specified, the height will be determined automatically based on the name and index of the dimension. TYPE: `TensorDimensionSelectionLike \| None` DEFAULT: `None`
`height`	Which dimension to map to height. If not specified, the height will be determined automatically based on the name and index of the dimension. TYPE: `TensorDimensionSelectionLike \| None` DEFAULT: `None`
`indices`	Selected indices for all other dimensions. If any of the here listed dimensions is equal to `width` or `height`, it will be ignored. TYPE: `TensorDimensionIndexSelectionArrayLike \| None` DEFAULT: `None`
`slider`	Any dimension listed here will have a slider for the index. Edits to the sliders will directly manipulate dimensions on the `indices` list. If any of the here listed dimensions is equal to `width` or `height`, it will be ignored. If not specified, adds slides for any dimension in `indices`. TYPE: `TensorDimensionIndexSliderArrayLike \| None` DEFAULT: `None`

`class TensorViewFit`

Bases: TensorViewFitExt, Archetype

Archetype: Configures how a selected tensor slice is shown on screen.

`def init(scaling=None)`

Create a new instance of the TensorViewFit archetype.

PARAMETER	DESCRIPTION
`scaling`	How the image is scaled to fit the view. TYPE: `ViewFitLike \| None` DEFAULT: `None`

`class ViewportBlueprint`

Bases: Archetype

Archetype: The top-level description of the viewport.

`def init(*, root_container=None, maximized=None, auto_layout=None, auto_space_views=None, past_viewer_recommendations=None)`

Create a new instance of the ViewportBlueprint archetype.

PARAMETER	DESCRIPTION
`root_container`	The layout of the space-views TYPE: `UuidLike \| None` DEFAULT: `None`
`maximized`	Show one tab as maximized? TYPE: `UuidLike \| None` DEFAULT: `None`
`auto_layout`	Whether the viewport layout is determined automatically. If `true`, the container layout will be reset whenever a new space view is added or removed. This defaults to `false` and is automatically set to `false` when there is user determined layout. TYPE: `BoolLike \| None` DEFAULT: `None`
`auto_space_views`	Whether or not space views should be created automatically. If `true`, the viewer will only add space views that it hasn't considered previously (as identified by `past_viewer_recommendations`) and which aren't deemed redundant to existing space views. This defaults to `false` and is automatically set to `false` when the user adds space views manually in the viewer. TYPE: `BoolLike \| None` DEFAULT: `None`
`past_viewer_recommendations`	Hashes of all recommended space views the viewer has already added and that should not be added again. This is an internal field and should not be set usually. If you want the viewer from stopping to add space views, you should set `auto_space_views` to `false`. The viewer uses this to determine whether it should keep adding space views. TYPE: `UInt64ArrayLike \| None` DEFAULT: `None`

`class VisibleTimeRanges`

Bases: VisibleTimeRangesExt, Archetype

Archetype: Configures what range of each timeline is shown on a view.

Whenever no visual time range applies, queries are done with "latest-at" semantics. This means that the view will, starting from the time cursor position, query the latest data available for each component type.

The default visual time range depends on the type of view this property applies to: - For time series views, the default is to show the entire timeline. - For any other view, the default is to apply latest-at semantics.

`def init(ranges)`

Create a new instance of the VisibleTimeRanges archetype.

PARAMETER	DESCRIPTION
`ranges`	The time ranges to show for each timeline unless specified otherwise on a per-entity basis. If a timeline is listed twice, a warning will be issued and the first entry will be used. TYPE: `VisibleTimeRangeArrayLike`

`class VisualBounds2D`

Bases: VisualBounds2DExt, Archetype

Archetype: Controls the visual bounds of a 2D view.

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

If no visual bounds are set, it will be determined automatically, based on the bounding-box of the data or other camera information present in the view.

`def init(*, x_range, y_range)`

Create a new instance of the VisualBounds2D archetype.

PARAMETER	DESCRIPTION
`x_range`	The minimum visible range of the X-axis (usually left and right bounds). TYPE: `Range1DLike`
`y_range`	The minimum visible range of the Y-axis (usually left and right bounds). TYPE: `Range1DLike`

Archetypes

rerun.blueprint.archetypes

class Background

def __init__(color_or_kind=None, *, color=None, kind=None)

class ContainerBlueprint

def __init__(container_kind, *, display_name=None, contents=None, col_shares=None, row_shares=None, active_tab=None, visible=None, grid_columns=None)

class DataframeQuery

def __init__(*, timeline=None, filter_by_range=None, filter_is_not_null=None, apply_latest_at=False, select=None)

class MapBackground

def __init__(provider)

class MapZoom

def __init__(zoom)

class PanelBlueprint

def __init__(*, state=None)

class PlotLegend

def __init__(corner=None, *, visible=None)

class ScalarAxis

def __init__(*, range=None, zoom_lock=None)

class SpaceViewBlueprint

def __init__(class_identifier, *, display_name=None, space_origin=None, visible=None)

class SpaceViewContents

def __init__(query)

class TensorScalarMapping

def __init__(*, mag_filter=None, colormap=None, gamma=None)

class TensorSliceSelection

def __init__(*, width=None, height=None, indices=None, slider=None)

class TensorViewFit

def __init__(scaling=None)

class ViewportBlueprint

def __init__(*, root_container=None, maximized=None, auto_layout=None, auto_space_views=None, past_viewer_recommendations=None)

class VisibleTimeRanges

def __init__(ranges)

class VisualBounds2D

def __init__(*, x_range, y_range)

`rerun.blueprint.archetypes`

`class Background`

`def init(color_or_kind=None, *, color=None, kind=None)`

`class ContainerBlueprint`

`def init(container_kind, *, display_name=None, contents=None, col_shares=None, row_shares=None, active_tab=None, visible=None, grid_columns=None)`

`class DataframeQuery`

`def init(*, timeline=None, filter_by_range=None, filter_is_not_null=None, apply_latest_at=False, select=None)`

`class MapBackground`

`def init(provider)`

`class MapZoom`

`def init(zoom)`

`class PanelBlueprint`

`def init(*, state=None)`

`class PlotLegend`

`def init(corner=None, *, visible=None)`

`class ScalarAxis`

`def init(*, range=None, zoom_lock=None)`

`class SpaceViewBlueprint`

`def init(class_identifier, *, display_name=None, space_origin=None, visible=None)`

`class SpaceViewContents`

`def init(query)`

`class TensorScalarMapping`

`def init(*, mag_filter=None, colormap=None, gamma=None)`

`class TensorSliceSelection`

`def init(*, width=None, height=None, indices=None, slider=None)`

`class TensorViewFit`

`def init(scaling=None)`

`class ViewportBlueprint`

`def init(*, root_container=None, maximized=None, auto_layout=None, auto_space_views=None, past_viewer_recommendations=None)`

`class VisibleTimeRanges`

`def init(ranges)`

`class VisualBounds2D`

`def init(*, x_range, y_range)`