eAP Dataset
收藏eAP 数据集概述
数据集简介
eAP 数据集是用于自动驾驶感知的、最大的多模态事件相机数据集。
引用信息
如需使用本数据集,请引用以下文献: bibtex @misc{li2026eap, title = {Toward Deep Representation Learning for Event-Enhanced Visual Autonomous Perception: the eAP Dataset}, author = {Li, Jinghang and Li, Shichao and Lian, Qing and Li, Peiliang and Chen, Xiaozhi and Zhou, Yi}, year = {2026}, eprint = {2603.16303}, archivePrefix = {arXiv}, primaryClass = {cs.RO}, url = {https://arxiv.org/abs/2603.16303}, }
数据格式
每个发布的序列都是一个独立的目录,结构如下: text $DATASET_ROOT/ └── <sequence_id>/ ├── annotations.pkl ├── frames.pkl ├── events.h5 └── rgb/ └── *.png
文件说明
-
annotations.pkl
- 包含物体级标注信息。
- 主要字段包括:
file_name(对应RGB图像文件名)、events_file(关联的HDF5事件文件路径)、sequence_id(序列标识符)、instance_id(跟踪实例ID)、category(物体类别标签)、bbox(2D边界框[x, y, w, h])、bbox_3d(自车坐标系下的3D边界框[x, y, z, l, h, w, yaw],Z轴向上)、T_event_ego(自车坐标系到事件相机坐标系的变换矩阵)、K_event(事件相机内参矩阵)、velocity(自车坐标系下的物体速度)、ttc(碰撞时间,单位秒)、rgb_exposure_start_timestamp_us(RGB曝光开始时间戳,微秒)、rgb_exposure_end_timestamp_us(RGB曝光结束时间戳,微秒)。
-
frames.pkl
- 包含全帧索引(包括无标注的帧)。
- 主要字段包括:
file_name(RGB图像文件名)、events_file(关联的HDF5事件文件路径)、sequence_id(序列标识符)、rgb_exposure_start_timestamp_us(RGB曝光开始时间戳,微秒)、rgb_exposure_end_timestamp_us(RGB曝光结束时间戳,微秒)。
-
events.h5
- 事件流数据,存储为HDF5格式。
- 通过毫秒到索引的映射表(
ms_to_idx)和events组进行访问,events组包含字段t(时间戳,微秒)、x、y、p(极性)。 - 可视化工具使用以每个RGB曝光中点为中心的50毫秒时间窗口。
可视化工具
工具位于 release_visualizer/ 目录下。
环境配置
bash pip install -r release_visualizer/requirements.txt
视频可视化 (visualize_release_sequence.py)
将完整序列渲染为MP4视频。
-
基本命令: bash python release_visualizer/visualize_release_sequence.py $DATASET_ROOT --sequence-id <sequence_id> --output-dir ./outputs
-
输出:
./outputs/<sequence_id>_release_visualization.mp4 -
布局:左侧面板为RGB图像与事件叠加;右侧面板为带有碰撞时间(TTC)标注的鸟瞰图。
-
关键参数:
参数 默认值 描述 --fps10 输出视频帧率 --max-frames N— 仅渲染前N帧 --frame-step N1 每N帧渲染一帧 --image-width960 左侧RGB/事件面板宽度(像素) --bev-width760 鸟瞰图面板宽度(像素) --fwd-max60.0 鸟瞰图前向范围(米) --lat-max30.0 鸟瞰图横向半范围(米)
帧采样 (sample_release_frames.py)
导出少量随机采样的渲染帧(PNG格式)用于快速检查。
-
基本命令: bash python release_visualizer/sample_release_frames.py $DATASET_ROOT --sequence-id <sequence_id> --output-dir ./release_checks --samples-per-asset 5
-
输出:
./release_checks/<sequence_id>_<frame_idx>.png -
关键参数:
参数 默认值 描述 --samples-per-asset5 每个序列随机采样的帧数 --seed0 可重复采样的随机种子 --image-width960 左侧面板宽度(像素) --bev-width760 鸟瞰图面板宽度(像素)
故障排除
如遇OpenMP共享内存错误,请显式设置线程数: bash env OMP_NUM_THREADS=1 MKL_NUM_THREADS=1 OPENBLAS_NUM_THREADS=1 KMP_INIT_AT_FORK=FALSE python release_visualizer/visualize_release_sequence.py ...




