# harunaacar/nuscenes-xtreme1-roundtrip architecture

> Architecture diagram of the GitHub repository harunaacar/nuscenes-xtreme1-roundtrip, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harunaacar/nuscenes-xtreme1-roundtrip
- Repository: https://github.com/harunaacar/nuscenes-xtreme1-roundtrip

## Overview

This repository is a two-way nuScenes–Xtreme1 annotation converter. The main workflow converts nuScenes scenes into Xtreme1 packages, lets a user edit tracks in Xtreme1, then applies exported deletions to a separate nuScenes copy for reload verification. The graph also shows identity preservation, sensor/geometry conversion, dataset-class setup, and report generation. Arrows follow README-described stages and visible script calls; unsampled implementation details are not expanded.

Main entry points: [`scripts/xtreme1_to_nuscenes.py`](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py) (Reverse converter), [`scripts/nuscenes_to_xtreme1.py`](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py) (Forward converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_forward["nuScenes to Xtreme1"]
  node_forward_converter["Forward converter"]
  node_sensor_package["Sensor ZIP"]
  node_class_setup["Class setup"]
end

subgraph group_review["Xtreme1 review"]
  node_xtreme1[("Xtreme1 dataset")]
  node_track_edit["Track editing"]
  node_export_zip["Ground Truth export"]
end

subgraph group_reverse["Xtreme1 to nuScenes"]
  node_reverse_converter["Reverse converter"]
  node_track_matching["Track matching"]
  node_metadata_rebuild["Metadata rebuild"]
  node_output_copy[("nuScenes output copy")]
  node_roundtrip_report["Deletion report"]
end

node_user(("Dataset user"))
node_source[("nuScenes source")]

node_user -->|"runs conversion"| node_forward_converter
node_source -->|"reads scene data"| node_forward_converter
node_forward_converter -->|"resolves classes"| node_class_setup
node_forward_converter -->|"writes ZIP"| node_sensor_package
node_sensor_package -->|"uploads package"| node_xtreme1
node_xtreme1 -->|"opens scene"| node_track_edit
node_user -->|"edits tracks"| node_track_edit
node_track_edit -->|"exports annotations"| node_export_zip
node_user -->|"runs conversion"| node_reverse_converter
node_source -->|"reads original data"| node_reverse_converter
node_export_zip -->|"provides export"| node_reverse_converter
node_reverse_converter -->|"reads exported tracks"| node_track_matching
node_reverse_converter -->|"updates metadata"| node_metadata_rebuild
node_reverse_converter -->|"writes dataset copy"| node_output_copy
node_reverse_converter -->|"writes report"| node_roundtrip_report
node_output_copy -->|"reloads for verification"| node_forward_converter

click node_forward_converter "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py"
click node_sensor_package "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py"
click node_class_setup "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py"
click node_reverse_converter "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py"
click node_track_matching "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py"
click node_metadata_rebuild "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py"
click node_output_copy "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py"
click node_roundtrip_report "https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_forward_converter,node_sensor_package,node_class_setup,node_user toneBlue
class node_xtreme1,node_track_edit,node_export_zip,node_source toneAmber
class node_reverse_converter,node_track_matching,node_metadata_rebuild,node_output_copy,node_roundtrip_report toneMint
```

## Components

### nuScenes to Xtreme1

- [Forward converter](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py): `scripts/nuscenes_to_xtreme1.py`
- [Sensor ZIP](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py): `scripts/nuscenes_to_xtreme1.py`
- [Class setup](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/nuscenes_to_xtreme1.py): `scripts/nuscenes_to_xtreme1.py`

### Xtreme1 review

- **Xtreme1 dataset**
- **Track editing**
- **Ground Truth export**

### Xtreme1 to nuScenes

- [Reverse converter](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py): `scripts/xtreme1_to_nuscenes.py`
- [Track matching](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py): `scripts/xtreme1_to_nuscenes.py`
- [Metadata rebuild](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py): `scripts/xtreme1_to_nuscenes.py`
- [nuScenes output copy](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py): `scripts/xtreme1_to_nuscenes.py`
- [Deletion report](https://github.com/harunaacar/nuscenes-xtreme1-roundtrip/blob/master/scripts/xtreme1_to_nuscenes.py): `scripts/xtreme1_to_nuscenes.py`

### Other components

- **Dataset user**
- **nuScenes source**

## Connections

- Dataset user → Forward converter: runs conversion (evidence: `README.md`)
- nuScenes source → Forward converter: reads scene data (evidence: `README.md`)
- Forward converter → Class setup: resolves classes (evidence: `scripts/nuscenes_to_xtreme1.py`)
- Forward converter → Sensor ZIP: writes ZIP (evidence: `scripts/nuscenes_to_xtreme1.py`)
- Sensor ZIP → Xtreme1 dataset: uploads package (evidence: `README.md`)
- Xtreme1 dataset → Track editing: opens scene (evidence: `README.md`)
- Dataset user → Track editing: edits tracks (evidence: `README.md`)
- Track editing → Ground Truth export: exports annotations (evidence: `README.md`)
- Dataset user → Reverse converter: runs conversion (evidence: `README.md`)
- nuScenes source → Reverse converter: reads original data (evidence: `README.md`)
- Ground Truth export → Reverse converter: provides export (evidence: `README.md`)
- Reverse converter → Track matching: reads exported tracks (evidence: `scripts/xtreme1_to_nuscenes.py`)
- Reverse converter → Metadata rebuild: updates metadata (evidence: `scripts/xtreme1_to_nuscenes.py`)
- Reverse converter → nuScenes output copy: writes dataset copy (evidence: `README.md`)
- Reverse converter → Deletion report: writes report (evidence: `scripts/xtreme1_to_nuscenes.py`)
- nuScenes output copy → Forward converter: reloads for verification (evidence: `README.md`)
