Visualization Components
Look up the components that SPQL visualization functions build, with their properties and children.
A visualization component describes one view, chart, spatial primitive, or layout that Spiral Studio renders. The constructors on the visualization page build components from column values, and layout components nest other components as children. Each component has a Type ID in the spql.viz namespace and a set of properties that control what it shows and how it looks.
Components are presentation values, not data types: store the data in a data type column and build the component in the query that displays it.
Shared Properties
Most components accept the same identity, appearance, and layout properties. They are listed once here; each component below names the ones it accepts.
| Name | Type | Default | Description |
|---|---|---|---|
id | utf8 | Stable component identity. | |
label | utf8 | Display name of this component. | |
visible | bool | true | Show this component. |
background | utf8 | Panel background color. | |
height | f64 | Preferred panel height. From 16 to 1600. Unit: px. | |
grow | f64 | 1 | Share of remaining Column height; zero uses natural content height. From 0 to 100. |
min_height | f64 | 0 | Minimum panel height before its containing Column scrolls. From 0 to 1600. Unit: px. |
arrows | value | Arrows. | |
boxes | value | Boxes. | |
lines | value | Lines. | |
strips | value | Strips. |
Components
| Type ID | Stability | Summary |
|---|---|---|
spql.viz.Arrows2D | experimental | Two-dimensional origin and direction vectors. |
spql.viz.Arrows3D | experimental | Three-dimensional origin and direction vectors. |
spql.viz.AudioView | experimental | Audio visualization component. |
spql.viz.BarChartView | experimental | Categorical values compared across named series. |
spql.viz.BarSeries | experimental | One named series of categorical numeric values. |
spql.viz.Binding | experimental | Binding for interactive visualization. |
spql.viz.Boxes2D | experimental | Axis-aligned two-dimensional boxes. |
spql.viz.Boxes3D | experimental | Axis-aligned three-dimensional boxes. |
spql.viz.Column | experimental | Vertical layout component. |
spql.viz.Disclosure | experimental | Collapsible detail layout component. |
spql.viz.DistributionSeries | experimental | One named numeric distribution series. |
spql.viz.DistributionView | experimental | Numeric distributions compared across named series. |
spql.viz.Grid | experimental | Grid layout component. |
spql.viz.Heatmap2D | experimental | Aligned scalar heatmaps compared across named panels. |
spql.viz.HeatmapPanel | experimental | One named dense scalar heatmap panel. |
spql.viz.Histogram | experimental | Distribution histogram. |
spql.viz.ImageView | experimental | Image visualization component backed by a blob source. |
spql.viz.Inspector | experimental | Structured value inspector fallback. |
spql.viz.JsonView | experimental | JSON text visualization component. |
spql.viz.LineStrips2D | experimental | Connected two-dimensional line-strip data. |
spql.viz.LineStrips3D | experimental | Connected three-dimensional line-strip data. |
spql.viz.MarkdownView | experimental | Markdown text visualization component. |
spql.viz.Model3D | experimental | 3D model instance with an asset source and optional prepared poses. |
spql.viz.ParameterBinding | experimental | ParameterBinding for interactive visualization. |
spql.viz.PlotView | experimental | Plot visualization component. |
spql.viz.Points2D | experimental | Two-dimensional point data. |
spql.viz.Points3D | experimental | Three-dimensional point data. |
spql.viz.Row | experimental | Horizontal layout component. |
spql.viz.Scene2DView | experimental | Two-dimensional scene of typed media and geometry layers. |
spql.viz.Scene3DView | experimental | 3D scene visualization component. |
spql.viz.Slot | experimental | Slot for interactive visualization. |
spql.viz.Stack | experimental | Compact stack of visualization children. |
spql.viz.State | experimental | State for interactive visualization. |
spql.viz.Summary | experimental | Labeled summary values prepared by a query-backed visualization. |
spql.viz.Surface | experimental | Surface for interactive visualization. |
spql.viz.TableView | experimental | Table visualization component. |
spql.viz.Tabs | experimental | Tabbed layout component. |
spql.viz.TextLog | experimental | Structured text log entries. |
spql.viz.TextView | experimental | Plain text visualization component. |
spql.viz.TimeCursor | experimental | TimeCursor for interactive visualization. |
spql.viz.TimeDomain | experimental | TimeDomain for interactive visualization. |
spql.viz.TimeRange | experimental | TimeRange for interactive visualization. |
spql.viz.TimeSeriesView | experimental | Values plotted against a time-like axis. |
spql.viz.Timeline | experimental | Timeline visualization component. |
spql.viz.TopListSeries | experimental | One named series of categorical numeric values in a top list. |
spql.viz.TopListView | experimental | Ranked categorical values displayed as a compact ordered list. |
spql.viz.VideoView | experimental | Video visualization component. |
spql.viz.Arrows2D
Two-dimensional origin and direction vectors.
- Stability:
experimental - Constructor:
spql.viz.arrows_2d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. |
spql.viz.Arrows3D
Three-dimensional origin and direction vectors.
- Stability:
experimental - Constructor:
spql.viz.arrows_3d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. | |
points | value | Points. | |
positions | value | Positions. |
spql.viz.AudioView
Audio visualization component.
- Stability:
experimental - Constructor:
spql.viz.audio_view - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
src | value | Encoded media source. | |
source | value | Typed media source. | |
mcap | value | Exact MCAP source reference. | |
time | utf8 | Shared cursor state name. | |
time_origin_ns | utf8 | Exact nanosecond origin of the clip. | |
fit | utf8 | contain | Image fitting behavior. One of contain, cover. |
muted | bool | true | Mute audio. |
codec | value | Codec. | |
frame_rate | value | Frame rate. | |
framing | value | Framing. | |
images | value | Images. | |
packets | value | Packets. | |
poster | value | Poster. | |
timestamps_ns | value | Timestamps ns. | |
title | value | Title. |
spql.viz.BarChartView
Categorical values compared across named series.
- Stability:
experimental - Constructor:
spql.viz.bar_chart - Child slots:
series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
series | value | Named bar series. | |
display | utf8 | grouped | Lay series out side by side or stack them. One of grouped, stacked. |
value_mode | utf8 | absolute | Show absolute values or normalize each series to percentages. One of absolute, relative. |
bar_width | f64 | 10 | Maximum bar width, independent of category spacing. From 1 to 24. Unit: px. |
sort | utf8 | value_desc | Category ordering. One of value_desc, value_asc, category_asc, category_desc. |
spql.viz.BarSeries
One named series of categorical numeric values.
- Stability:
experimental - Constructor:
spql.viz.bar_series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color | utf8 | Uniform mark color. | |
category | value | Category labels. | |
value | value | Numeric values aligned with the categories. | |
total | value | Sum across every category. |
spql.viz.Binding
Binding for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.bind
Properties
| Name | Type | Default | Description |
|---|---|---|---|
state | utf8 | Identity of the state read by this property. Required. |
spql.viz.Boxes2D
Axis-aligned two-dimensional boxes.
- Stability:
experimental - Constructor:
spql.viz.boxes_2d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. |
spql.viz.Boxes3D
Axis-aligned three-dimensional boxes.
- Stability:
experimental - Constructor:
spql.viz.boxes_3d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. | |
points | value | Points. | |
positions | value | Positions. |
spql.viz.Column
Vertical layout component.
- Stability:
experimental - Constructor:
spql.viz.column - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
spql.viz.Disclosure
Collapsible detail layout component.
- Stability:
experimental - Constructor:
spql.viz.disclosure - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
open | bool | true | Expand this section. |
spql.viz.DistributionSeries
One named numeric distribution series.
- Stability:
experimental - Constructor:
spql.viz.distribution_series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color | utf8 | Uniform mark color. | |
x | value | Bin centers or reference quantiles. | |
value | value | Probability values or candidate quantiles. |
spql.viz.DistributionView
Numeric distributions compared across named series.
- Stability:
experimental - Constructor:
spql.viz.distribution - Child slots:
series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
series | value | Named distribution series. | |
mode | utf8 | Distribution coordinates represented by the series. One of density, cumulative, qq. |
spql.viz.Grid
Grid layout component.
- Stability:
experimental - Constructor:
spql.viz.grid - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
weights | value | [1,1] | Relative pane sizes. |
columns | f64 | 2 | Number of grid columns. From 1 to 8. |
spql.viz.Heatmap2D
Aligned scalar heatmaps compared across named panels.
- Stability:
experimental - Constructor:
spql.viz.heatmap_2d - Child slots:
panels - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
comparison_view | utf8 | side_by_side | Population comparison display. One of side_by_side, difference. |
panels | value | Named heatmap panels on shared axes and a shared color domain. | |
value_label | utf8 | Meaning of each cell value. |
spql.viz.HeatmapPanel
One named dense scalar heatmap panel.
- Stability:
experimental - Constructor:
spql.viz.heatmap_panel - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color | utf8 | Uniform mark color. | |
x | value | Horizontal coordinates aligned with the cell values. | |
y | value | Vertical coordinates aligned with the cell values. | |
value | value | Scalar cell values. |
spql.viz.Histogram
Distribution histogram.
- Stability:
experimental - Constructor:
spql.viz.histogram - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
color | utf8 | Uniform mark color. | |
data | value | Data. | |
matrix | value | Matrix. | |
values | value | Values. |
spql.viz.ImageView
Image visualization component backed by a blob source.
- Stability:
experimental - Constructor:
spql.viz.image_view - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
alt | value | Alt. | |
source | value | Source. | |
src | value | Src. |
spql.viz.Inspector
Structured value inspector fallback.
- Stability:
experimental - Constructor:
spql.viz.inspector - Shared properties:
id,label,visible,background,height,grow,min_height
spql.viz.JsonView
JSON text visualization component.
- Stability:
experimental - Constructor:
spql.viz.json_view - Shared properties:
id,label,visible,background,height,grow,min_height
spql.viz.LineStrips2D
Connected two-dimensional line-strip data.
- Stability:
experimental - Constructor:
spql.viz.line_strips_2d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. |
spql.viz.LineStrips3D
Connected three-dimensional line-strip data.
- Stability:
experimental - Constructor:
spql.viz.line_strips_3d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. | |
points | value | Points. | |
positions | value | Positions. |
spql.viz.MarkdownView
Markdown text visualization component.
- Stability:
experimental - Constructor:
spql.viz.markdown_view - Shared properties:
id,label,visible,background,height,grow,min_height
spql.viz.Model3D
3D model instance with an asset source and optional prepared poses.
- Stability:
experimental - Constructor:
spql.viz.model_3d - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
source | value | Model Blob: a ZIP bundle or a standalone STL/OBJ asset. | |
entry_point | utf8 | Asset path inside a ZIP bundle; omitted for standalone STL/OBJ assets. | |
joints | value | Prepared joint names and values, or an ordered pose column. | |
nodes | value | Named parent-relative node transforms, or an ordered transform column. | |
time_ns | value | Exact timestamps for the prepared pose column. | |
xyz | value | Instance translation in scene coordinates. | |
rpy | value | Instance roll, pitch, and yaw in radians. |
spql.viz.ParameterBinding
ParameterBinding for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.parameter
Properties
| Name | Type | Default | Description |
|---|---|---|---|
ordinal | f64 | One-based parameter ordinal in the host SQL statement. Required. | |
state | utf8 | State identity supplying the parameter. Required. | |
field | utf8 | Optional field within the state value. |
spql.viz.PlotView
Plot visualization component.
- Stability:
experimental - Constructor:
spql.viz.plot_view - Shared properties:
id,label,visible,background,height,grow
Properties
| Name | Type | Default | Description |
|---|---|---|---|
min_height | f64 | 120 | Minimum usable chart height before its containing Column scrolls. From 0 to 1600. Unit: px. |
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
line_width | f64 | 1 | Width of plotted lines. From 0.5 to 10. Unit: px. |
color | utf8 | Uniform series color. | |
series | value | Named time series. | |
samples | value | Exact timestamped samples. | |
time | utf8 | Shared cursor state name. | |
viewport | utf8 | Shared viewport state name. | |
comparison | utf8 | Comparison cursor state name. | |
selection | utf8 | Shared selection state name. | |
time_origin_ns | utf8 | Exact nanosecond origin for relative plot coordinates. | |
labels | value | Labels. | |
playback_cursor | value | Playback cursor. |
spql.viz.Points2D
Two-dimensional point data.
- Stability:
experimental - Constructor:
spql.viz.points_2d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. | |
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
color | utf8 | Uniform mark color. |
spql.viz.Points3D
Three-dimensional point data.
- Stability:
experimental - Constructor:
spql.viz.points_3d - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | value | Ordered exact timestamps; equal timestamps belong to one geometry frame. | |
end_ns | value | Optional exclusive frame end; the next frame otherwise replaces it. | |
points | value | Points. | |
positions | value | Positions. |
spql.viz.Row
Horizontal layout component.
- Stability:
experimental - Constructor:
spql.viz.row - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
weights | value | [1,1] | Relative pane sizes. |
resizable | bool | true | Allow resizing panes. |
spql.viz.Scene2DView
Two-dimensional scene of typed media and geometry layers.
- Stability:
experimental - Constructor:
spql.viz.scene_2d - Child slots:
children - Shared properties:
id,label,visible,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
background | utf8 | Background color of the scene. | |
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
fit | utf8 | contain | Fit media inside the viewport or cover it. One of contain, cover. |
spql.viz.Scene3DView
3D scene visualization component.
- Stability:
experimental - Constructor:
spql.viz.scene_3d - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height,arrows,boxes,lines,strips
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
up_axis | utf8 | Scene up axis: y or z. | |
grid | bool | Show the ground grid. | |
axes | bool | Show coordinate axes. | |
points | value | Points. | |
positions | value | Positions. |
spql.viz.Slot
Slot for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.slot - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
message | utf8 | Empty pane | Placeholder message. |
spql.viz.Stack
Compact stack of visualization children.
- Stability:
experimental - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
spql.viz.State
State for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.state
Properties
| Name | Type | Default | Description |
|---|---|---|---|
id | utf8 | Unique state identity. Required. | |
initial | value | Initial state value; its dtype defines the state shape. Required. | |
persistence | utf8 | Use user-view to retain this state in saved settings. |
spql.viz.Summary
Labeled summary values prepared by a query-backed visualization.
- Stability:
experimental - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color | utf8 | Uniform mark color. | |
entries | value | Summary labels, formatted values, and optional details. |
spql.viz.Surface
Surface for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.surface - Child slots:
content - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
content | value | Nested visualization content. Required. | |
state | value | Named state declarations. | |
instance_key | value | Stable result instance key. | |
parameter_bindings | value | State to SQL parameter mappings. |
spql.viz.TableView
Table visualization component.
- Stability:
experimental - Constructor:
spql.viz.table_view - Shared properties:
id,label,visible,background,height,grow,min_height
spql.viz.Tabs
Tabbed layout component.
- Stability:
experimental - Constructor:
spql.viz.tabs - Child slots:
children - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
gap | f64 | 4 | Space between panels. From 0 to 64. Unit: px. |
active | f64 | 0 | Selected tab index, starting at zero. At least 0. |
spql.viz.TextLog
Structured text log entries.
- Stability:
experimental - Constructor:
spql.viz.text_log - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
entries | value | Entries. | |
rows | value | Rows. |
spql.viz.TextView
Plain text visualization component.
- Stability:
experimental - Constructor:
spql.viz.text_view - Shared properties:
id,label,visible,background,height,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
grow | f64 | 0 | Share of remaining Column height; zero uses natural text height. From 0 to 100. |
spql.viz.TimeCursor
TimeCursor for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.time_cursor
Properties
| Name | Type | Default | Description |
|---|---|---|---|
time_ns | utf8 | Exact cursor position in decimal nanoseconds. Required. |
spql.viz.TimeDomain
TimeDomain for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.time_domain
Properties
| Name | Type | Default | Description |
|---|---|---|---|
start_ns | utf8 | Inclusive domain start as exact decimal nanoseconds. Required. | |
end_ns | utf8 | Exclusive domain end as exact decimal nanoseconds. Required. |
spql.viz.TimeRange
TimeRange for interactive visualization.
- Stability:
experimental - Constructor:
spql.viz.time_range
Properties
| Name | Type | Default | Description |
|---|---|---|---|
start_ns | utf8 | Inclusive range start as exact decimal nanoseconds. Required. | |
end_ns | utf8 | Exclusive range end as exact decimal nanoseconds. Required. |
spql.viz.TimeSeriesView
Values plotted against a time-like axis.
- Stability:
experimental - Constructor:
spql.viz.time_series - Shared properties:
id,label,visible,background,height,grow
Properties
| Name | Type | Default | Description |
|---|---|---|---|
min_height | f64 | 120 | Minimum usable chart height before its containing Column scrolls. From 0 to 1600. Unit: px. |
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
line_width | f64 | 1 | Width of plotted lines. From 0.5 to 10. Unit: px. |
color | utf8 | Uniform series color. | |
series | value | Named time series. | |
samples | value | Exact timestamped samples. | |
time | utf8 | Shared cursor state name. | |
viewport | utf8 | Shared viewport state name. | |
comparison | utf8 | Comparison cursor state name. | |
selection | utf8 | Shared selection state name. | |
time_origin_ns | utf8 | Exact nanosecond origin for relative plot coordinates. | |
labels | value | Labels. | |
playback_cursor | value | Playback cursor. |
spql.viz.Timeline
Timeline visualization component.
- Stability:
experimental - Constructor:
spql.viz.timeline - Shared properties:
id,label,visible,background,height,grow
Properties
| Name | Type | Default | Description |
|---|---|---|---|
min_height | f64 | 120 | Minimum usable chart height before its containing Column scrolls. From 0 to 1600. Unit: px. |
x_label | utf8 | Horizontal axis label. | |
y_label | utf8 | Vertical axis label. | |
x_min | f64 | Fixed lower horizontal bound. | |
x_max | f64 | Fixed upper horizontal bound. | |
y_min | f64 | Fixed lower vertical bound. | |
y_max | f64 | Fixed upper vertical bound. | |
line_width | f64 | 1 | Width of plotted lines. From 0.5 to 10. Unit: px. |
color | utf8 | Uniform series color. | |
series | value | Named time series. | |
samples | value | Exact timestamped samples. | |
time | utf8 | Shared cursor state name. | |
viewport | utf8 | Shared viewport state name. | |
comparison | utf8 | Comparison cursor state name. | |
selection | utf8 | Shared selection state name. | |
time_origin_ns | utf8 | Exact nanosecond origin for relative plot coordinates. | |
start_ns | utf8 | Domain start in nanoseconds. | |
end_ns | utf8 | Domain end in nanoseconds. | |
lanes | value | Timeline event and interval lanes. | |
labels | value | Labels. | |
playback_cursor | value | Playback cursor. |
spql.viz.TopListSeries
One named series of categorical numeric values in a top list.
- Stability:
experimental - Constructor:
spql.viz.top_list_series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color | utf8 | Uniform mark color. | |
category | value | Category labels. | |
value | value | Numeric values aligned with the categories. | |
total | value | Sum across every category. |
spql.viz.TopListView
Ranked categorical values displayed as a compact ordered list.
- Stability:
experimental - Constructor:
spql.viz.top_list - Child slots:
series - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
series | value | Named top-list series. | |
legend | bool | true | Show series names and colors. |
value_mode | utf8 | absolute | Show absolute values or percentages of the full series total. One of absolute, relative. |
sort | utf8 | value_desc | Row ordering. Difference ranks by the largest gap between visible series in displayed units. One of value_desc, value_asc, category_asc, category_desc, difference_desc. |
spql.viz.VideoView
Video visualization component.
- Stability:
experimental - Constructor:
spql.viz.video_view - Shared properties:
id,label,visible,background,height,grow,min_height
Properties
| Name | Type | Default | Description |
|---|---|---|---|
show_controls | bool | false | Show local transport controls below the image. |
scrub_overlay | bool | false | Overlay the shared cursor and allow scrubbing in the video viewport. |
src | value | Encoded media source. | |
source | value | Typed media source. | |
mcap | value | Exact MCAP source reference. | |
time | utf8 | Shared cursor state name. | |
time_origin_ns | utf8 | Exact nanosecond origin of the clip. | |
fit | utf8 | contain | Image fitting behavior. One of contain, cover. |
muted | bool | true | Mute audio. |
codec | value | Codec. | |
frame_rate | value | Frame rate. | |
framing | value | Framing. | |
images | value | Images. | |
packets | value | Packets. | |
poster | value | Poster. | |
timestamps_ns | value | Timestamps ns. | |
title | value | Title. |
Found a problem? Edit this page or report an issue.