Skip to content

Experimental

rerun.experimental

Experimental features for Rerun.

These features are not yet stable and may change in future releases without going through the normal deprecation cycle.

def add_space_view(*, origin, space_view_class, name, entity_paths, blueprint=None)

Add a new space view to the blueprint.

PARAMETER DESCRIPTION
origin

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

TYPE: str

space_view_class

The class of the space view to add.

TYPE: str

name

The name of the space view to show in the UI. Will default to the origin if not provided.

TYPE: Optional[str]

entity_paths

The entities to be shown in the space view. If not provided, this will default to [origin]

TYPE: Optional[List[str]]

blueprint

The blueprint to add the space view to. If None, the default global blueprint is used.

TYPE: Optional[RecordingStream] DEFAULT: None

def new_blueprint(application_id, *, blueprint_id=None, make_default=False, make_thread_default=False, spawn=False, add_to_app_default_blueprint=False, default_enabled=True)

Creates a new blueprint with a user-chosen application id (name) to configure the appearance of Rerun.

If you only need a single global blueprint, rerun.init might be simpler.

PARAMETER DESCRIPTION
application_id

Your Rerun recordings will be categorized by this application id, so try to pick a unique one for each application that uses the Rerun SDK.

For example, if you have one application doing object detection and another doing camera calibration, you could have rerun.init("object_detector") and rerun.init("calibrator").

TYPE: str

blueprint_id

Set the blueprint ID that this process is logging to, as a UUIDv4.

The default blueprint_id is based on multiprocessing.current_process().authkey which means that all processes spawned with multiprocessing will have the same default blueprint_id.

If you are not using multiprocessing and still want several different Python processes to log to the same Rerun instance (and be part of the same blueprint), you will need to manually assign them all the same blueprint_id. Any random UUIDv4 will work, or copy the blueprint_id for the parent process.

TYPE: Optional[str] DEFAULT: None

make_default

If true (not the default), the newly initialized blueprint will replace the current active one (if any) in the global scope.

TYPE: bool DEFAULT: False

make_thread_default

If true (not the default), the newly initialized blueprint will replace the current active one (if any) in the thread-local scope.

TYPE: bool DEFAULT: False

spawn

Spawn a Rerun Viewer and stream logging data to it. Short for calling spawn separately. If you don't call this, log events will be buffered indefinitely until you call either connect, show, or save

TYPE: bool DEFAULT: False

add_to_app_default_blueprint

Should the blueprint append to the existing app-default blueprint instead instead of creating a new one.

TYPE: bool DEFAULT: False

default_enabled

Should Rerun logging be on by default? Can overridden with the RERUN env-var, e.g. RERUN=on or RERUN=off.

TYPE: bool DEFAULT: True

RETURNS DESCRIPTION
RecordingStream

A handle to the rerun.RecordingStream. Use it to log data to Rerun.

def set_auto_space_views(enabled, blueprint=None)

Change whether or not the blueprint automatically adds space views for all entities.

PARAMETER DESCRIPTION
enabled

Whether or not to automatically add space views for all entities.

TYPE: Optional[bool]

blueprint

The blueprint to add the space view to. If None, the default global blueprint is used.

TYPE: Optional[RecordingStream] DEFAULT: None

def set_panels(*, all_expanded=None, blueprint_view_expanded=None, selection_view_expanded=None, timeline_view_expanded=None, blueprint=None)

Change the visibility of the view panels.

PARAMETER DESCRIPTION
all_expanded

Expand or collapse all panels.

TYPE: Optional[bool] DEFAULT: None

blueprint_view_expanded

Expand or collapse the blueprint view panel.

TYPE: Optional[bool] DEFAULT: None

selection_view_expanded

Expand or collapse the selection view panel.

TYPE: Optional[bool] DEFAULT: None

timeline_view_expanded

Expand or collapse the timeline view panel.

TYPE: Optional[bool] DEFAULT: None

blueprint

The blueprint to add the space view to. If None, the default global blueprint is used.

TYPE: Optional[RecordingStream] DEFAULT: None