// Docs

Episode data

How Refiner represents robotics episodes, frames, videos, metadata, tasks, and stats

Refiner treats robotics data as episode data. An episode row can carry:

  • episode-level values, such as episode_id or task
  • frame-level arrays, such as timestamps, actions, states, and observations
  • lazy video sources
  • metadata, tasks, and statistics used by LeRobot-compatible datasets

Pages

PageUse it for
Episode RowsThe row API and semantic episode fields.
Frames and VideosFrame tables, video sources, clipping, and decoding.
Metadata, Tasks, and StatsLeRobot metadata and feature statistics.
Converting to Robot RowsAdapting HDF5, Zarr, and custom rows into episode rows.

Read this section before writing episode-level transforms.