x4d-devkit 0.1.0

X-4D dataset format SDK — load, validate, evaluate, and convert autonomous driving datasets

x4d-devkit

X-4D dataset format SDK for autonomous driving — load, validate, evaluate, and convert datasets.

Installation

pip install x4d-devkit

With optional dependencies:

# NuScenes format converter
pip install x4d-devkit[converters]

# Platform API client
pip install x4d-devkit[client]

Quick Start

Load a clip

from x4d_devkit import ClipLoader

clip = ClipLoader("/path/to/clip")
print(clip.meta)

for sample in clip.samples:
    # Access sensor data
    for sd in clip.sample_data_by_sample(sample.token):
        print(sd.channel, sd.filename)

Validate a clip

x4d validate /path/to/clip

from x4d_devkit import validate_clip

report = validate_clip("/path/to/clip")
print(report)

Detection evaluation

from x4d_devkit import DetectionEval, DetectionConfig

config = DetectionConfig(
    class_names=["car", "pedestrian", "bicycle"],
    dist_thresholds=[0.5, 1.0, 2.0, 4.0],
)
evaluator = DetectionEval(config, gt_clips=[...], pred_clips=[...])
result = evaluator.evaluate()
print(f"mAP: {result.mAP:.3f}, NDS: {result.NDS:.3f}")

Convert from NuScenes

from x4d_devkit.converters import NuScenesConverter

converter = NuScenesConverter("/path/to/nuscenes")
converter.convert_scene("scene-0001", output_dir="/path/to/output")

Modules

Module	Description
core	Data models, token generation, coordinate transforms, clip loader
eval	Detection evaluation (mAP, TP metrics, NDS)
converters	Format converters (NuScenes → X4D)
validation	Clip structure and data validation
client	X-4D platform API client

License

Apache License 2.0