feat: update Python processors and add utility scripts
- Update ASR, face, OCR, pose processors - Add release pre-flight check script - Add synonym generation, chunk processing scripts - Add face recognition, stamp search utilities
This commit is contained in:
Warren
435
scripts/face_processor_mps.py
Normal file
435
scripts/face_processor_mps.py
Normal file
@@ -0,0 +1,435 @@
|
||||
#!/opt/homebrew/bin/python3.11
|
||||
"""
|
||||
Face Processor - Apple MPS Optimized Version
|
||||
Uses MediaPipe with Metal GPU acceleration for face detection
|
||||
Falls back to OpenCV Haar Cascade if MediaPipe not available
|
||||
|
||||
Features:
|
||||
- MediaPipe Face Detection with Metal GPU acceleration
|
||||
- OpenCV Haar Cascade fallback
|
||||
- Apple MPS support for image processing
|
||||
- Memory-optimized for unified memory architecture
|
||||
"""
|
||||
|
||||
import sys
|
||||
import json
|
||||
import argparse
|
||||
import os
|
||||
import signal
|
||||
import time
|
||||
from datetime import datetime
|
||||
from typing import Dict, List, Optional, Tuple
|
||||
|
||||
import cv2
|
||||
import numpy as np
|
||||
import torch
|
||||
|
||||
|
||||
MEDIAPIPE_AVAILABLE = False
|
||||
try:
|
||||
import mediapipe as mp
|
||||
from mediapipe.tasks import python
|
||||
from mediapipe.tasks.python import vision
|
||||
|
||||
MEDIAPIPE_AVAILABLE = True
|
||||
except ImportError:
|
||||
print("[Face] MediaPipe not available, will use OpenCV fallback")
|
||||
|
||||
|
||||
# MediaPipe face detection solution
|
||||
class MediaPipeFaceDetector:
|
||||
"""MediaPipe Face Detection with GPU support"""
|
||||
|
||||
def __init__(self, device: str = "auto", min_confidence: float = 0.5):
|
||||
self.device = device
|
||||
self.min_confidence = min_confidence
|
||||
|
||||
if not MEDIAPIPE_AVAILABLE:
|
||||
raise RuntimeError("MediaPipe not available")
|
||||
|
||||
# Download model if needed
|
||||
model_path = self._download_model()
|
||||
|
||||
# Configure for GPU acceleration on Apple Silicon
|
||||
base_options = python.BaseOptions(model_asset_path=model_path)
|
||||
|
||||
# Try to enable GPU acceleration
|
||||
running_mode = vision.RunningMode.IMAGE
|
||||
|
||||
# ✅ Fixed: Use correct parameter names for MediaPipe v0.10.33
|
||||
options = vision.FaceDetectorOptions(
|
||||
base_options=base_options,
|
||||
running_mode=running_mode,
|
||||
min_detection_confidence=min_confidence, # ✅ Correct name
|
||||
min_suppression_threshold=0.3, # ✅ Correct name
|
||||
)
|
||||
|
||||
self.detector = vision.FaceDetector.create_from_options(options)
|
||||
|
||||
# Enable MPS for image preprocessing if available
|
||||
self.use_mps = device == "mps" or (
|
||||
device == "auto" and torch.backends.mps.is_available()
|
||||
)
|
||||
|
||||
print(f"[Face] MediaPipe initialized with MPS: {self.use_mps}")
|
||||
|
||||
def _download_model(self) -> str:
|
||||
"""Download MediaPipe face detection model if needed"""
|
||||
import urllib.request
|
||||
|
||||
model_name = "blaze_face_short_range.tflite"
|
||||
model_dir = os.path.expanduser("~/.mediapipe/models")
|
||||
model_path = os.path.join(model_dir, model_name)
|
||||
|
||||
if not os.path.exists(model_path):
|
||||
print(f"[Face] Downloading MediaPipe model: {model_name}")
|
||||
os.makedirs(model_dir, exist_ok=True)
|
||||
|
||||
# MediaPipe official model URL (correct path)
|
||||
model_urls = [
|
||||
"https://storage.googleapis.com/mediapipe-models/face_detector/blaze_face_short_range/float16/1/blaze_face_short_range.tflite",
|
||||
"https://storage.googleapis.com/mediapipe-models/face_detector/blaze_face_short_range/float32/1/blaze_face_short_range.tflite",
|
||||
]
|
||||
|
||||
for model_url in model_urls:
|
||||
try:
|
||||
print(f"[Face] Trying URL: {model_url}")
|
||||
urllib.request.urlretrieve(model_url, model_path)
|
||||
print(f"[Face] Model downloaded to: {model_path}")
|
||||
return model_path
|
||||
except Exception as e:
|
||||
print(f"[Face] Failed: {e}")
|
||||
continue
|
||||
|
||||
# All URLs failed, check if model exists in package
|
||||
mp_dir = os.path.dirname(mp.__file__)
|
||||
alt_path = os.path.join(mp_dir, "models", model_name)
|
||||
if os.path.exists(alt_path):
|
||||
print(f"[Face] Using fallback model: {alt_path}")
|
||||
return alt_path
|
||||
|
||||
raise RuntimeError(f"Could not download MediaPipe model from any source")
|
||||
|
||||
return model_path
|
||||
|
||||
def detect(self, frame: np.ndarray) -> List[Dict]:
|
||||
"""Detect faces in a frame"""
|
||||
# Convert frame to MediaPipe Image
|
||||
frame_rgb = cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)
|
||||
mp_image = mp.Image(image_format=mp.ImageFormat.SRGB, data=frame_rgb)
|
||||
|
||||
# Run detection
|
||||
detection_result = self.detector.detect(mp_image)
|
||||
|
||||
# Convert results
|
||||
faces = []
|
||||
height, width = frame.shape[:2]
|
||||
|
||||
for detection in detection_result.detections:
|
||||
bbox = detection.bounding_box
|
||||
origin_x = bbox.origin_x
|
||||
origin_y = bbox.origin_y
|
||||
w = bbox.width
|
||||
h = bbox.height
|
||||
|
||||
# Calculate confidence
|
||||
categories = detection.categories
|
||||
score = categories[0].score if categories else 0.5
|
||||
|
||||
faces.append(
|
||||
{
|
||||
"x": int(origin_x),
|
||||
"y": int(origin_y),
|
||||
"width": int(w),
|
||||
"height": int(h),
|
||||
"confidence": float(score),
|
||||
}
|
||||
)
|
||||
|
||||
return faces
|
||||
|
||||
|
||||
# OpenCV Haar Cascade fallback
|
||||
class OpenCVFaceDetector:
|
||||
"""OpenCV Haar Cascade Face Detection"""
|
||||
|
||||
def __init__(self, min_confidence: float = 0.5):
|
||||
self.min_confidence = min_confidence
|
||||
|
||||
# Load Haar Cascade
|
||||
cascade_path = cv2.data.haarcascades + "haarcascade_frontalface_default.xml"
|
||||
self.face_cascade = cv2.CascadeClassifier(cascade_path)
|
||||
|
||||
if self.face_cascade.empty():
|
||||
raise RuntimeError("Failed to load Haar Cascade")
|
||||
|
||||
print("[Face] OpenCV Haar Cascade initialized")
|
||||
|
||||
def detect(self, frame: np.ndarray) -> List[Dict]:
|
||||
"""Detect faces using Haar Cascade"""
|
||||
gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
|
||||
gray = cv2.equalizeHist(gray)
|
||||
|
||||
# Detect faces
|
||||
faces = self.face_cascade.detectMultiScale(
|
||||
gray,
|
||||
scaleFactor=1.1,
|
||||
minNeighbors=5,
|
||||
minSize=(30, 30),
|
||||
)
|
||||
|
||||
results = []
|
||||
for x, y, w, h in faces:
|
||||
results.append(
|
||||
{
|
||||
"x": int(x),
|
||||
"y": int(y),
|
||||
"width": int(w),
|
||||
"height": int(h),
|
||||
"confidence": 0.7, # Haar Cascade doesn't provide confidence
|
||||
}
|
||||
)
|
||||
|
||||
return results
|
||||
|
||||
|
||||
def get_device() -> str:
|
||||
"""Determine the best available device for processing"""
|
||||
if torch.backends.mps.is_available():
|
||||
return "mps"
|
||||
elif torch.cuda.is_available():
|
||||
return "cuda"
|
||||
else:
|
||||
return "cpu"
|
||||
|
||||
|
||||
def signal_handler(signum, frame):
|
||||
"""Handle interrupt signals gracefully"""
|
||||
print(f"\n[Face] Received signal {signum}, saving results and exiting...")
|
||||
sys.exit(0)
|
||||
|
||||
|
||||
def process_video_face(
|
||||
video_path: str,
|
||||
output_path: str,
|
||||
use_mediapipe: bool = True,
|
||||
min_confidence: float = 0.5,
|
||||
device: str = "auto",
|
||||
sample_interval: int = 30,
|
||||
resume: bool = True,
|
||||
save_interval: int = 30,
|
||||
) -> Dict:
|
||||
"""
|
||||
Process video for face detection with MPS acceleration
|
||||
|
||||
Args:
|
||||
video_path: Path to input video file
|
||||
output_path: Path to output JSON file
|
||||
use_mediapipe: Whether to use MediaPipe (faster, more accurate)
|
||||
min_confidence: Minimum confidence threshold
|
||||
device: Device to use ('auto', 'mps', 'cuda', 'cpu')
|
||||
sample_interval: Process every N frames
|
||||
resume: Whether to resume from existing results
|
||||
save_interval: Auto-save interval in seconds
|
||||
|
||||
Returns:
|
||||
Dictionary with face detection results and metadata
|
||||
"""
|
||||
# Set up signal handlers
|
||||
signal.signal(signal.SIGTERM, signal_handler)
|
||||
signal.signal(signal.SIGINT, signal_handler)
|
||||
|
||||
# Determine device
|
||||
if device == "auto":
|
||||
device = get_device()
|
||||
|
||||
print(f"[Face] Starting face detection with device: {device}")
|
||||
print(f"[Face] Use MediaPipe: {use_mediapipe}, Confidence: {min_confidence}")
|
||||
|
||||
# Initialize detector
|
||||
detector = None
|
||||
|
||||
if use_mediapipe and MEDIAPIPE_AVAILABLE:
|
||||
try:
|
||||
detector = MediaPipeFaceDetector(
|
||||
device=device, min_confidence=min_confidence
|
||||
)
|
||||
detector_name = "MediaPipe"
|
||||
except Exception as e:
|
||||
print(f"[Face] MediaPipe failed: {e}, falling back to OpenCV")
|
||||
detector = OpenCVFaceDetector(min_confidence=min_confidence)
|
||||
detector_name = "OpenCV"
|
||||
else:
|
||||
detector = OpenCVFaceDetector(min_confidence=min_confidence)
|
||||
detector_name = "OpenCV"
|
||||
|
||||
print(f"[Face] Using detector: {detector_name}")
|
||||
|
||||
# Get video info
|
||||
cap = cv2.VideoCapture(video_path)
|
||||
fps = cap.get(cv2.CAP_PROP_FPS)
|
||||
width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
|
||||
height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
|
||||
total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
|
||||
cap.release()
|
||||
|
||||
print(f"[Face] Video: {width}x{height} @ {fps:.2f} FPS, {total_frames} frames")
|
||||
|
||||
# Load existing data if resuming
|
||||
existing_data = None
|
||||
last_processed_frame = 0
|
||||
|
||||
if resume and os.path.exists(output_path):
|
||||
try:
|
||||
with open(output_path, "r") as f:
|
||||
existing_data = json.load(f)
|
||||
frames = existing_data.get("frames", {})
|
||||
if frames:
|
||||
last_processed_frame = max(int(k) for k in frames.keys())
|
||||
print(f"[Face] Resuming from frame {last_processed_frame}")
|
||||
except (json.JSONDecodeError, KeyError):
|
||||
pass
|
||||
|
||||
# Initialize result structure
|
||||
result = {
|
||||
"video_path": video_path,
|
||||
"detector": detector_name,
|
||||
"device": device,
|
||||
"min_confidence": min_confidence,
|
||||
"processed_at": datetime.now().isoformat(),
|
||||
"frames": {},
|
||||
}
|
||||
|
||||
if existing_data:
|
||||
result["frames"] = existing_data.get("frames", {})
|
||||
|
||||
# Process video
|
||||
print(f"[Face] Processing video: {video_path}")
|
||||
start_time = time.time()
|
||||
|
||||
frame_count = 0
|
||||
detection_count = 0
|
||||
last_save_time = start_time
|
||||
|
||||
cap = cv2.VideoCapture(video_path)
|
||||
|
||||
try:
|
||||
while True:
|
||||
ret, frame = cap.read()
|
||||
if not ret:
|
||||
break
|
||||
|
||||
frame_count += 1
|
||||
|
||||
# Sample frames
|
||||
if frame_count % sample_interval != 0:
|
||||
continue
|
||||
|
||||
# Skip already processed frames
|
||||
if frame_count <= last_processed_frame:
|
||||
continue
|
||||
|
||||
timestamp = (frame_count - 1) / fps if fps > 0 else 0
|
||||
|
||||
# Detect faces
|
||||
try:
|
||||
faces = detector.detect(frame)
|
||||
except Exception as e:
|
||||
print(f"[Face] Error at frame {frame_count}: {e}")
|
||||
faces = []
|
||||
|
||||
if faces:
|
||||
result["frames"][str(frame_count)] = {
|
||||
"timestamp": timestamp,
|
||||
"faces": faces,
|
||||
}
|
||||
detection_count += len(faces)
|
||||
|
||||
# Progress reporting
|
||||
if frame_count % 100 == 0:
|
||||
elapsed = time.time() - start_time
|
||||
fps_rate = frame_count / elapsed if elapsed > 0 else 0
|
||||
print(
|
||||
f"[Face] Processed {frame_count} frames, {detection_count} faces, {fps_rate:.1f} FPS"
|
||||
)
|
||||
|
||||
# Periodic save
|
||||
if save_interval > 0 and time.time() - last_save_time > save_interval:
|
||||
with open(output_path, "w") as f:
|
||||
json.dump(result, f, indent=2)
|
||||
last_save_time = time.time()
|
||||
print(f"[Face] Auto-saved at frame {frame_count}")
|
||||
|
||||
except Exception as e:
|
||||
print(f"[Face] Error during processing: {e}")
|
||||
raise
|
||||
finally:
|
||||
cap.release()
|
||||
|
||||
# Final save
|
||||
elapsed_time = time.time() - start_time
|
||||
avg_fps = frame_count / elapsed_time if elapsed_time > 0 else 0
|
||||
|
||||
result["summary"] = {
|
||||
"total_frames": frame_count,
|
||||
"total_detections": detection_count,
|
||||
"processing_time": round(elapsed_time, 2),
|
||||
"average_fps": round(avg_fps, 2),
|
||||
"detector": detector_name,
|
||||
"device": device,
|
||||
}
|
||||
|
||||
# Save final results
|
||||
with open(output_path, "w") as f:
|
||||
json.dump(result, f, indent=2)
|
||||
|
||||
print(
|
||||
f"[Face] Completed: {frame_count} frames, {detection_count} faces in {elapsed_time:.1f}s ({avg_fps:.1f} FPS)"
|
||||
)
|
||||
print(f"[Face] Results saved to: {output_path}")
|
||||
|
||||
return result
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="Face Processor with MPS Support")
|
||||
parser.add_argument("--video", required=True, help="Input video path")
|
||||
parser.add_argument("--output", required=True, help="Output JSON path")
|
||||
parser.add_argument(
|
||||
"--no-mediapipe", action="store_true", help="Use OpenCV instead of MediaPipe"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--confidence", type=float, default=0.5, help="Minimum confidence threshold"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--device",
|
||||
default="auto",
|
||||
choices=["auto", "mps", "cuda", "cpu"],
|
||||
help="Device to use",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--sample-interval", type=int, default=30, help="Process every N frames"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--no-resume", action="store_true", help="Do not resume from existing results"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--save-interval", type=int, default=30, help="Auto-save interval in seconds"
|
||||
)
|
||||
|
||||
args = parser.parse_args()
|
||||
|
||||
process_video_face(
|
||||
video_path=args.video,
|
||||
output_path=args.output,
|
||||
use_mediapipe=not args.no_mediapipe,
|
||||
min_confidence=args.confidence,
|
||||
device=args.device,
|
||||
sample_interval=args.sample_interval,
|
||||
resume=not args.no_resume,
|
||||
save_interval=args.save_interval,
|
||||
)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user