Datatypes

rerun.blueprint.datatypes

ComponentColumnSelectorArrayLike = ComponentColumnSelector | Sequence[ComponentColumnSelectorLike] module-attribute

A type alias for any ComponentColumnSelector-like array object.

ComponentColumnSelectorLike = ComponentColumnSelector | str module-attribute

A type alias for any ComponentColumnSelector-like object.

ComponentSourceKindArrayLike = ComponentSourceKind | Literal['Default', 'Override', 'SourceComponent', 'default', 'override', 'sourcecomponent'] | int | Sequence[ComponentSourceKindLike] module-attribute

A type alias for any ComponentSourceKind-like array object.

ComponentSourceKindLike = ComponentSourceKind | Literal['Default', 'Override', 'SourceComponent', 'default', 'override', 'sourcecomponent'] | int module-attribute

A type alias for any ComponentSourceKind-like object.

FilterByRangeArrayLike = FilterByRange | Sequence[FilterByRangeLike] module-attribute

A type alias for any FilterByRange-like array object.

FilterByRangeLike = FilterByRange module-attribute

A type alias for any FilterByRange-like object.

FilterIsNotNullArrayLike = FilterIsNotNull | Sequence[FilterIsNotNullLike] module-attribute

A type alias for any FilterIsNotNull-like array object.

FilterIsNotNullLike = FilterIsNotNull | blueprint_datatypes.ComponentColumnSelectorLike module-attribute

A type alias for any FilterIsNotNull-like object.

SelectedColumnsArrayLike = SelectedColumns | Sequence[SelectedColumnsLike] module-attribute

A type alias for any SelectedColumns-like array object.

SelectedColumnsLike = SelectedColumns | Sequence[blueprint_datatypes.ComponentColumnSelectorLike | datatypes.Utf8Like] module-attribute

A type alias for any SelectedColumns-like object.

TensorDimensionIndexSliderArrayLike = TensorDimensionIndexSlider | Sequence[TensorDimensionIndexSliderLike] | npt.ArrayLike module-attribute

A type alias for any TensorDimensionIndexSlider-like array object.

TensorDimensionIndexSliderLike = TensorDimensionIndexSlider | int module-attribute

A type alias for any TensorDimensionIndexSlider-like object.

TextLogColumnArrayLike = TextLogColumn | Sequence[TextLogColumnLike] module-attribute

A type alias for any TextLogColumn-like array object.

TextLogColumnKindArrayLike = TextLogColumnKind | Literal['Body', 'EntityPath', 'LogLevel', 'body', 'entitypath', 'loglevel'] | int | Sequence[TextLogColumnKindLike] module-attribute

A type alias for any TextLogColumnKind-like array object.

TextLogColumnKindLike = TextLogColumnKind | Literal['Body', 'EntityPath', 'LogLevel', 'body', 'entitypath', 'loglevel'] | int module-attribute

A type alias for any TextLogColumnKind-like object.

TextLogColumnLike = TextLogColumn | blueprint_datatypes.TextLogColumnKindLike module-attribute

A type alias for any TextLogColumn-like object.

TimelineColumnArrayLike = TimelineColumn | Sequence[TimelineColumnLike] module-attribute

A type alias for any TimelineColumn-like array object.

TimelineColumnLike = TimelineColumn | datatypes.Utf8Like module-attribute

A type alias for any TimelineColumn-like object.

VisualizerComponentMappingArrayLike = VisualizerComponentMapping | Sequence[VisualizerComponentMappingLike] module-attribute

A type alias for any VisualizerComponentMapping-like array object.

VisualizerComponentMappingLike = VisualizerComponentMapping module-attribute

A type alias for any VisualizerComponentMapping-like object.

class ComponentColumnSelector

Bases: ComponentColumnSelectorExt

Datatype: Describe a component column to be selected in the dataframe view.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(spec=None, *, entity_path=None, component=None)

Create a new instance of the ComponentColumnSelector datatype.

PARAMETER	DESCRIPTION
spec	A string in the format "/entity/path:Component". If used, entity_path and component must be None. TYPE: str | None DEFAULT: None
entity_path	The column's entity path. If used, spec must be None and component must be provided. TYPE: EntityPathLike | None DEFAULT: None
component	The column's component type. If used, spec must be None and entity_path must be provided. TYPE: Utf8Like | None DEFAULT: None

class ComponentColumnSelectorBatch

Bases: BaseBatch[ComponentColumnSelectorArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class ComponentSourceKind

Bases: Enum

Datatype: What kind of source to use for a visualizer component mapping.

Default = 3 class-attribute instance-attribute

Default as specified on the view's blueprint.

If the view doesn't specify a default for the target component name, a heuristically determined value will be used instead.

Override = 2 class-attribute instance-attribute

Use a timeless override value that is defined in the blueprint.

The override value is stored on the same entity as the visualizer instruction and uses the target as its component name.

If there is no override value with the target component name, a heuristically determined value will be used instead.

SourceComponent = 1 class-attribute instance-attribute

Use an explicit selection defined by source_component.

May or may not make use of a selector string.

If the source component is not found on the entity, a heuristically determined value will be used instead.

def __str__()

Returns the variant name.

def auto(val) classmethod

Best-effort converter, including a case-insensitive string matcher.

class ComponentSourceKindBatch

Bases: BaseBatch[ComponentSourceKindArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class FilterByRange

Bases: FilterByRangeExt

Datatype: Configuration for the filter-by-range feature of the dataframe view.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(start, end)

Create a new instance of the FilterByRange datatype.

PARAMETER	DESCRIPTION
start	Beginning of the time range. TYPE: TimeIntLike
end	End of the time range (inclusive). TYPE: TimeIntLike

class FilterByRangeBatch

Bases: BaseBatch[FilterByRangeArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class FilterIsNotNull

Bases: FilterIsNotNullExt

Datatype: Configuration for the filter is not null feature of the dataframe view.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(active, column)

Create a new instance of the FilterIsNotNull datatype.

PARAMETER	DESCRIPTION
active	Whether the filter by event feature is active. TYPE: BoolLike
column	The column used when the filter by event feature is used. TYPE: ComponentColumnSelectorLike

class FilterIsNotNullBatch

Bases: BaseBatch[FilterIsNotNullArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class SelectedColumns

Bases: SelectedColumnsExt

Datatype: List of selected columns in a dataframe.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(columns)

Create a new instance of the SelectedColumns datatype.

Example:

SelectedColumns(["timeline", "/entity/path:Component"])

PARAMETER	DESCRIPTION
columns	The columns to include. The column must be either of the timeline, or component kind. Timeline columns can be specified using a str without any :, or an Utf8. Component columns can be specified using either a str in the form of "/entity/path:Component", or a ComponentColumnSelector. TYPE: Sequence[ComponentColumnSelectorLike | Utf8Like]

class SelectedColumnsBatch

Bases: BaseBatch[SelectedColumnsArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class TensorDimensionIndexSlider

Bases: TensorDimensionIndexSliderExt

Datatype: Defines a slider for the index of some dimension.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(dimension)

Create a new instance of the TensorDimensionIndexSlider datatype.

PARAMETER	DESCRIPTION
dimension	The dimension number. TYPE: TensorDimensionIndexSliderLike

class TensorDimensionIndexSliderBatch

Bases: BaseBatch[TensorDimensionIndexSliderArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class TextLogColumn

Bases: TextLogColumnExt

Datatype: A text log column.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(kind, *, visible=True)

Create a new instance of the TextLogColumn datatype.

PARAMETER	DESCRIPTION
kind	What kind of column is this? TYPE: TextLogColumnKindLike
visible	Is this column visible? TYPE: BoolLike DEFAULT: True

class TextLogColumnBatch

Bases: BaseBatch[TextLogColumnArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class TextLogColumnKind

Bases: Enum

Datatype: A text log column kind.

Body = 3 class-attribute instance-attribute

The text message the log has.

EntityPath = 1 class-attribute instance-attribute

Which entity path this was logged to.

LogLevel = 2 class-attribute instance-attribute

The log level, i.e INFO, WARN, ERROR.

def __str__()

Returns the variant name.

def auto(val) classmethod

Best-effort converter, including a case-insensitive string matcher.

class TextLogColumnKindBatch

Bases: BaseBatch[TextLogColumnKindArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class TimelineColumn

Bases: TimelineColumnExt

Datatype: A timeline column in a table.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(timeline, *, visible=True)

Create a new instance of the TextLogColumn datatype.

PARAMETER	DESCRIPTION
timeline	What timeline is this? TYPE: Utf8Like
visible	Is this column visible? TYPE: BoolLike DEFAULT: True

class TimelineColumnBatch

Bases: BaseBatch[TimelineColumnArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.

class VisualizerComponentMapping

Bases: VisualizerComponentMappingExt

Datatype: Associate components of an entity to components of a visualizer.

⚠ TODO(#12600): The API for component mappings is still evolving, so this may change in the future.

⚠️ This type is unstable and may change significantly in a way that the data won't be backwards compatible.

def __init__(target, source_kind, *, source_component=None, selector=None)

Create a new instance of the VisualizerComponentMapping datatype.

PARAMETER	DESCRIPTION
target	Target component name which is being mapped to. This represents a "slot" on the visualizer. TYPE: Utf8Like
source_kind	What kind of source to pick. TYPE: ComponentSourceKindLike
source_component	Component selector for mapping. Defaults to target if not specified. TYPE: str | None DEFAULT: None
selector	Optional selector string using jq-like syntax to pick a specific field on source_component. Example: ".x" picks a field called "x" from the source_component if present. Defaults to empty string if not specified. TYPE: str | None DEFAULT: None

class VisualizerComponentMappingBatch

Bases: BaseBatch[VisualizerComponentMappingArrayLike]

def __init__(data, strict=None)

Construct a new batch.

This method must flexibly accept native data (which comply with type T). Subclasses must provide a type parameter specifying the type of the native data (this is automatically handled by the code generator).

A value of None indicates that the component should be cleared and results in the creation of an empty array.

The actual creation of the Arrow array is delegated to the _native_to_pa_array() method, which is not implemented by default.

PARAMETER	DESCRIPTION
data	The data to convert into an Arrow array. TYPE: T | None
strict	Whether to raise an exception if the data cannot be converted into an Arrow array. If None, the value defaults to the value of the rerun.strict global setting. TYPE: bool | None DEFAULT: None

RETURNS	DESCRIPTION
The Arrow array encapsulating the data.

def as_arrow_array()

The component as an arrow batch.

Part of the rerun.ComponentBatchLike logging interface.