How ayus0-01/alert-drive works
This is a webcam-based driver drowsiness monitor. Its demonstrated runtime captures frames, detects face landmarks, computes eye aspect ratios (EAR), and displays the measurements; the tree also contains a detector, calibration/threshold utilities, and alert outputs. The sampled main loop does not invoke those additional subsystems, so their connections are omitted rather than inferred. Calibration and alert behavior are supported by their own source excerpts.
Main entry points: ear.py EAR calculation · main.py Webcam capture · detector.py Closure state detector · controlled_calibration.py Controlled calibration
Components 14
Live monitoring
- Webcam capture
main.py - Face landmarks
main.py - EAR calculation
utils/ear.py - Video display
main.py
Calibration
- Controlled calibration
utils/controlled_calibration.py - Open-eye calibration
utils/ear_calibration.py - Calibration data
config/calibration.json
Drowsiness detection
- Threshold calculation
drowsiness/thresholds.py - Closure state detector
drowsiness/detector.py
Alert outputs
- State alert controller
hardware/controller.py - Beep demo alert
hardware/demo_alert.py
Other components
- Driver
- MediaPipe
- OpenCV
Connections 18
- Driver → Webcam capture: provides video
main.py - Webcam capture → Face landmarks: passes frames
main.py - MediaPipe → Face landmarks: detects landmarks
main.py - Face landmarks → EAR calculation: supplies eye points
main.py - EAR calculation → Video display: returns EAR
main.py - Webcam capture → Video display: supplies frames
main.py - OpenCV → Webcam capture: captures frames
main.py - OpenCV → Video display: renders video
main.py - Driver → Controlled calibration: performs calibration
utils/controlled_calibration.py - Controlled calibration → EAR calculation: calculates EAR
utils/controlled_calibration.py - Controlled calibration → Calibration data: writes statistics
utils/controlled_calibration.py - Driver → Open-eye calibration: performs calibration
utils/ear_calibration.py - Open-eye calibration → EAR calculation: calculates EAR
utils/ear_calibration.py - Calibration data → Threshold calculation: provides calibration
drowsiness/thresholds.py - Threshold calculation → Closure state detector: supplies threshold
- EAR calculation → Closure state detector: supplies eye ratios
- Closure state detector → State alert controller: produces state
- Closure state detector → Beep demo alert: produces state