# zchengchen/uitde architecture

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

- Interactive diagram: https://gitdiagram.com/zchengchen/uitde
- Repository: https://github.com/zchengchen/uitde

## Overview

UITDE is research code for evaluating crowdsourced sensing data in intelligent transportation. Its main workflow loads worker reports and UAV-collected ground truths, classifies workers, rectifies some reports, discovers task truths, and computes accuracy and error. A separate trajectory workflow generates task locations, prioritizes tasks with many undefined-worker reports, and plans UAV routes. The README describes these capabilities, but the sampled code does not show trajectory outputs feeding the evaluator; that connection is therefore omitted.

Main entry points: [`source_code/truth_evaluation/truth_infer.py`](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py) (UITDE evaluator), [`source_code/uav_trajectory/map.py`](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.py) (Map generator), [`source_code/uav_trajectory/path.py`](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/path.py) (Route planner), [`source_code/uav_trajectory/map.csv`](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.csv) (Task map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evaluation["Truth evaluation"]
  node_evaluator["UITDE evaluator<br/>[truth_infer.py]"]
  node_worker_classification["Worker classification<br/>[truth_infer.py]"]
  node_rectification["Report rectification<br/>[truth_infer.py]"]
  node_truth_discovery["Truth discovery<br/>[truth_infer.py]"]
  node_metrics["Trust and error<br/>[truth_infer.py]"]
end

subgraph group_trajectory["UAV trajectories"]
  node_map_generator["Map generator<br/>[map.py]"]
  node_route_planner["Route planner<br/>[path.py]"]
  node_routes["UAV routes<br/>[path.py]"]
end

subgraph group_inputs["Data inputs"]
  node_worker_datasets["Quality datasets"]
  node_task_map["Task map<br/>[map.csv]"]
end

node_operator(("Researcher"))
node_workers(("IoT workers"))
node_uav(("UAV collection"))

node_operator -->|"runs"| node_evaluator
node_workers -.->|"provide reports"| node_evaluator
node_uav -.->|"provide ground truth"| node_evaluator
node_worker_datasets -->|"loads reports"| node_evaluator
node_evaluator -->|"classifies"| node_worker_classification
node_evaluator -->|"rectifies"| node_rectification
node_evaluator -->|"discovers truths"| node_truth_discovery
node_evaluator -->|"computes metrics"| node_metrics
node_operator -->|"runs"| node_map_generator
node_map_generator -->|"writes locations"| node_task_map
node_task_map -->|"loads locations"| node_route_planner
node_route_planner -->|"plans routes"| node_routes

click node_evaluator "https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py"
click node_worker_classification "https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py"
click node_rectification "https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py"
click node_truth_discovery "https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py"
click node_metrics "https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py"
click node_worker_datasets "https://github.com/zchengchen/uitde/tree/main/source_code/truth_evaluation/datasets"
click node_map_generator "https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.py"
click node_task_map "https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.csv"
click node_route_planner "https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/path.py"
click node_routes "https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/path.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_evaluator,node_worker_classification,node_rectification,node_truth_discovery,node_metrics toneBlue
class node_map_generator,node_route_planner,node_routes toneAmber
class node_worker_datasets,node_task_map toneMint
class node_operator,node_uav toneIndigo
class node_workers toneRose
```

## Components

### Truth evaluation

- [UITDE evaluator](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py): `source_code/truth_evaluation/truth_infer.py`
- [Worker classification](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py): `source_code/truth_evaluation/truth_infer.py`
- [Report rectification](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py): `source_code/truth_evaluation/truth_infer.py`
- [Truth discovery](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py): `source_code/truth_evaluation/truth_infer.py`
- [Trust and error](https://github.com/zchengchen/uitde/blob/main/source_code/truth_evaluation/truth_infer.py): `source_code/truth_evaluation/truth_infer.py`

### UAV trajectories

- [Map generator](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.py): `source_code/uav_trajectory/map.py`
- [Route planner](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/path.py): `source_code/uav_trajectory/path.py`
- [UAV routes](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/path.py): `source_code/uav_trajectory/path.py`

### Data inputs

- [Quality datasets](https://github.com/zchengchen/uitde/tree/main/source_code/truth_evaluation/datasets): `source_code/truth_evaluation/datasets`
- [Task map](https://github.com/zchengchen/uitde/blob/main/source_code/uav_trajectory/map.csv): `source_code/uav_trajectory/map.csv`

### Other components

- **Researcher**
- **IoT workers**
- **UAV collection**

## Connections

- Researcher → UITDE evaluator: runs (evidence: `source_code/truth_evaluation/truth_infer.py`)
- IoT workers → UITDE evaluator: provide reports (evidence: `README.md`)
- UAV collection → UITDE evaluator: provide ground truth (evidence: `README.md`)
- Quality datasets → UITDE evaluator: loads reports (evidence: `source_code/truth_evaluation/truth_infer.py`)
- UITDE evaluator → Worker classification: classifies (evidence: `source_code/truth_evaluation/truth_infer.py`)
- UITDE evaluator → Report rectification: rectifies (evidence: `source_code/truth_evaluation/truth_infer.py`)
- UITDE evaluator → Truth discovery: discovers truths (evidence: `source_code/truth_evaluation/truth_infer.py`)
- UITDE evaluator → Trust and error: computes metrics (evidence: `source_code/truth_evaluation/truth_infer.py`)
- Researcher → Map generator: runs (evidence: `source_code/uav_trajectory/map.py`)
- Map generator → Task map: writes locations (evidence: `source_code/uav_trajectory/map.py`)
- Task map → Route planner: loads locations (evidence: `source_code/uav_trajectory/path.py`)
- Route planner → UAV routes: plans routes (evidence: `source_code/uav_trajectory/path.py`)
