# pragatisource08/drone-vehicle-detection architecture

> Architecture diagram of the GitHub repository pragatisource08/drone-vehicle-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pragatisource08/drone-vehicle-detection
- Repository: https://github.com/pragatisource08/drone-vehicle-detection

## Overview

This repository is a notebook-based experiment in detecting and tracking vehicles in drone footage. The documented workflow fine-tunes YOLO11n on VisDrone, runs detection under different confidence and resolution settings, tracks detections with ByteTrack, and analyses tracking-ID persistence and classes. The README describes these stages but the supplied evidence contains no notebook source excerpts, so the notebook-to-stage assignments and internal calls cannot be verified; the graph shows only documented relationships.

Main entry points: [`Vehicle_Detection.ipynb`](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Vehicle_Detection.ipynb) (Vehicle detection), [`Drone_vehicle_detection.ipynb`](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb) (Object tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_modeling["Modeling"]
  node_fine_tuning["Model fine-tuning"]
end

subgraph group_inference["Detection"]
  node_detection["Vehicle detection"]
  node_experiments["Inference experiments"]
end

subgraph group_tracking["Tracking"]
  node_bytetrack["ByteTrack"]
  node_tracking["Object tracking"]
  node_analysis["Tracking analysis"]
end

node_user(("Notebook user"))
node_visdrone[("VisDrone dataset")]
node_yolo["YOLO11n"]
node_drone_video["Drone video"]

node_user -->|"runs notebook"| node_fine_tuning
node_visdrone -->|"training data"| node_fine_tuning
node_yolo -->|"fine-tunes"| node_fine_tuning
node_user -->|"runs notebook"| node_detection
node_drone_video -->|"video input"| node_detection
node_yolo -->|"detects vehicles"| node_detection
node_detection -->|"varies settings"| node_experiments
node_detection -->|"provides detections"| node_tracking
node_bytetrack -->|"associates objects"| node_tracking
node_tracking -->|"tracking IDs"| node_analysis

click node_fine_tuning "https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb"
click node_detection "https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Vehicle_Detection.ipynb"
click node_experiments "https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Vehicle_Detection.ipynb"
click node_tracking "https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb"
click node_analysis "https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb"

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_fine_tuning,node_user toneBlue
class node_detection,node_experiments,node_visdrone toneAmber
class node_bytetrack,node_tracking,node_analysis toneMint
class node_yolo,node_drone_video toneIndigo
```

## Components

### Modeling

- [Model fine-tuning](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb): `Drone_vehicle_detection.ipynb`

### Detection

- [Vehicle detection](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Vehicle_Detection.ipynb): `Vehicle_Detection.ipynb`
- [Inference experiments](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Vehicle_Detection.ipynb): `Vehicle_Detection.ipynb`

### Tracking

- **ByteTrack**
- [Object tracking](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb): `Drone_vehicle_detection.ipynb`
- [Tracking analysis](https://github.com/pragatisource08/drone-vehicle-detection/blob/main/Drone_vehicle_detection.ipynb): `Drone_vehicle_detection.ipynb`

### Other components

- **Notebook user**
- **VisDrone dataset**
- **YOLO11n**
- **Drone video**

## Connections

- Notebook user → Model fine-tuning: runs notebook (evidence: `Readme.md`)
- VisDrone dataset → Model fine-tuning: training data (evidence: `Readme.md`)
- YOLO11n → Model fine-tuning: fine-tunes (evidence: `Readme.md`)
- Notebook user → Vehicle detection: runs notebook (evidence: `Readme.md`)
- Drone video → Vehicle detection: video input (evidence: `Readme.md`)
- YOLO11n → Vehicle detection: detects vehicles (evidence: `Readme.md`)
- Vehicle detection → Inference experiments: varies settings (evidence: `Readme.md`)
- Vehicle detection → Object tracking: provides detections (evidence: `Readme.md`)
- ByteTrack → Object tracking: associates objects (evidence: `Readme.md`)
- Object tracking → Tracking analysis: tracking IDs (evidence: `Readme.md`)
