# udairatinam-g/mobility-dreamer architecture

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

- Interactive diagram: https://gitdiagram.com/udairatinam-g/mobility-dreamer
- Repository: https://github.com/udairatinam-g/mobility-dreamer

## Overview

MobilityDreamer is a scaffold for training a policy- and semantic-conditioned urban video generator on BDD100K sequences. The principal workflow loads indexed sequences, applies consistent transforms, generates frames, and optimizes adversarial and auxiliary losses; validation measures reconstruction and training saves checkpoints. Preprocessing scripts and synthetic-data generation are present in the tree, but their source was not sampled, so their detailed behavior and connections are not inferred. The supplied README excerpt is empty.

Main entry points: [`MobilityDreamer/core/train.py`](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/core/train.py) (Training and validation), [`MobilityDreamer/datasets/bdd100k_dataset.py`](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/datasets/bdd100k_dataset.py) (Sequence dataset), [`MobilityDreamer/scripts`](https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/scripts) (BDD100K preprocessing), [`MobilityDreamer/datasets/processed`](https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/datasets/processed) (Sequence indexes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_preprocessing["BDD100K preprocessing"]
  node_sequence_data["Sequence dataset<br/>[bdd100k_dataset.py]"]
  node_sequence_index[("Sequence indexes")]
  node_transforms["Sequence transforms<br/>[transforms.py]"]
end

subgraph group_training["Training workflow"]
  node_config["Experiment configuration<br/>[mobility_config.py]"]
  node_trainer["Training and validation<br/>[train.py]"]
end

subgraph group_models["Generation models"]
  node_generator["Mobility generator<br/>[mobility_gan.py]"]
  node_discriminator["Mobility discriminator<br/>[discriminator.py]"]
end

subgraph group_objectives["Training objectives"]
  node_losses["Loss functions"]
end

node_engineer(("Training operator"))

node_engineer -->|"starts training"| node_trainer
node_trainer -->|"reads settings"| node_config
node_trainer -->|"loads sequences"| node_sequence_data
node_trainer -->|"builds transforms"| node_transforms
node_sequence_data -->|"reads indexes"| node_sequence_index
node_sequence_data -->|"requires preprocessing"| node_preprocessing
node_trainer -->|"generates frames"| node_generator
node_trainer -->|"scores frames"| node_discriminator
node_trainer -->|"computes objectives"| node_losses

click node_preprocessing "https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/scripts"
click node_sequence_data "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/datasets/bdd100k_dataset.py"
click node_sequence_index "https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/datasets/processed"
click node_transforms "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/datasets/transforms.py"
click node_config "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/config/mobility_config.py"
click node_trainer "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/core/train.py"
click node_generator "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/models/mobility_gan.py"
click node_discriminator "https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/models/discriminator.py"
click node_losses "https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/losses"

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_preprocessing,node_sequence_data,node_sequence_index,node_transforms toneBlue
class node_config,node_trainer toneAmber
class node_generator,node_discriminator toneMint
class node_losses toneRose
class node_engineer toneIndigo
```

## Components

### Data preparation

- [BDD100K preprocessing](https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/scripts): `MobilityDreamer/scripts`
- [Sequence dataset](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/datasets/bdd100k_dataset.py): `MobilityDreamer/datasets/bdd100k_dataset.py`
- [Sequence indexes](https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/datasets/processed): `MobilityDreamer/datasets/processed`
- [Sequence transforms](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/datasets/transforms.py): `MobilityDreamer/datasets/transforms.py`

### Training workflow

- [Experiment configuration](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/config/mobility_config.py): `MobilityDreamer/config/mobility_config.py`
- [Training and validation](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/core/train.py): `MobilityDreamer/core/train.py`

### Generation models

- [Mobility generator](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/models/mobility_gan.py): `MobilityDreamer/models/mobility_gan.py`
- [Mobility discriminator](https://github.com/udairatinam-g/mobility-dreamer/blob/main/MobilityDreamer/models/discriminator.py): `MobilityDreamer/models/discriminator.py`

### Training objectives

- [Loss functions](https://github.com/udairatinam-g/mobility-dreamer/tree/main/MobilityDreamer/losses): `MobilityDreamer/losses`

### Other components

- **Training operator**

## Connections

- Training operator → Training and validation: starts training (evidence: `MobilityDreamer/core/train.py`)
- Training and validation → Experiment configuration: reads settings (evidence: `MobilityDreamer/core/train.py`)
- Training and validation → Sequence dataset: loads sequences (evidence: `MobilityDreamer/core/train.py`)
- Training and validation → Sequence transforms: builds transforms (evidence: `MobilityDreamer/core/train.py`)
- Sequence dataset → Sequence indexes: reads indexes (evidence: `MobilityDreamer/datasets/bdd100k_dataset.py`)
- Sequence dataset → BDD100K preprocessing: requires preprocessing (evidence: `MobilityDreamer/datasets/bdd100k_dataset.py`)
- Training and validation → Mobility generator: generates frames (evidence: `MobilityDreamer/core/train.py`)
- Training and validation → Mobility discriminator: scores frames (evidence: `MobilityDreamer/core/train.py`)
- Training and validation → Loss functions: computes objectives (evidence: `MobilityDreamer/core/train.py`)
