# nawaf-rayhan585/yolo_projects architecture

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

## Overview

This repository is a collection of 19 independent computer-vision applications, not one shared runtime. Each project takes a camera, image, video, or (for Focus Guard) a screen capture and produces its own detections, alerts, analytics, or transformed output. The graph groups the standalone workflows by product domain; the scripts themselves combine input handling, vision processing, and presentation or logging. The README documents the collection-wide source convention and capabilities; sampled scripts confirm several individual workflows. Most scripts were not sampled, so their internal calls are not inferred.

Main entry points: [`parking-space-occupancy/define_parking_slots.py`](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/define_parking_slots.py) (Parking slot setup), [`parking-space-occupancy/parking_occupancy.py`](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/parking_occupancy.py) (Parking occupancy), [`restricted-zone-intrusion-alert/intrusion_alert.py`](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/restricted-zone-intrusion-alert/intrusion_alert.py) (Zone intrusion alerts), [`suspicious-behavior-detection/suspicious_behavior.py`](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/suspicious-behavior-detection/suspicious_behavior.py) (Suspicious behavior)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_safety["Surveillance &amp; Safety"]
  node_intrusion["Zone intrusion alerts<br/>[intrusion_alert.py]"]
  node_suspicious["Suspicious behavior"]
  node_fire["Fire and smoke<br/>[fire_detect.py]"]
  node_fall["Fall detection<br/>[fall_detector.py]"]
  node_ppe["PPE compliance<br/>[ppe_compliance.py]"]
  node_drowsiness["Drowsiness and yawn"]
  node_face["Face anonymization<br/>[face_anonymizer.py]"]
  node_rodent["Rodent detection<br/>[rat_detect.py]"]
end

subgraph group_analytics["Retail &amp; Crowd Analytics"]
  node_people["People counting<br/>[people_counter.py]"]
  node_heatmap["Crowd heatmap<br/>[crowd_heatmap.py]"]
  node_queue["Queue wait estimates<br/>[queue_estimator.py]"]
  node_parking["Parking occupancy"]
  node_slots["Parking slot setup"]
end

subgraph group_traffic["Traffic &amp; Vehicles"]
  node_vehicle["Vehicle tracking<br/>[vehicle_tracker.py]"]
  node_anpr["Plate recognition<br/>[anpr_inference.py]"]
end

subgraph group_hci["Productivity &amp; HCI"]
  node_focus["Focus distraction guard<br/>[focus_guard.py]"]
  node_hands["Hand type detection"]
  node_volume["Gesture volume control"]
end

subgraph group_vision["Document &amp; Vision Utilities"]
  node_scanner["Document scan and OCR"]
  node_background["Background removal"]
end

node_media(("Camera or media"))
node_screen(("Screen capture"))

node_media -->|"supplies footage"| node_intrusion
node_media -->|"supplies footage"| node_suspicious
node_media -->|"supplies footage"| node_fire
node_media -->|"supplies footage"| node_fall
node_media -->|"supplies footage"| node_ppe
node_media -->|"supplies footage"| node_drowsiness
node_media -->|"supplies footage"| node_face
node_media -->|"supplies footage"| node_rodent
node_media -->|"supplies footage"| node_people
node_media -->|"supplies footage"| node_heatmap
node_media -->|"supplies footage"| node_queue
node_media -->|"supplies footage"| node_parking
node_media -->|"supplies reference"| node_slots
node_slots -->|"saves slot polygons"| node_parking
node_media -->|"supplies footage"| node_vehicle
node_media -->|"supplies footage"| node_anpr
node_screen -->|"screenshots locally"| node_focus
node_media -->|"supplies footage"| node_hands
node_media -->|"supplies webcam"| node_volume
node_media -->|"supplies image"| node_scanner
node_media -->|"supplies footage"| node_background

click node_intrusion "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/restricted-zone-intrusion-alert/intrusion_alert.py"
click node_suspicious "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/suspicious-behavior-detection/suspicious_behavior.py"
click node_fire "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/fire-smoke-detection/fire_detect.py"
click node_fall "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/fall-detection/fall_detector.py"
click node_ppe "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/ppe-safety-compliance/ppe_compliance.py"
click node_drowsiness "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/drowsiness-yawn-detection/drowsiness_detector.py"
click node_face "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/face-blur-anonymizer/face_anonymizer.py"
click node_rodent "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/rat-rodent-detection/rat_detect.py"
click node_people "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/people-counter-in-out/people_counter.py"
click node_heatmap "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/crowd-heatmap/crowd_heatmap.py"
click node_queue "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/queue-wait-time-estimator/queue_estimator.py"
click node_parking "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/parking_occupancy.py"
click node_slots "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/define_parking_slots.py"
click node_vehicle "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/vehicle-detection-tracking/vehicle_tracker.py"
click node_anpr "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/license-plate-recognition/anpr_inference.py"
click node_focus "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/focus-guard-distraction-detector/focus_guard.py"
click node_hands "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/hand-type-detector/hand_type_detector.py"
click node_volume "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/hand-gesture-volume-control/gesture_volume_control.py"
click node_scanner "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/document-scanner-ocr/document_scanner.py"
click node_background "https://github.com/nawaf-rayhan585/yolo_projects/blob/main/instance-segmentation-bg-removal/background_removal.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_intrusion,node_suspicious,node_fire,node_fall,node_ppe,node_drowsiness,node_face,node_rodent,node_screen toneBlue
class node_people,node_heatmap,node_queue,node_parking,node_slots toneAmber
class node_vehicle,node_anpr toneMint
class node_focus,node_hands,node_volume toneRose
class node_scanner,node_background,node_media toneIndigo
```

## Components

### Surveillance & Safety

- [Zone intrusion alerts](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/restricted-zone-intrusion-alert/intrusion_alert.py): `restricted-zone-intrusion-alert/intrusion_alert.py`
- [Suspicious behavior](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/suspicious-behavior-detection/suspicious_behavior.py): `suspicious-behavior-detection/suspicious_behavior.py`
- [Fire and smoke](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/fire-smoke-detection/fire_detect.py): `fire-smoke-detection/fire_detect.py`
- [Fall detection](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/fall-detection/fall_detector.py): `fall-detection/fall_detector.py`
- [PPE compliance](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/ppe-safety-compliance/ppe_compliance.py): `ppe-safety-compliance/ppe_compliance.py`
- [Drowsiness and yawn](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/drowsiness-yawn-detection/drowsiness_detector.py): `drowsiness-yawn-detection/drowsiness_detector.py`
- [Face anonymization](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/face-blur-anonymizer/face_anonymizer.py): `face-blur-anonymizer/face_anonymizer.py`
- [Rodent detection](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/rat-rodent-detection/rat_detect.py): `rat-rodent-detection/rat_detect.py`

### Retail & Crowd Analytics

- [People counting](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/people-counter-in-out/people_counter.py): `people-counter-in-out/people_counter.py`
- [Crowd heatmap](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/crowd-heatmap/crowd_heatmap.py): `crowd-heatmap/crowd_heatmap.py`
- [Queue wait estimates](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/queue-wait-time-estimator/queue_estimator.py): `queue-wait-time-estimator/queue_estimator.py`
- [Parking occupancy](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/parking_occupancy.py): `parking-space-occupancy/parking_occupancy.py`
- [Parking slot setup](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/parking-space-occupancy/define_parking_slots.py): `parking-space-occupancy/define_parking_slots.py`

### Traffic & Vehicles

- [Vehicle tracking](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/vehicle-detection-tracking/vehicle_tracker.py): `vehicle-detection-tracking/vehicle_tracker.py`
- [Plate recognition](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/license-plate-recognition/anpr_inference.py): `license-plate-recognition/anpr_inference.py`

### Productivity & HCI

- [Focus distraction guard](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/focus-guard-distraction-detector/focus_guard.py): `focus-guard-distraction-detector/focus_guard.py`
- [Hand type detection](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/hand-type-detector/hand_type_detector.py): `hand-type-detector/hand_type_detector.py`
- [Gesture volume control](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/hand-gesture-volume-control/gesture_volume_control.py): `hand-gesture-volume-control/gesture_volume_control.py`

### Document & Vision Utilities

- [Document scan and OCR](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/document-scanner-ocr/document_scanner.py): `document-scanner-ocr/document_scanner.py`
- [Background removal](https://github.com/nawaf-rayhan585/yolo_projects/blob/main/instance-segmentation-bg-removal/background_removal.py): `instance-segmentation-bg-removal/background_removal.py`

### Other components

- **Camera or media**
- **Screen capture**

## Connections

- Camera or media → Zone intrusion alerts: supplies footage (evidence: `README.md`)
- Camera or media → Suspicious behavior: supplies footage (evidence: `README.md`)
- Camera or media → Fire and smoke: supplies footage (evidence: `README.md`)
- Camera or media → Fall detection: supplies footage (evidence: `README.md`)
- Camera or media → PPE compliance: supplies footage (evidence: `README.md`)
- Camera or media → Drowsiness and yawn: supplies footage (evidence: `README.md`)
- Camera or media → Face anonymization: supplies footage (evidence: `README.md`)
- Camera or media → Rodent detection: supplies footage (evidence: `README.md`)
- Camera or media → People counting: supplies footage (evidence: `README.md`)
- Camera or media → Crowd heatmap: supplies footage (evidence: `README.md`)
- Camera or media → Queue wait estimates: supplies footage (evidence: `README.md`)
- Camera or media → Parking occupancy: supplies footage (evidence: `README.md`)
- Camera or media → Parking slot setup: supplies reference (evidence: `README.md`)
- Parking slot setup → Parking occupancy: saves slot polygons (evidence: `parking-space-occupancy/define_parking_slots.py`)
- Camera or media → Vehicle tracking: supplies footage (evidence: `README.md`)
- Camera or media → Plate recognition: supplies footage (evidence: `license-plate-recognition/anpr_inference.py`)
- Screen capture → Focus distraction guard: screenshots locally (evidence: `focus-guard-distraction-detector/focus_guard.py`)
- Camera or media → Hand type detection: supplies footage (evidence: `README.md`)
- Camera or media → Gesture volume control: supplies webcam (evidence: `hand-gesture-volume-control/gesture_volume_control.py`)
- Camera or media → Document scan and OCR: supplies image (evidence: `document-scanner-ocr/document_scanner.py`)
- Camera or media → Background removal: supplies footage (evidence: `README.md`)
