# ak30072002/orin-quadcam-yolo architecture

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

- Interactive diagram: https://gitdiagram.com/ak30072002/orin-quadcam-yolo
- Repository: https://github.com/ak30072002/orin-quadcam-yolo

## Overview

This repository describes a Jetson AGX Orin application for four-camera YOLOv8 detection, tracking, and live display. Its principal workflow captures four CSI streams, converts and queues frames in GPU memory, batches them for TensorRT inference, tracks detections, then composites and displays the result. The graph follows the README’s documented pipeline; source excerpts were unavailable, so implementation details beyond the documented script and inference configuration are not inferred.

Main entry points: [`scripts/quadcam.sh`](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh) (TensorRT inference), [`config/config_infer_yolov8n.txt`](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/config/config_infer_yolov8n.txt) (Inference settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and batching"]
  node_capture["CSI capture<br/>[quadcam.sh]"]
  node_convert["UYVY conversion<br/>[quadcam.sh]"]
  node_queues["Bounded queues<br/>[quadcam.sh]"]
  node_mux["Stream batching<br/>[quadcam.sh]"]
end

subgraph group_inference["Inference"]
  node_infer["TensorRT inference<br/>[quadcam.sh]"]
  node_infer_config["Inference settings"]
  node_yolo_parser["YOLO bbox parser"]
end

subgraph group_display["Tracking and display"]
  node_tracker["NvDCF tracking<br/>[quadcam.sh]"]
  node_tiler["2×2 tiler<br/>[quadcam.sh]"]
  node_osd["Detection overlay<br/>[quadcam.sh]"]
  node_sink["3D display sink<br/>[quadcam.sh]"]
end

node_cameras(("Four CSI cameras"))
node_display(("Live display"))

node_cameras -->|"supply frames"| node_capture
node_capture -->|"outputs UYVY"| node_convert
node_convert -->|"outputs NV12"| node_queues
node_queues -->|"feed streams"| node_mux
node_mux -->|"batch frames"| node_infer
node_infer -->|"reads settings"| node_infer_config
node_infer -->|"parses detections"| node_yolo_parser
node_infer -->|"send detections"| node_tracker
node_tracker -->|"send tracked frames"| node_tiler
node_tiler -->|"send composite"| node_osd
node_osd -->|"send overlay"| node_sink
node_sink -->|"render frames"| node_display

click node_capture "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_convert "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_queues "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_mux "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_infer "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_infer_config "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/config/config_infer_yolov8n.txt"
click node_tracker "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_tiler "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_osd "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"
click node_sink "https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh"

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_capture,node_convert,node_queues,node_mux toneBlue
class node_infer,node_infer_config,node_yolo_parser toneAmber
class node_tracker,node_tiler,node_osd,node_sink toneMint
class node_cameras,node_display toneIndigo
```

## Components

### Capture and batching

- [CSI capture](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [UYVY conversion](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [Bounded queues](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [Stream batching](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`

### Inference

- [TensorRT inference](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [Inference settings](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/config/config_infer_yolov8n.txt): `config/config_infer_yolov8n.txt`
- **YOLO bbox parser**

### Tracking and display

- [NvDCF tracking](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [2×2 tiler](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [Detection overlay](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`
- [3D display sink](https://github.com/ak30072002/orin-quadcam-yolo/blob/main/scripts/quadcam.sh): `scripts/quadcam.sh`

### Other components

- **Four CSI cameras**
- **Live display**

## Connections

- Four CSI cameras → CSI capture: supply frames (evidence: `README.md`)
- CSI capture → UYVY conversion: outputs UYVY (evidence: `README.md`)
- UYVY conversion → Bounded queues: outputs NV12 (evidence: `README.md`)
- Bounded queues → Stream batching: feed streams (evidence: `README.md`)
- Stream batching → TensorRT inference: batch frames (evidence: `README.md`)
- TensorRT inference → Inference settings: reads settings (evidence: `README.md`)
- TensorRT inference → YOLO bbox parser: parses detections (evidence: `README.md`)
- TensorRT inference → NvDCF tracking: send detections (evidence: `README.md`)
- NvDCF tracking → 2×2 tiler: send tracked frames (evidence: `README.md`)
- 2×2 tiler → Detection overlay: send composite (evidence: `README.md`)
- Detection overlay → 3D display sink: send overlay (evidence: `README.md`)
- 3D display sink → Live display: render frames (evidence: `README.md`)
