🔍 Enhanced Face Analysis Tool

🚀 A comprehensive face analysis tool with AI-powered features

Built with OpenCV and Python for advanced computer vision applications

---

✨ Features

🎯 Core Detection Face Detection - Real-time face detection in images/video Age & Gender Prediction - AI-powered demographic analysis Emotion Recognition - Happy/neutral emotion detection Smile Analysis - Intensity classification (Slight/Moderate/Broad)	🎨 Advanced Analysis Head Pose Estimation - Direction and tilt analysis Face Shape Classification - Oval, round, square detection Glasses Detection - Automated eyewear identification Facial Symmetry - Percentage-based symmetry scoring
🛠️ Processing Tools Image Filters - Sepia, B&W, Cartoon effects Face Tracking - Video trajectory visualization Orientation Correction - Auto-alignment features Privacy Blurring - Face anonymization	📊 Utilities Batch Processing - Multiple image handling Face Measurements - Dimensional analysis GUI Interface - User-friendly Tkinter interface CLI Support - Full command-line functionality

---

📁 Project Structure

FACE_DETECTION_PROJECT/
├── 📂 data/                    # Haarcascade XML files
├── 📂 models/                  # Trained/saved AI models
├── 📂 samples/                 # Sample images/videos
├── 📂 src/                     # Python source code
│   ├── 🐍 face_detection.py
│   ├── 🐍 simplified_face_detection.py
│   ├── 🐍 enhanced_face_detection.py
│   ├── 🐍 enhanced_face_detection_emotion.py
│   └── 🐍 face_analyzer.py    # Main application
├── 🐍 get_xml_files.py
├── 📋 requirements.txt
├── 📖 README.md
└── 🚫 .gitignore

---

🚀 Quick Start

Prerequisites

Installation

1. Clone the repository

   git clone https://github.com/yourusername/face-analysis-tool.git
   cd face-analysis-tool

2. Install dependencies

   pip install opencv-python numpy pillow

3. Optional GUI dependencies (Ubuntu/Debian)

   sudo apt-get install python3-tk

---

💻 Usage Guide

🖥️ GUI Mode (Recommended)

python src/face_analyzer.py --mode gui

Features:

• 🖱️ Point-and-click interface
• 📂 Easy file loading
• 🎥 Webcam integration
• ⚙️ Real-time settings adjustment
• 💾 One-click save functionality

📷 Image Processing

python src/face_analyzer.py --mode image --input <image_path> [options]

Example:

python src/face_analyzer.py --mode image \
  --input samples/portrait.jpg \
  --output samples/analyzed_portrait.jpg \
  --filter cartoon --recognize --orient

🎥 Video Processing

python src/face_analyzer.py --mode video [options]

Example:

python src/face_analyzer.py --mode video --blur --track

💡 Tip: Press q in the video window to quit

📁 Batch Processing

python src/face_analyzer.py --mode batch \
  --input <input_directory> \
  --output <output_directory> [options]

Example:

python src/face_analyzer.py --mode batch \
  --input samples/ \
  --output processed_batch/ \
  --filter sepia --blur

---

⚙️ Configuration Options

🔧 Command Line Arguments

Option	Values	Description
--mode	gui, image, video, batch	Processing mode
--input	<path>	Input file/directory path
--output	<path>	Output file/directory path
--video_source	<index>	Webcam index (default: 0)
--filter	none, sepia, bw, cartoon	Image filter type
--blur	-	Enable face blurring
--recognize	-	Enable face recognition
--track	-	Enable face tracking
--orient	-	Auto-correct orientation
--data-dir	<path>	Custom Haar cascade path
--models-dir	<path>	Custom models directory

---

🛠️ Troubleshooting

🚨 Common Issues & Solutions

GUI Not Available

⚠️ Warning: Tkinter/Pillow not found

Solution: Install GUI dependencies or use CLI modes

pip install pillow
# Ubuntu/Debian:
sudo apt-get install python3-tk

Missing Cascade Files

❌ Error: Cascade/Model not found

Solution: Verify file paths or use custom directories

python src/face_analyzer.py --data-dir /custom/path --models-dir /model/path

Webcam Issues

❌ Error: Cannot access camera

Solutions:

• Check camera connections and drivers
• Try different video source index: --video_source 1
• Verify camera permissions

Slow Performance

⏳ Slow tracking performance

Solutions:

• Switch to KCF tracker (modify code)
• Reduce video resolution
• Close unnecessary applications

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and test thoroughly
4. Submit a pull request with detailed description

---

📊 Performance & Compatibility

Platform	Status	Python Versions
🪟 Windows	✅ Fully Supported	3.7+
🐧 Linux	✅ Fully Supported	3.7+
🍎 macOS	✅ Fully Supported	3.7+

---

📄 License

This project is provided for educational purposes only. Please respect privacy and ethical guidelines when using face analysis technology.

---

⭐ If you found this project helpful, please give it a star! ⭐

🏠 Home • 📋 Features • 💿 Install • 📖 Docs • 🤝 Contribute

_{Built with ❤️ for the computer vision community}