Skip to main content

Nuscenes Hacker

nuscenes数据集搭配nuscenes-devkit使用非常便捷,但是因为nuscenes是已经固定的数据,所以nuscenes-devkit在设计时候没有考虑过拓展性问题,将很多数据集的信息硬编码在其中了,例如

  • 场景名称
  • 地图名称
  • 数据集划分
  • 传感器 channel 名称
  • 点云的数据格式(通道数)

所以当我们使用自己制作的nuscenes格式数据时候,就会遇到很多问题

如果直接对 nuscenes-devkit 进行修改,这样会破坏兼容性问题,很不优雅

所以我想,有没有一种方式可以"悄无声息"的对 nuscenes-devkit 进行修改呢?

答案是肯定的,这就是本项目的目的

本项目的目的是在悄咪咪的情况下对 nuscenes-devkit 进行修改,当使用完毕后,nuscenes-devkit 还是原来的样子,只是在运行时候,会使用我们自己的数据集,是不是像一个 Hacker 一样呢?

Install

Warning: 该项目只支持 python3.7 及以下版本(受限于numpy与nuscenes-devkit冲突)

pip3 install nuscenes-hacker

or

git clone https://github.com/windzu/nuscenes_hacker.git
cd nuscenes_hacker
pip3 install -e .
python -m pip install -e .

Usage

hack

基本用法

nuscenes-hacker hack [参数]

参数说明 必需参数

参数 类型 描述
dataset string NuScenes 数据集的根目录路径

例如

nuscenes-hacker hack /path/to/nuscenes

可选参数

参数 类型 描述
--conda-env-name string 指定需要替换的 conda 环境名称。如果不指定,则使用当前环境。
--lidar-channel string 指定使用的激光雷达通道名称,如果不指定,则不替换。例如:LIDAR_TOP
--camera-channels string 指定相机通道,多个通道用逗号分隔,如果不指定,则不替换。例如:CAM_FRONT,CAM_BACK
--pcd-dims int 指定点云的维度,如果不指定,则不替换。例如:4或5

使用 nuscenes-hacker hack --help 可以查看所有参数的详细说明

restore

恢复 nuscenes-devkit 到原始状态

nuscenes-hacker restore

注意事项 路径检查:程序会检查 dataset 是否存在,如果不存在将报错并终止运行

conda 环境:

如果指定了 conda-env-name,工具将尝试在该 conda 环境中找到 nuscenes 包并修改。 如果未指定,工具将使用当前环境中的 nuscenes 包。 兼容性问题:

此工具仅支持 Python 3.6 和 3.7,不支持 Python 3.8 及以上版本。 如果使用 NumPy 2.0+,可能会遇到兼容性问题,建议使用 NumPy 1.x 版本。 参数处理:

相机通道参数 (--camera-channels) 接受以逗号分隔的字符串,会被自动拆分为列表。 如果未指定某个可选参数,对应的功能将不会被替换或修改。 排错指南 如果遇到 "未找到 nuscenes 包" 的错误,请尝试以下解决方案:

确保已安装 nuscenes-devkit:pip install nuscenes-devkit 使用 --conda-env-name 参数指定正确的 conda 环境 检查 Python 版本是否为 3.6 或 3.7 如果使用 NumPy 2.0+,尝试降级到 NumPy 1.x:pip install numpy==1.24.4 支持和反馈 如有问题或建议,请访问 GitHub 仓库 或联系作者:windzu1@gmail.com

Metadata

Release files for nuscenes-hacker 0.0.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nuscenes-hacker 0.0.8
File Size Uploaded Provenance Actions
nuscenes_hacker-0.0.8.tar.gz 11.4 kB Without provenance Details for nuscenes_hacker-0.0.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nuscenes-hacker 0.0.8
File Interpreter ABI Platform Actions
nuscenes_hacker-0.0.8-py3-none-any.whl Python 3 none any Details for nuscenes_hacker-0.0.8-py3-none-any.whl

Total release size: 22.8 kB

Release files / nuscenes_hacker-0.0.8.tar.gz

Download URL nuscenes_hacker-0.0.8.tar.gz
Size 11.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b423cc2b0862cfec42ceb29865e60406a7fb31bdfc10e0bec34ed8ebe7a2a896
BLAKE2b-256 checksum
How to use checksums
e622fa965e7c2de3628d457781fef6696705473b4185a502115816e7bfea805b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.20

Release files / nuscenes_hacker-0.0.8-py3-none-any.whl

Download URL nuscenes_hacker-0.0.8-py3-none-any.whl
Size 11.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
64af2fa1902ff707db3b86365207c5f16653e4a1da1f72060bae5da92ba5b2e8
BLAKE2b-256 checksum
How to use checksums
a93c50ecca29bd3b14d85428f6994a1ac09faea0baca89d88590329a47bec4a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.20

Security for nuscenes-hacker 0.0.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page