Waymo Open Dataset 完整快速上手指南:3 步跑通自动驾驶感知数据加载与评测

发布时间:2026/8/23 17:36:08
Waymo Open Dataset 完整快速上手指南:3 步跑通自动驾驶感知数据加载与评测 Waymo Open Dataset 完整快速上手指南3 步跑通自动驾驶感知数据加载与评测【免费下载链接】waymo-open-datasetWaymo Open Dataset项目地址: https://gitcode.com/gh_mirrors/wa/waymo-open-datasetWaymo Open Dataset 是 Waymo 自动驾驶数据集的官方代码库提供数据格式定义、模型评测指标和 TensorFlow 数据读取工具。无论你是想接触真实自动驾驶数据的新手还是准备评测检测、跟踪、运动预测模型的算法开发者按这篇走 10 分钟就能跑起来。先搞清楚它是什么数据集工具包不是能直接启动的应用一句话结论这个仓库里没有原始数据也没有python main.py这种入口它的定位是配套数据集的代码工具箱。它解决三件事数据格式用 proto 把 Perception、Motion、End-to-End Driving 三个数据集的字段结构定死dataset.proto是数据格式的字典评测指标检测 mAP、跟踪 MOTA、语义分割、运动预测等指标的官方实现C 核心加 Python 封装保证你和榜单算分口径一致数据读取一组 TensorFlow 辅助函数把 TFRecord 里的点云、相机图像、标签框解析成好用的张量边界说清楚数据文件本身不在这个仓库里需要单独申请下载代码主体是 Apache 2.0但wdl_limited/子目录是单独的 BSD 3-clause 加受限专利授权数据集本身限非商业用途。搞清楚这三点后面就不会踩坑。环境准备pip 和源码构建两种装法核心依赖版本基线是Python 3.10 TensorFlow 2.13 numpy 1.23.5装之前先确认你的环境能省掉一半的报错。方式一直接装官方 pip 包最省事pip install waymo-open-dataset方式二从源码构建 wheel需要改代码或跟最新提交时用先装好 bazeliskcd src bazelisk build //waymo_open_dataset/waymo_open_dataset/pip_pkg_scripts:wheel产物在bazel-bin/下拿到.whl后pip install进去即可。完整依赖锁定在 requirements.in 里遇到版本冲突以它为准。如果你不想跟编译环境搏斗直接跳下一节的 Docker 路线。第一次运行用 Docker 打开官方教程 Notebook最短可跑路径是官方预制的 Jupyter 镜像——四条命令浏览器里直接出结果git clone https://gitcode.com/gh_mirrors/wa/waymo-open-dataset cd waymo-open-dataset docker build -t wod_jupyter -f tutorial/cpu-jupyter.Dockerfile . docker run -p 8888:8888 wod_jupyter打开 http://localhost:8888 点进 tutorial_local.ipynb 逐格运行你会依次看到解析仓库自带的两帧样例数据tutorial/frames把点云和相机图像读出来用假预测文件 假真值文件跑一遍检测指标计算零门槛体验官方评测流程3D 点云的直观可视化跑完这个 notebook你就完整走了一遍读数据 → 算指标 → 画图的主线。tutorial/ 目录里还有十几个按任务分的 notebook运动预测、3D 语义分割、关键点、端到端驾驶、v2 版数据接口各取所需。核心目录速览你真正会碰的 4 个路径路径干什么用tutorial/官方 notebook 集合每个任务一个入口新手从这里起步src/waymo_open_dataset/utils/frame_utils、box_utils、geometry_utils等解析与绘图工具读数据必 importsrc/waymo_open_dataset/metrics/检测/跟踪/分割/运动指标实现含tools/下的命令行入口src/waymo_open_dataset/protos/dataset.proto等格式定义字段看不明白时查这里其余的math/几何库、data_conversion/数据集版本迁移、latency/延迟赛提交框架、v2/新版列式数据接口都属于特定场景代码第一遍可以先跳过。常见问题与注意事项数据在哪里仓库只有代码没有数据集文件。需要从官方渠道申请下载后用tf.data.TFRecordDataset加载想先尝鲜用仓库里的tutorial/frames两帧样例即可。import tensorflow 报版本冲突大概率是 Python 或 TF 版本偏离了 3.10 / 2.13 基线要么按锁定文件重装依赖要么直接用 Docker 镜像一步到位。许可证别踩雷wdl_limited/下的相机模型、分割与 Sim Agents 指标代码授权范围更窄只能配合数据集规定用途使用数据集本身也限非商用。商用前务必逐条核对。标签口径不清楚官方标注规范在 labeling_specifications.md里面有车辆、行人、骑行者的 3D 框标注示例评测前建议过一眼改完代码想回归测试仓库大量使用 bazel 组织构建与测试bazelisk test //waymo_open_dataset/...是验证改动的第一选择。【免费下载链接】waymo-open-datasetWaymo Open Dataset项目地址: https://gitcode.com/gh_mirrors/wa/waymo-open-dataset创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考