How harunaacar/cvat-nuscenes-roundtrip works
This is a two-script nuScenes↔CVAT 3D annotation converter. The forward script prepares sensor media, Datumaro annotations, labels, and mapping metadata for CVAT; after editing and exporting in CVAT, the round-trip script uses that export, mapping, and original dataset to rebuild nuScenes annotations and instances while preserving other dataset content. CVAT editing is an external human/tool stage. The excerpts show the major conversion responsibilities, but not every helper or exact call sequence, so edges are limited to documented or visible relationships.
Main entry points: cvat_to_nuscenes_roundtrip_v2 .py Round-trip converter · nuscenes_to_cvat_v5.py Forward converter
Components 12
nuScenes to CVAT
- Forward converter
scripts/nuscenes_to_cvat_v5.py - Sensor media
scripts/nuscenes_to_cvat_v5.py - Datumaro annotations
scripts/nuscenes_to_cvat_v5.py - Mapping and labels
scripts/nuscenes_to_cvat_v5.py
CVAT to nuScenes
- Round-trip converter
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Coordinate transform
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Annotation and instance rebuild
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Updated nuScenes dataset
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Round-trip report
scripts/cvat_to_nuscenes_roundtrip_v2 .py
Other components
- nuScenes dataset
- CVAT task and edits
- Datumaro export
Connections 15
- nuScenes dataset → Forward converter: reads dataset
scripts/nuscenes_to_cvat_v5.py - Forward converter → Sensor media: writes media
scripts/nuscenes_to_cvat_v5.py - Forward converter → Datumaro annotations: writes annotations
scripts/nuscenes_to_cvat_v5.py - Forward converter → Mapping and labels: writes metadata
scripts/nuscenes_to_cvat_v5.py - Sensor media → CVAT task and edits: upload media
README.md - Datumaro annotations → CVAT task and edits: import annotations
README.md - CVAT task and edits → Datumaro export: exports edits
README.md - Datumaro export → Round-trip converter: provides export
README.md - Mapping and labels → Round-trip converter: provides mapping
README.md - nuScenes dataset → Round-trip converter: provides source data
README.md - Round-trip converter → Coordinate transform: converts cuboids
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Round-trip converter → Annotation and instance rebuild: rebuilds records
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Round-trip converter → Updated nuScenes dataset: writes dataset
scripts/cvat_to_nuscenes_roundtrip_v2 .py - Round-trip converter → Round-trip report: writes report
README.md - Updated nuScenes dataset → Forward converter: re-import for verification
README.md