Browse docs
Panels and views
Bind a source's fields to a view: cameras in videoStack, joint traces in
lineChart, or labeled intervals in timeline. This is the
sources/panels API, separate from Dataset views.
Built-in views
| View | Field kinds | Result |
|---|---|---|
videoStack | video, image, explicitly selected file | Media tiles with shared time. |
frameStack | frames | Camera sequences loaded at the cursor time. |
lineChart | series | Numeric traces selected by feature or dimension. |
timeline | cues, supported annotation files | Labeled time intervals. |
fieldsCatalog | any | Field names, kinds and metadata. |
placeholder3d | pose3d, pointcloud | A description of the available 3D data. |
gridLayout groups panels; autoLayout chooses them from the catalog.
placeholder3d shows metadata only. Use Dataset views
or the 3D component for interactive scenes.
videoStack
Select cameras with fields. A wildcard is matched against the field catalog.
Overlays select annotation files in the same source. Supported formats are
handJoints, subtasks and raw; see their data shapes.
on limits an overlay to a matching camera. This folder example shows cameras
sharing a cursor:
Code FilesystemFolderSpec.tsx
frameStack
Uses a frame payload's frameAt(index) function to load images for the cursor
time. Select fields and configure the grid:
See the UMI and egocentric examples for source formats that provide frame sequences.
lineChart
Use series to style each trace and select dimensions. A complete feature selects
all its columns; [feature, dimension] selects one. Dimension patterns such as
[observation.state, "left_*"] select a group.
Code LineChartSpec.tsx
fields: [action, observation.state] is the shorter form when each feature should
use automatic styling. Series options are label, color, dash, width,
opacity and ghost. Widths are non-scaling CSS pixels: the chart defaults
to 2px, and a series width overrides the panel's lineWidth. Keep references
readable with dash and opacity. activeLineWidth has the same floor behavior as
the component API;
it changes emphasis styling but does not enable pointer identification itself.
| Panel option | Default | Meaning |
|---|---|---|
lineWidth | 2 | Default trace width in CSS pixels; overridden by series width. |
activeLineWidth | base × 1.65 | Active width, never thinner than the resolved base. Zero base widths stay hidden. |
height | 180 | Number of pixels or a CSS length in grid layout. |
yRange | automatic | Explicit numeric domain. |
title, caption, unitHint | omitted | Chart labels. |
showMidline | chart default | Controls the chart's central gridline. |
disabled | false | Displays the unavailable-signal state. |
maxPoints | 2000 | Sampling hint passed to the adapter. |
timeRange | omitted | { from, to } read window passed to the adapter. |
This wrapper forwards the options above. Other EpisodeLineChart props are not
automatically schema options; use the component directly when you need those
controls.
timeline
Bind cue fields with tracks. An annotation file can instead specify
format: subtasks to convert labeled intervals into blocks.
Code TimelineSpec.tsx
fieldsCatalog
Use the catalog to inspect field references, kinds and dimension names before writing bindings.
Code FieldsCatalogSpec.tsx
Writing your own panel
Implement a view with the catalog, bound reader, shared cursor and panel config:
This view lists numeric field names without reading their values:
Select it with { view: "signalList", source: "ep" }. For data, call
read(ref, { timeRange, maxPoints }) and handle loading/errors. For shared
interaction, use cursor.time, cursor.setHover(time),
cursor.setHover(null) and cursor.seek(time).
Views may also be supplied through extensions.views; see
registration behavior.
Auto-layout
Omit panels, or add { view: autoLayout, source: ep }, to generate the following
panels from a source's catalog:
- Video and image fields in one
videoStack. - Frame sequences in one
frameStack. - Pose and point-cloud fields in a
placeholder3dpanel. - Cue fields in one
timeline. - One
lineChartper numeric field, grouped in a grid when there is more than one.
Opaque file fields are omitted from this default. Select them explicitly when
they belong in a panel.