# opendrivelab/lanesegnet architecture

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

- Interactive diagram: https://gitdiagram.com/opendrivelab/lanesegnet
- Repository: https://github.com/opendrivelab/lanesegnet

## Overview

LaneSegNet is a camera-based 3D map-learning system that predicts lane segments and their topology from OpenLane-V2 sequences. Its main workflow prepares dataset annotations, loads and transforms camera data, constructs temporal BEV features, predicts lane geometry and relationships, then evaluates or visualizes results. The Map Element Bucket variant adds map-element and traffic-element prediction branches. Several implementation details are unsampled, so the graph limits those links to documented relationships or leaves them unconnected.

Main entry points: [`projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py) (Bucket detector), [`projects/lanesegnet/models/modules/bevformer_constructer.py`](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/modules/bevformer_constructer.py) (BEV constructor), [`projects/lanesegnet/models/detectors/lanesegnet.py`](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet.py) (LaneSegNet detector), [`projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py`](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py) (LaneSeg dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data and evaluation"]
  node_prep["Data preparation<br/>[data_process.py]"]
  node_pipelines["Data pipelines"]
  node_laneset["LaneSeg dataset"]
  node_bucketset["Bucket dataset"]
  node_evaluation["OpenLane evaluation"]
  node_visualizer["BEV visualizer<br/>[lane_segment.py]"]
end

subgraph group_model["LaneSegNet models"]
  node_training["Training entry<br/>[train.py]"]
  node_lanedet["LaneSegNet detector<br/>[lanesegnet.py]"]
  node_bucketdet["Bucket detector"]
  node_lanehead["Lane head<br/>[laneseg_head.py]"]
  node_relation["Relationship head"]
  node_detr["Deformable DETR head"]
  node_maptr["MapTR head<br/>[maptr_head.py]"]
end

subgraph group_bev["BEV perception"]
  node_bevconstructor["BEV constructor"]
  node_encoder["BEV encoder<br/>[encoder.py]"]
  node_temporal["Temporal attention"]
  node_spatial["Spatial attention"]
  node_decoder["Transformer decoder<br/>[decoder.py]"]
  node_deformfn["Deformable attention kernel"]
  node_base_layer["Transformer base layer"]
end

subgraph group_common["Shared map logic"]
  node_laneutils["Lane geometry utilities<br/>[util.py]"]
  node_coder["Lane coders<br/>[lane_coder.py]"]
  node_assigner["Lane assignment"]
  node_builder["BEV component builder<br/>[builder.py]"]
end

node_user(("Researcher"))

node_user -->|"prepares data"| node_prep
node_prep -->|"creates annotations"| node_laneset
node_user -->|"starts training"| node_training
node_training -.->|"trains model"| node_lanedet
node_laneset -.->|"uses transforms"| node_pipelines
node_bucketset -->|"reuses dataset"| node_laneset
node_laneset -->|"evaluates predictions"| node_evaluation
node_laneset -->|"renders annotations"| node_visualizer
node_lanedet -->|"builds constructor"| node_builder
node_bucketdet -->|"builds constructor"| node_builder
node_lanedet -.->|"constructs BEV"| node_bevconstructor
node_bucketdet -->|"constructs BEV"| node_bevconstructor
node_lanedet -.->|"predicts lanes"| node_lanehead
node_bucketdet -->|"predicts lanes"| node_lanehead
node_bucketdet -->|"predicts topology"| node_relation
node_bucketdet -.->|"predicts traffic"| node_detr
node_bucketdet -.->|"predicts map elements"| node_maptr
node_bevconstructor -.->|"runs encoder"| node_encoder
node_encoder -->|"extends layer"| node_base_layer
node_bevconstructor -->|"uses attention"| node_temporal
node_bevconstructor -->|"uses attention"| node_spatial
node_bevconstructor -->|"uses decoder"| node_decoder
node_temporal -->|"calls kernel"| node_deformfn
node_spatial -->|"calls kernel"| node_deformfn
node_lanedet -.->|"uses geometry"| node_laneutils
node_lanehead -.->|"encodes lanes"| node_coder
node_lanehead -.->|"matches predictions"| node_assigner

click node_prep "https://github.com/opendrivelab/lanesegnet/blob/main/tools/data_process.py"
click node_pipelines "https://github.com/opendrivelab/lanesegnet/tree/main/projects/lanesegnet/datasets/pipelines"
click node_laneset "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py"
click node_bucketset "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_subset_A_mapele_bucket_dataset.py"
click node_evaluation "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_evaluate_custom.py"
click node_visualizer "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/visualizer/lane_segment.py"
click node_training "https://github.com/opendrivelab/lanesegnet/blob/main/tools/train.py"
click node_lanedet "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet.py"
click node_bucketdet "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py"
click node_lanehead "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/laneseg_head.py"
click node_relation "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/relationship_head.py"
click node_detr "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/deformable_detr_head.py"
click node_maptr "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/thirdparty/maptr_head.py"
click node_bevconstructor "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/modules/bevformer_constructer.py"
click node_encoder "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/encoder.py"
click node_temporal "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/temporal_self_attention.py"
click node_spatial "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/spatial_cross_attention.py"
click node_decoder "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/decoder.py"
click node_deformfn "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/multi_scale_deformable_attn_function.py"
click node_base_layer "https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/custom_base_transformer_layer.py"
click node_laneutils "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/util.py"
click node_coder "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/lane_coder.py"
click node_assigner "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/lane_hungarian_assigner.py"
click node_builder "https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/utils/builder.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_prep,node_pipelines,node_laneset,node_bucketset,node_evaluation,node_visualizer toneBlue
class node_training,node_lanedet,node_bucketdet,node_lanehead,node_relation,node_detr,node_maptr toneAmber
class node_bevconstructor,node_encoder,node_temporal,node_spatial,node_decoder,node_deformfn,node_base_layer toneMint
class node_laneutils,node_coder,node_assigner,node_builder toneRose
class node_user toneIndigo
```

## Components

### Data and evaluation

- [Data preparation](https://github.com/opendrivelab/lanesegnet/blob/main/tools/data_process.py): `tools/data_process.py`
- [Data pipelines](https://github.com/opendrivelab/lanesegnet/tree/main/projects/lanesegnet/datasets/pipelines): `projects/lanesegnet/datasets/pipelines`
- [LaneSeg dataset](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py): `projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py`
- [Bucket dataset](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_subset_A_mapele_bucket_dataset.py): `projects/lanesegnet/datasets/openlanev2_subset_A_mapele_bucket_dataset.py`
- [OpenLane evaluation](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/datasets/openlanev2_evaluate_custom.py): `projects/lanesegnet/datasets/openlanev2_evaluate_custom.py`
- [BEV visualizer](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/visualizer/lane_segment.py): `projects/lanesegnet/core/visualizer/lane_segment.py`

### LaneSegNet models

- [Training entry](https://github.com/opendrivelab/lanesegnet/blob/main/tools/train.py): `tools/train.py`
- [LaneSegNet detector](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet.py): `projects/lanesegnet/models/detectors/lanesegnet.py`
- [Bucket detector](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py): `projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`
- [Lane head](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/laneseg_head.py): `projects/lanesegnet/models/dense_heads/laneseg_head.py`
- [Relationship head](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/relationship_head.py): `projects/lanesegnet/models/dense_heads/relationship_head.py`
- [Deformable DETR head](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/dense_heads/deformable_detr_head.py): `projects/lanesegnet/models/dense_heads/deformable_detr_head.py`
- [MapTR head](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/thirdparty/maptr_head.py): `projects/lanesegnet/thirdparty/maptr_head.py`

### BEV perception

- [BEV constructor](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/models/modules/bevformer_constructer.py): `projects/lanesegnet/models/modules/bevformer_constructer.py`
- [BEV encoder](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/encoder.py): `projects/bevformer/modules/encoder.py`
- [Temporal attention](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/temporal_self_attention.py): `projects/bevformer/modules/temporal_self_attention.py`
- [Spatial attention](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/spatial_cross_attention.py): `projects/bevformer/modules/spatial_cross_attention.py`
- [Transformer decoder](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/decoder.py): `projects/bevformer/modules/decoder.py`
- [Deformable attention kernel](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/multi_scale_deformable_attn_function.py): `projects/bevformer/modules/multi_scale_deformable_attn_function.py`
- [Transformer base layer](https://github.com/opendrivelab/lanesegnet/blob/main/projects/bevformer/modules/custom_base_transformer_layer.py): `projects/bevformer/modules/custom_base_transformer_layer.py`

### Shared map logic

- [Lane geometry utilities](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/util.py): `projects/lanesegnet/core/lane/util.py`
- [Lane coders](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/lane_coder.py): `projects/lanesegnet/core/lane/lane_coder.py`
- [Lane assignment](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/core/lane/lane_hungarian_assigner.py): `projects/lanesegnet/core/lane/lane_hungarian_assigner.py`
- [BEV component builder](https://github.com/opendrivelab/lanesegnet/blob/main/projects/lanesegnet/utils/builder.py): `projects/lanesegnet/utils/builder.py`

### Other components

- **Researcher**

## Connections

- Researcher → Data preparation: prepares data
- Data preparation → LaneSeg dataset: creates annotations
- Researcher → Training entry: starts training
- Training entry → LaneSegNet detector: trains model
- LaneSeg dataset → Data pipelines: uses transforms
- Bucket dataset → LaneSeg dataset: reuses dataset (evidence: `projects/lanesegnet/datasets/openlanev2_subset_A_mapele_bucket_dataset.py`)
- LaneSeg dataset → OpenLane evaluation: evaluates predictions (evidence: `projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py`)
- LaneSeg dataset → BEV visualizer: renders annotations (evidence: `projects/lanesegnet/datasets/openlanev2_subset_A_lanesegnet_dataset.py`)
- LaneSegNet detector → BEV component builder: builds constructor (evidence: `projects/lanesegnet/models/detectors/lanesegnet.py`)
- Bucket detector → BEV component builder: builds constructor (evidence: `projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`)
- LaneSegNet detector → BEV constructor: constructs BEV
- Bucket detector → BEV constructor: constructs BEV (evidence: `projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`)
- LaneSegNet detector → Lane head: predicts lanes
- Bucket detector → Lane head: predicts lanes (evidence: `projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`)
- Bucket detector → Relationship head: predicts topology (evidence: `projects/lanesegnet/models/detectors/lanesegnet_mapele_bucket.py`)
- Bucket detector → Deformable DETR head: predicts traffic
- Bucket detector → MapTR head: predicts map elements
- BEV constructor → BEV encoder: runs encoder
- BEV encoder → Transformer base layer: extends layer (evidence: `projects/bevformer/modules/encoder.py`)
- BEV constructor → Temporal attention: uses attention (evidence: `projects/lanesegnet/models/modules/bevformer_constructer.py`)
- BEV constructor → Spatial attention: uses attention (evidence: `projects/lanesegnet/models/modules/bevformer_constructer.py`)
- BEV constructor → Transformer decoder: uses decoder (evidence: `projects/lanesegnet/models/modules/bevformer_constructer.py`)
- Temporal attention → Deformable attention kernel: calls kernel (evidence: `projects/bevformer/modules/temporal_self_attention.py`)
- Spatial attention → Deformable attention kernel: calls kernel (evidence: `projects/bevformer/modules/spatial_cross_attention.py`)
- LaneSegNet detector → Lane geometry utilities: uses geometry
- Lane head → Lane coders: encodes lanes
- Lane head → Lane assignment: matches predictions
