xarm7_pick_orange_ball_large

xArm7 Pick Orange Ball Large (TsFile)

Apache TsFile version of zwonzis/xarm7-pick-orange-ball-large.

Overview

A UFactory xArm7 dataset for the task "pick up the orange ball and put it in the cyan bowl". Each frame records the 8-D arm state and the 8-D commanded action.

• Scale: 122 episodes, 84,520 frames, 1 task, sampled at 30 fps; one train split in data/xarm7_pick_orange_ball_large.tsfile.

Task (task_index 0): "pick up the orange ball and put it in the cyan bowl".

Schema (TsFile structure)

• Time (INT64, milliseconds) - per-episode sample time, round(timestamp * 1000) in milliseconds (the source timestamp column equals Time / 1000 seconds and is therefore not stored separately).
• episode_index, task_index (TAG) - device dimensions identifying one demonstration episode and one task; query a single episode with WHERE episode_index=0.
• observation_state_0..7, action_0..7 (FIELD) - FLOAT 8-D xArm7 observation state and 8-D action.
• frame_index, sample_index (INT64, FIELD) - source frame counter and source row counter (index renamed to sample_index).

The dataset is stored as one wide TsFile table; within the train split all episodes share that single file with episode_index and task_index as TAG columns. State/action vectors are flattened to one FLOAT field per element (. -> _, element index appended). Camera video files are not included in this repository; the original dataset's videos are at videos/. meta/ is mirrored from the source. No data rows or non-video columns are dropped, apart from the redundant source timestamp column (replaced by Time). Two camera image/video features (observation.images.wrist, observation.images.side) are omitted as non-time-series.

Usage

Install the Apache TsFile Python SDK (pip install tsfile) and read a converted file:

from pathlib import Path
from tsfile import TsFileReader

path = Path("data/xarm7_pick_orange_ball_large.tsfile")
with TsFileReader(str(path)) as reader:
    schemas = reader.get_all_table_schemas()
    print("tables:", list(schemas))
    table_name = next(iter(schemas))
    table = schemas[table_name]
    columns = [column.get_column_name() for column in table.get_columns()]
    print("columns:", columns)
    field_names = [
        column.get_column_name()
        for column in table.get_columns()
        if column.get_column_name() not in {"Time", "time"}
    ]
    if field_names:
        with reader.query_table(table_name, field_names[:3], batch_size=1024) as result:
            batch = result.read_arrow_batch()
            if batch is not None:
                print(batch.to_pandas().head())

Source & license

• Original dataset: https://huggingface.co/datasets/zwonzis/xarm7-pick-orange-ball-large
• Author / publisher: zwonzis
• License: apache-2.0