# darkanalytica1/drone-detection-eval architecture

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

- Interactive diagram: https://gitdiagram.com/darkanalytica1/drone-detection-eval
- Repository: https://github.com/darkanalytica1/drone-detection-eval

## Overview

ddeval is a dependency-free evaluation harness for small-drone detection and tracking, not a detector. The main workflow accepts MOT or Anti-UAV ground truth plus MOT predictions, evaluates them at a supplied frame rate, and prints or writes a report. Its demo generates a synthetic scene and simulated detections before running the same evaluation. The graph preserves input handling, matching, metric calculation, reporting, and the documented demo capability; edges reflect calls or data use visible in the excerpts.

Main entry points: [`ddeval/__main__.py`](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/__main__.py) (CLI commands), [`ddeval/metrics.py`](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/metrics.py) (Metrics and tracks), [`ddeval/formats.py`](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/formats.py) (Input and MOT formats), [`ddeval/matching.py`](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/matching.py) (Box matching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Command workflow"]
  node_cli["CLI commands<br/>[__main__.py]"]
  node_formats["Input and MOT formats<br/>[formats.py]"]
end

subgraph group_evaluation["Evaluation core"]
  node_metrics["Metrics and tracks<br/>[metrics.py]"]
  node_matching["Box matching<br/>[matching.py]"]
  node_reports["Text and Markdown reports<br/>[report.py]"]
end

subgraph group_demo["Synthetic demo"]
  node_scene["Synthetic scene<br/>[synth.py]"]
  node_detector["Simulated detector<br/>[synth.py]"]
end

node_operator(("User"))

node_operator -->|"runs"| node_cli
node_cli -->|"reads or writes"| node_formats
node_cli -->|"evaluates"| node_metrics
node_metrics -->|"matches boxes"| node_matching
node_cli -->|"formats results"| node_reports
node_cli -->|"generates demo"| node_scene
node_cli -->|"simulates predictions"| node_detector

click node_cli "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/__main__.py"
click node_formats "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/formats.py"
click node_metrics "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/metrics.py"
click node_matching "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/matching.py"
click node_reports "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/report.py"
click node_scene "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/synth.py"
click node_detector "https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/synth.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_cli,node_formats,node_operator toneBlue
class node_metrics,node_matching,node_reports toneAmber
class node_scene,node_detector toneMint
```

## Components

### Command workflow

- [CLI commands](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/__main__.py): `ddeval/__main__.py`
- [Input and MOT formats](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/formats.py): `ddeval/formats.py`

### Evaluation core

- [Metrics and tracks](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/metrics.py): `ddeval/metrics.py`
- [Box matching](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/matching.py): `ddeval/matching.py`
- [Text and Markdown reports](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/report.py): `ddeval/report.py`

### Synthetic demo

- [Synthetic scene](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/synth.py): `ddeval/synth.py`
- [Simulated detector](https://github.com/darkanalytica1/drone-detection-eval/blob/main/ddeval/synth.py): `ddeval/synth.py`

### Other components

- **User**

## Connections

- User → CLI commands: runs (evidence: `README.md`)
- CLI commands → Input and MOT formats: reads or writes (evidence: `ddeval/__main__.py`)
- CLI commands → Metrics and tracks: evaluates (evidence: `ddeval/__main__.py`)
- Metrics and tracks → Box matching: matches boxes (evidence: `ddeval/metrics.py`)
- CLI commands → Text and Markdown reports: formats results (evidence: `ddeval/__main__.py`)
- CLI commands → Synthetic scene: generates demo (evidence: `ddeval/__main__.py`)
- CLI commands → Simulated detector: simulates predictions (evidence: `ddeval/__main__.py`)
