# kamkyu94/tracktrack architecture

> Architecture diagram of the GitHub repository kamkyu94/tracktrack, 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/kamkyu94/tracktrack
- Repository: https://github.com/kamkyu94/tracktrack

## Overview

TrackTrack is an online multi-object tracking research system for MOT17, MOT20, and DanceTrack. Its documented workflow runs YOLOX detection, FastReID, then Tracker; the sampled detector writes detections, and the tracker consumes detection pickles, updates tracks, applies dataset-specific post-processing, and evaluates validation results. FastReID supplies a re-identification training and inference framework, but the excerpts do not establish how its outputs connect to the tracker. Some subsystem links below are documented only at the repository workflow level.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_detection["YOLOX Detection"]
  node_detect["Detection Runner"]
  node_exp["Experiment Config"]
  node_yolo_data["Detection Data"]
  node_yolo_head["YOLOX Head"]
  node_yolo_losses["Detection Losses"]
  node_yolo_blocks["Network Blocks"]
  node_yolo_eval["Detection Evaluator"]
  node_yolo_launch["Distributed Launch"]
  node_yolo_scheduler["Learning Scheduler"]
end

subgraph group_reid["FastReID Embeddings"]
  node_reid_train["ReID Training"]
  node_reid_defaults["Training Framework"]
  node_reid_data["ReID Data"]
  node_reid_config["Configuration"]
  node_reid_head["Embedding Head"]
  node_reid_features["Feature Extraction"]
  node_reid_computer["Embedding Computer"]
end

subgraph group_tracking["Tracking Pipeline"]
  node_tracker_run["Tracking Runner"]
  node_tracker_core["Track Association"]
  node_track_state["Track State"]
  node_kalman["Kalman Filter"]
  node_aflink["Track Linker"]
  node_aflink_data["Link Dataset"]
  node_track_utils["Tracking Utilities"]
  node_interpolation["Gap Interpolation"]
end

subgraph group_evaluation["Evaluation"]
  node_trackeval["Evaluation Runner"]
  node_mot_dataset["MOT Dataset"]
  node_dataset_base["Dataset Base"]
  node_track_metric["Track Metrics"]
end

node_user(("Operator"))

node_user -->|"runs first"| node_detect
node_detect -->|"loads config"| node_exp
node_detect -->|"launches"| node_yolo_launch
node_detect -->|"detects with"| node_yolo_eval
node_detect -->|"writes detections"| node_tracker_run
node_yolo_head -->|"uses"| node_yolo_losses
node_yolo_head -->|"uses"| node_yolo_blocks
node_user -->|"runs second"| node_reid_train
node_reid_train -->|"loads config"| node_reid_config
node_reid_train -.->|"launches"| node_reid_defaults
node_reid_defaults -->|"builds loader"| node_reid_data
node_reid_defaults -->|"builds model"| node_reid_head
node_reid_features -->|"uses"| node_reid_computer
node_user -->|"runs third"| node_tracker_run
node_tracker_run -->|"updates tracks"| node_tracker_core
node_tracker_run -->|"links tracks"| node_aflink
node_tracker_run -->|"creates dataset"| node_aflink_data
node_tracker_run -->|"sets parameters"| node_track_utils
node_tracker_run -->|"interpolates gaps"| node_interpolation
node_tracker_core -->|"creates tracks"| node_track_state
node_track_state -->|"filters motion"| node_kalman
node_tracker_run -->|"evaluates results"| node_trackeval
node_trackeval -.->|"loads dataset"| node_mot_dataset
node_mot_dataset -->|"extends"| node_dataset_base
node_track_metric -->|"uses utilities"| node_dataset_base

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_detect,node_exp,node_yolo_data,node_yolo_head,node_yolo_losses,node_yolo_blocks,node_yolo_eval,node_yolo_launch,node_yolo_scheduler toneBlue
class node_reid_train,node_reid_defaults,node_reid_data,node_reid_config,node_reid_head,node_reid_features,node_reid_computer toneAmber
class node_tracker_run,node_tracker_core,node_track_state,node_kalman,node_aflink,node_aflink_data,node_track_utils,node_interpolation toneMint
class node_trackeval,node_mot_dataset,node_dataset_base,node_track_metric toneRose
class node_user toneIndigo
```

## Components

### YOLOX Detection

- **Detection Runner**
- **Experiment Config**
- **Detection Data**
- **YOLOX Head**
- **Detection Losses**
- **Network Blocks**
- **Detection Evaluator**
- **Distributed Launch**
- **Learning Scheduler**

### FastReID Embeddings

- **ReID Training**
- **Training Framework**
- **ReID Data**
- **Configuration**
- **Embedding Head**
- **Feature Extraction**
- **Embedding Computer**

### Tracking Pipeline

- **Tracking Runner**
- **Track Association**
- **Track State**
- **Kalman Filter**
- **Track Linker**
- **Link Dataset**
- **Tracking Utilities**
- **Gap Interpolation**

### Evaluation

- **Evaluation Runner**
- **MOT Dataset**
- **Dataset Base**
- **Track Metrics**

### Other components

- **Operator**

## Connections

- Operator → Detection Runner: runs first
- Detection Runner → Experiment Config: loads config
- Detection Runner → Distributed Launch: launches
- Detection Runner → Detection Evaluator: detects with
- Detection Runner → Tracking Runner: writes detections
- YOLOX Head → Detection Losses: uses
- YOLOX Head → Network Blocks: uses
- Operator → ReID Training: runs second
- ReID Training → Configuration: loads config
- ReID Training → Training Framework: launches
- Training Framework → ReID Data: builds loader
- Training Framework → Embedding Head: builds model
- Feature Extraction → Embedding Computer: uses
- Operator → Tracking Runner: runs third
- Tracking Runner → Track Association: updates tracks
- Tracking Runner → Track Linker: links tracks
- Tracking Runner → Link Dataset: creates dataset
- Tracking Runner → Tracking Utilities: sets parameters
- Tracking Runner → Gap Interpolation: interpolates gaps
- Track Association → Track State: creates tracks
- Track State → Kalman Filter: filters motion
- Tracking Runner → Evaluation Runner: evaluates results
- Evaluation Runner → MOT Dataset: loads dataset
- MOT Dataset → Dataset Base: extends
- Track Metrics → Dataset Base: uses utilities
