kinemotion 0.35.0__tar.gz → 0.35.1__tar.gz

{kinemotion-0.35.0 → kinemotion-0.35.1}/.basic-memory/development/unused-code-identification-and-decorator-application-december-2025.md

@@ -1,7 +1,7 @@
 ---
 title: Unused Code Identification and Decorator Application - December 2025
 type: report
-permalink: development/unused-code-analysis-december-2025
+permalink: development/unused-code-analysis-december-2025-1
 tags:
 - code-quality
 - maintenance

{kinemotion-0.35.0 → kinemotion-0.35.1}/.claude/settings.local.json

@@ -2,69 +2,69 @@
   "includeCoAuthoredBy": false,
   "permissions": {
     "allow": [
-      "Bash(ffprobe:*)",
-      "Bash(uv run pytest:*)",
-      "Bash(uv run dropjump-analyze:*)",
-      "Bash(uv run mypy:*)",
-      "Bash(uv run ruff:*)",
-      "Bash(uv sync:*)",
-      "mcp__web-search__freebird_fetch",
-      "mcp__web-search__freebird_search",
+      "Bash(cat:*)",
+      "Bash(chmod:*)",
       "Bash(curl:*)",
-      "mcp__sequential__sequentialthinking",
-      "mcp__context7__resolve-library-id",
-      "mcp__context7__get-library-docs",
-      "mcp__sequential-thinking__sequentialthinking",
-      "Bash(uv run kinemotion dropjump-analyze:*)",
-      "mcp__exa__get_code_context_exa",
-      "mcp__ref__ref_search_documentation",
-      "mcp__exa__web_search_exa",
-      "mcp__ref__ref_read_url",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:sonarcloud.io)",
+      "Bash(ffprobe:*)",
+      "Bash(find:*)",
+      "Bash(gh run view:*)",
       "Bash(mkdir:*)",
-      "Bash(uv run kinemotion cmj-analyze:*)",
-      "Bash(cat:*)",
       "Bash(python3:*)",
+      "Bash(uv run dropjump-analyze:*)",
+      "Bash(uv run kinemotion cmj-analyze:*)",
+      "Bash(uv run kinemotion dropjump-analyze:*)",
       "Bash(uv run pyright:*)",
-      "Bash(gh run view:*)",
-      "WebFetch(domain:www.sonarsource.com)",
-      "WebFetch(domain:docs.sonarsource.com)",
-      "WebFetch(domain:www.pyopensci.org)",
-      "WebFetch(domain:realpython.com)",
-      "WebFetch(domain:pypi.org)",
+      "Bash(uv run pytest:*)",
+      "Bash(uv run ruff:*)",
+      "Bash(uv sync:*)",
       "Bash(wget:*)",
-      "Bash(chmod:*)",
-      "Bash(find:*)",
-      "mcp__basic-memory__write_note",
-      "mcp__serena__list_memories",
-      "mcp__basic-memory__list_memory_projects",
-      "mcp__basic-memory__search_notes",
-      "mcp__serena__get_symbols_overview",
       "mcp__basic-memory__build_context",
-      "mcp__basic-memory__read_note",
+      "mcp__basic-memory__edit_note",
       "mcp__basic-memory__list_directory",
+      "mcp__basic-memory__list_memory_projects",
+      "mcp__basic-memory__read_note",
+      "mcp__basic-memory__search_notes",
       "mcp__basic-memory__view_note",
+      "mcp__basic-memory__write_note",
+      "mcp__code-reasoning__code-reasoning",
+      "mcp__context7__get-library-docs",
+      "mcp__context7__resolve-library-id",
+      "mcp__exa__get_code_context_exa",
+      "mcp__exa__web_search_exa",
+      "mcp__github-project-manager__list_issues",
+      "mcp__github-project-manager__list_milestones",
+      "mcp__github-project-manager__list_projects",
+      "mcp__ref__ref_read_url",
+      "mcp__ref__ref_search_documentation",
+      "mcp__sequential__sequentialthinking",
+      "mcp__sequential-thinking__process_thought",
+      "mcp__sequential-thinking__sequentialthinking",
+      "mcp__serena__check_onboarding_performed",
+      "mcp__serena__edit_memory",
       "mcp__serena__find_file",
+      "mcp__serena__find_referencing_symbols",
       "mcp__serena__find_symbol",
-      "mcp__serena__list_dir",
-      "mcp__serena__think_about_task_adherence",
+      "mcp__serena__get_symbols_overview",
       "mcp__serena__initial_instructions",
-      "mcp__serena__check_onboarding_performed",
-      "mcp__serena__search_for_pattern",
-      "mcp__github-project-manager__list_projects",
-      "mcp__github-project-manager__list_milestones",
-      "mcp__github-project-manager__list_issues",
-      "mcp__serena__insert_before_symbol",
-      "mcp__serena__replace_symbol_body",
       "mcp__serena__insert_after_symbol",
+      "mcp__serena__insert_before_symbol",
+      "mcp__serena__list_dir",
+      "mcp__serena__list_memories",
       "mcp__serena__read_memory",
+      "mcp__serena__replace_symbol_body",
+      "mcp__serena__search_for_pattern",
+      "mcp__serena__think_about_task_adherence",
       "mcp__serena__write_memory",
-      "mcp__serena__edit_memory",
-      "mcp__basic-memory__edit_note",
-      "mcp__code-reasoning__code-reasoning",
-      "mcp__sequential-thinking__process_thought",
-      "mcp__serena__find_referencing_symbols"
+      "mcp__web-search__freebird_fetch",
+      "mcp__web-search__freebird_search",
+      "WebFetch(domain:docs.sonarsource.com)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:pypi.org)",
+      "WebFetch(domain:realpython.com)",
+      "WebFetch(domain:sonarcloud.io)",
+      "WebFetch(domain:www.pyopensci.org)",
+      "WebFetch(domain:www.sonarsource.com)",
+      "Bash(ffmpeg:*)"
     ]
   },
   "enableAllProjectMcpServers": true,

{kinemotion-0.35.0 → kinemotion-0.35.1}/.cursor/mcp.json

@@ -4,7 +4,7 @@
       "command": "direnv",
       "args": [
         "exec",
-        "/Users/feniix/src/personal/cursor/dropjump-claude",
+        "/Users/feniix/src/personal/cursor/kinemotion",
         "bunx", "-y", "exa-mcp-server"
       ]
     },
@@ -12,7 +12,7 @@
       "command": "direnv",
       "args": [
         "exec",
-        "/Users/feniix/src/personal/cursor/dropjump-claude",
+        "/Users/feniix/src/personal/cursor/kinemotion",
         "bunx", "-y", "ref-tools-mcp@latest"
       ]
     },
@@ -44,7 +44,7 @@
         "--context",
         "ide-assistant",
         "--project",
-        "/Users/feniix/src/personal/cursor/dropjump-claude"
+        "/Users/feniix/src/personal/cursor/kinemotion"
       ]
     },
     "code-reasoning": {

{kinemotion-0.35.0 → kinemotion-0.35.1}/.mcp.json

@@ -4,7 +4,7 @@
       "command": "direnv",
       "args": [
         "exec",
-        "/Users/feniix/src/personal/cursor/dropjump-claude",
+        "/Users/feniix/src/personal/cursor/kinemotion",
         "bunx", "-y", "exa-mcp-server"
       ]
     },
@@ -12,7 +12,7 @@
       "command": "direnv",
       "args": [
         "exec",
-        "/Users/feniix/src/personal/cursor/dropjump-claude",
+        "/Users/feniix/src/personal/cursor/kinemotion",
         "bunx", "-y", "ref-tools-mcp@latest"
       ]
     },
@@ -58,7 +58,7 @@
         "--context",
         "ide-assistant",
         "--project",
-        "/Users/feniix/src/personal/cursor/dropjump-claude"
+        "/Users/feniix/src/personal/cursor/kinemotion"
       ]
     }
   }

{kinemotion-0.35.0 → kinemotion-0.35.1}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.35.1 (2025-12-07)
+
+### Bug Fixes
+
+- **detection**: Improve event detection accuracy through empirical validation
+  ([`f9f6c91`](https://github.com/feniix/kinemotion/commit/f9f6c917904bfcb95ef9bd988867a2b824cc59c8))
+
+### Chores
+
+- Change settings and update basic memory
+  ([`41390d3`](https://github.com/feniix/kinemotion/commit/41390d336d0d8083606903f6c263841000fc2f17))
+
+- Sonar relase update
+  ([`e8edc51`](https://github.com/feniix/kinemotion/commit/e8edc510a5b9e793766cc4c5acfb033f63e8f892))
+
+### Documentation
+
+- Update CMJ camera angle recommendation to 45° oblique
+  ([`c3f09fa`](https://github.com/feniix/kinemotion/commit/c3f09faf4ebb1c12a2ddb4bacb5ba9aaeab936c7))
+
+
 ## v0.35.0 (2025-12-02)
 
 ### Chores

{kinemotion-0.35.0 → kinemotion-0.35.1}/CLAUDE.md

@@ -12,7 +12,7 @@ Kinemotion: Video-based kinematic analysis for athletic performance using MediaP
 ## Current Roadmap (MVP-First Approach)
 
 **Phase 1: MVP Validation (Weeks 1-3)**
-- Issue #10 (P0): Fix CMJ ankle angle calculation
+- Issue #10 (P0): ✅ Validated optimal camera angle for MediaPipe (45° oblique recommended)
 - Issue #11 (P0): Validate CMJ metrics with phase progression tests
 - Issue #12 (P0): Build simple web UI (upload → analyze → export)
 - **Goal:** Get product in coaches' hands, gather market feedback
@@ -163,7 +163,9 @@ User uploads video → Frontend (React) → Backend API (FastAPI) → kinemotion
 
 - Use signed velocity (not absolute)
 - Backward search algorithm (find peak first)
-- Lateral view required
+- **45° oblique view recommended** (better MediaPipe tracking than 90° lateral)
+  - At 90° lateral: MediaPipe confuses left/right feet (occlusion)
+  - At 45° oblique: Both legs clearly separated → accurate tracking
 
 See [Implementation Details](docs/technical/implementation-details.md) for complete technical reference.
 

{kinemotion-0.35.0 → kinemotion-0.35.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.35.0
+Version: 0.35.1
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion

kinemotion-0.35.1/docs/guides/cmj-recording-protocol-es.md

@@ -0,0 +1,147 @@
+# 📹 Protocolo de Grabación CMJ: Ángulo Óptimo de Cámara para MediaPipe
+
+**Recomendación:** Usar **vista oblicua de 45°** para mejor precisión de tracking con MediaPipe
+
+**Basado en:** Estudio de validación empírica (Diciembre 2025) que demuestra que 45° proporciona tracking superior vs 90° lateral
+
+______________________________________________________________________
+
+## ⚡ Lo Esencial
+
+| Elemento                | Especificación                               |
+| ----------------------- | -------------------------------------------- |
+| **Ángulo de Cámara**    | **45° oblicuo** (RECOMENDADO)                |
+| **¿Por qué 45°?**       | Mejor separación de landmarks para MediaPipe |
+| **Evitar 90°**          | Vista lateral causa oclusión de landmarks    |
+| **Resolución**          | 1080p mínimo                                 |
+| **Frame Rate**          | 60fps mínimo (120fps preferido)              |
+| **Protocolo**           | Manos en cadera, vista oblicua de 45°        |
+| **Tracking de Tobillo** | Esperar 120-150° en despegue                 |
+
+______________________________________________________________________
+
+## 📸 Setup de Cámara
+
+**Posición:**
+
+- Distancia: 4m (óptimo) o 3-5m
+- Altura cámara: Nivel del pecho/torso medio del atleta (~100-120cm)
+- **Ángulo de cámara: 45° oblicuo** (RECOMENDADO)
+  - Posicionar cámara entre lateral (90°) y frontal (0°)
+  - Atleta visible desde ~45° hacia el lado
+  - ✅ **¿Por qué 45°?** Mejor separación de landmarks de tobillo para MediaPipe
+  - ❌ **Evitar 90° lateral:** Causa superposición de landmarks → tracking deficiente
+
+**Configuración:**
+
+- Formato: MP4 o MOV, H.264
+- Iluminación: Uniforme, sin sombras en tobillo
+- Fondo: Contraste alto con ropa atleta
+- Estabilización: Tripié seguro y nivelado
+
+______________________________________________________________________
+
+## 🎬 Protocolo de Grabación
+
+**Setup Recomendado (vista oblicua de 45°):**
+
+1. **Posicionar cámara a ángulo de 45°** al lado del atleta
+1. **Marcar posición del atleta:** Posición fija en piso, misma ropa y calzado
+1. **Grabar saltos:** Un video por salto (1-3 saltos recomendados)
+1. **Mantener consistencia:** Mismo ángulo, iluminación y distancia
+
+**Importante:**
+
+- Capturar un video por salto—no grabar múltiples saltos en un archivo
+- Mantener cámara a 45° oblicuo para todas las grabaciones
+- Asegurar que landmarks de tobillo (talón, tobillo, dedos) estén claramente visibles y separados
+
+______________________________________________________________________
+
+### ¿Por qué 45° Oblicuo? (Evidencia Empírica)
+
+**Resultados del Estudio de Validación (Diciembre 2025):**
+
+- **45° oblicuo**: 140.67° promedio de ángulo de tobillo ✅ (preciso)
+- **90° lateral**: 112.00° promedio de ángulo de tobillo ⚠️ (subestimado)
+- **Causa Raíz**: En 90° lateral, una pierna oculta la otra → MediaPipe **confunde pie izquierdo/derecho**
+
+**Conclusión Clave:** MediaPipe no puede distinguir cuál pie es cuál en 90° lateral. En 45° oblicuo, ambas piernas están claramente separadas, permitiendo tracking preciso izquierda/derecha.
+
+______________________________________________________________________
+
+## ✅ Requisitos Críticos
+
+- ✅ **Ángulo de cámara de 45° oblicuo** (óptimo para MediaPipe)
+- ✅ **Manos en cadera fijas** durante TODO el movimiento
+- ✅ **Iluminación consistente** (sin sombras en tobillo)
+- ✅ **Un video por salto** (archivos independientes)
+- ✅ **Buena forma:** CMJ profundo, extensión explosiva, sin brazos
+- ✅ **Landmarks de tobillo visibles:** Talón, tobillo y dedos claramente separados
+
+❌ **No hacer:**
+
+- Usar vista lateral pura de 90° (causa oclusión de landmarks)
+- Grabar múltiples saltos en un video
+- Grabar con mala iluminación (afecta detección de landmarks)
+- Posicionar cámara muy cerca (\< 3m) o muy lejos (> 5m)
+
+______________________________________________________________________
+
+## 📊 Frame Rate y Configuración
+
+| Frame Rate | Configuración iPhone/Android                                      |
+| ---------- | ----------------------------------------------------------------- |
+| **60fps**  | Settings → Camera → Record Video: 1080p at 60fps                  |
+| **120fps** | Settings → Camera → Record Video: 1080p at 120fps (si disponible) |
+
+**Nota:** 120fps requiere mejor iluminación que 60fps
+
+______________________________________________________________________
+
+## 📝 Checklist Antes de Grabar
+
+- [ ] Tripié estable, nivel
+- [ ] Atleta en posición, con mismo calzado
+- [ ] Iluminación uniforme, sin sombras
+- [ ] Frame rate correcto en ajustes
+- [ ] Prueba de 5 segundos grabada
+- [ ] Atleta visible de cabeza a pies
+- [ ] Manos en cadera (posición inicial verificada)
+
+______________________________________________________________________
+
+## 🎯 Criterios de Aceptación
+
+Cada video debe tener:
+
+- ✅ Vista lateral clara (45° o 90°)
+- ✅ Cuerpo completo visible
+- ✅ Tobillo bien iluminado, visible
+- ✅ Manos en cadera durante TODO el movimiento
+- ✅ CMJ profundo y explosivo
+- ✅ Plantarflexión clara en despegue
+- ✅ Forma de investigación evidente
+
+______________________________________________________________________
+
+## 📋 Referencia Rápida: Ángulos de Tobillo (en vista de 45°)
+
+**Posición inicial (neutral):** ~80-90° (pie perpendicular a pierna)
+**Despegue (plantarflexión):** ~120-150° (pie apuntando abajo)
+**Esperado en despegue:** ~140° promedio según estudio de validación
+**Progresión objetivo:** Al menos 30° de extensión de tobillo durante salto
+
+**Nota:** Estos valores son para vista oblicua de 45°. Vista lateral de 90° muestra ángulos artificialmente bajos (~112° prom) debido a problemas de tracking.
+
+______________________________________________________________________
+
+## 📚 Referencias Técnicas
+
+Basado en:
+
+- `docs/guides/camera-setup.md` - Setup de cámara del proyecto
+- `docs/technical/framerate.md` - Análisis de frame rates
+- Issue #10 - Validación de ángulo de tobillo CMJ
+
+**Versión:** 2.0 | Diciembre 2025 (Actualizado con hallazgos de validación empírica)

kinemotion-0.35.1/docs/guides/cmj-recording-protocol.md

@@ -0,0 +1,147 @@
+# 📹 CMJ Recording Protocol: Optimal Camera Angle for MediaPipe
+
+**Recommendation:** Use **45° oblique view** for best MediaPipe tracking accuracy
+
+**Based on:** Empirical validation study (December 2025) showing 45° provides superior landmark tracking vs 90° lateral
+
+______________________________________________________________________
+
+## ⚡ Essential
+
+| Element            | Specification                                |
+| ------------------ | -------------------------------------------- |
+| **Camera Angle**   | **45° oblique** (RECOMMENDED)                |
+| **Why 45°?**       | Better MediaPipe landmark separation         |
+| **Avoid 90°**      | Lateral view causes ankle landmark occlusion |
+| **Resolution**     | 1080p minimum                                |
+| **Frame Rate**     | 60fps minimum (120fps preferred)             |
+| **Protocol**       | Hands on hips, 45° oblique view              |
+| **Ankle Tracking** | Expect 120-150° at takeoff                   |
+
+______________________________________________________________________
+
+## 📸 Camera Setup
+
+**Position:**
+
+- Distance: 4m (ideal) or 3-5m
+- Camera height: Mid-chest level of athlete (~100-120cm)
+- **Camera angle: 45° oblique** (RECOMMENDED)
+  - Position camera between lateral (90°) and frontal (0°)
+  - Athlete visible from ~45° angle to side
+  - ✅ **Why 45°?** Better ankle landmark separation for MediaPipe
+  - ❌ **Avoid 90° lateral:** Causes ankle landmark overlap → poor tracking
+
+**Configuration:**
+
+- Format: MP4 or MOV, H.264 codec
+- Lighting: Consistent, no shadows falling on the ankle
+- Background: High-contrast backdrop relative to athlete's clothing
+- Tripod: Secure and level
+
+______________________________________________________________________
+
+## 🎬 Recording Protocol
+
+**Recommended Setup (45° oblique view):**
+
+1. **Position camera at 45° angle** to athlete's side
+1. **Mark athlete position:** Fixed floor position, unchanged clothing and footwear
+1. **Record jumps:** One video per jump (1-3 jumps recommended)
+1. **Maintain consistency:** Same angle, lighting, and distance throughout
+
+**Important:**
+
+- Capture one video per jump—do not record multiple jumps in a single file
+- Keep camera at 45° oblique for all recordings
+- Ensure ankle landmarks (heel, ankle, toes) are clearly visible and separated
+
+______________________________________________________________________
+
+### Why 45° Oblique? (Empirical Evidence)
+
+**Validation Study Results (December 2025):**
+
+- **45° oblique**: 140.67° average ankle angle ✅ (accurate)
+- **90° lateral**: 112.00° average ankle angle ⚠️ (underestimated)
+- **Root Cause**: At 90° lateral, one leg occludes the other → MediaPipe **confuses left/right feet**
+
+**Key Insight:** MediaPipe cannot distinguish which foot is which at 90° lateral. At 45° oblique, both legs are clearly separated, enabling accurate left/right tracking.
+
+______________________________________________________________________
+
+## ✅ Critical Requirements
+
+- ✅ **45° oblique camera angle** (optimal for MediaPipe)
+- ✅ **Hands remain on hips** for the entire movement
+- ✅ **Consistent lighting** (no shadows on ankle)
+- ✅ **Separate video files** for each jump
+- ✅ **Good form:** Deep countermovement, explosive extension, no arm swing
+- ✅ **Ankle landmarks visible:** Heel, ankle, and toes clearly separated
+
+❌ **Do not:**
+
+- Use 90° pure lateral view (causes landmark occlusion)
+- Include multiple jumps in a single video file
+- Record with poor lighting (affects landmark detection)
+- Position camera too close (\< 3m) or too far (> 5m)
+
+______________________________________________________________________
+
+## 📊 Frame Rate and Configuration
+
+| Frame Rate | iPhone/Android Configuration                                     |
+| ---------- | ---------------------------------------------------------------- |
+| **60fps**  | Settings → Camera → Record Video: 1080p at 60fps                 |
+| **120fps** | Settings → Camera → Record Video: 1080p at 120fps (if available) |
+
+**Note:** 120fps requires better lighting than 60fps
+
+______________________________________________________________________
+
+## 📝 Pre-Recording Checklist
+
+- [ ] Tripod is stable and level
+- [ ] Athlete positioned with proper footwear
+- [ ] Lighting is even throughout, no shadows on ankle
+- [ ] Frame rate setting matches current group requirement
+- [ ] Test 5-second recording completed successfully
+- [ ] Full athlete body visible in frame (head to toes)
+- [ ] Confirm hands positioned on hips before first jump
+
+______________________________________________________________________
+
+## 🎯 Acceptance Criteria
+
+Each video must include:
+
+- ✅ Clear side angle (45° or 90° view)
+- ✅ Complete athlete body in frame
+- ✅ Ankle well-illuminated and clearly visible
+- ✅ Hands stay on hips throughout entire movement
+- ✅ Deep countermovement followed by explosive push
+- ✅ Visible plantarflexion (toe point) at liftoff
+- ✅ Proper research technique throughout
+
+______________________________________________________________________
+
+## 📋 Quick Reference: Ankle Angles (at 45° view)
+
+**Starting position (neutral):** ~80-90° (foot at right angle to shin)
+**Liftoff (plantarflexion):** ~120-150° (foot pointing downward)
+**Expected at takeoff:** ~140° average based on validation study
+**Target progression:** At least 30° of ankle extension during jump
+
+**Note:** These values are for 45° oblique view. 90° lateral view shows artificially low angles (~112° avg) due to landmark tracking issues.
+
+______________________________________________________________________
+
+## 📚 Technical References
+
+See also:
+
+- `docs/guides/camera-setup.md` - Camera positioning and equipment guidelines
+- `docs/technical/framerate.md` - Frame rate considerations and temporal resolution
+- Issue #10 - Ankle angle measurement validation study
+
+**Version:** 2.0 | December 2025 (Updated with empirical validation findings)

{kinemotion-0.35.0 → kinemotion-0.35.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kinemotion"
-version = "0.35.0"
+version = "0.35.1"
 description = "Video-based kinematic analysis for athletic performance"
 readme = "README.md"
 requires-python = ">=3.10,<3.13"

kinemotion-0.35.1/scripts/debug_contact_states.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+"""
+Debug contact states for drop jump videos to see why takeoff isn't detected.
+"""
+
+import sys
+from pathlib import Path
+
+import numpy as np
+
+sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
+
+from kinemotion.core.pose import PoseTracker
+from kinemotion.core.video_io import VideoProcessor
+from kinemotion.dropjump.analysis import (
+    ContactState,
+    detect_ground_contact,
+    extract_foot_positions_and_visibilities,
+    find_contact_phases,
+)
+
+# Test the failing videos
+videos = [
+    ("samples/validation/dj-45-IMG_6739.MOV", 118, 131, 144),  # Video 1 - takeoff fails
+    ("samples/validation/dj-45-IMG_6740.MOV", 141, 154, 166),  # Video 2 - both fail
+]
+
+for video_path, drop_gt, landing_gt, takeoff_gt in videos:
+    print("=" * 80)
+    print(f"Testing: {Path(video_path).name}")
+    print(f"GT: drop={drop_gt}, landing={landing_gt}, takeoff={takeoff_gt}")
+    print("=" * 80)
+
+    # Process video
+    video_processor = VideoProcessor(video_path)
+    fps = video_processor.fps
+    frame_count = video_processor.frame_count
+
+    # Get pose landmarks
+    pose_tracker = PoseTracker()
+    landmarks_sequence = []
+
+    for frame_idx in range(frame_count):
+        frame = video_processor.read_frame()
+        if frame is None:
+            break
+        results = pose_tracker.process_frame(frame)
+        landmarks_sequence.append(results)
+
+    # Extract foot positions
+    positions, visibilities = extract_foot_positions_and_visibilities(landmarks_sequence)
+
+    # Detect contact states with NEW optimized threshold
+    contact_states = detect_ground_contact(
+        positions,
+        velocity_threshold=0.002,  # NEW: Empirically optimized (was 0.01)
+        min_contact_frames=6,
+        visibility_threshold=0.5,
+        visibilities=visibilities,
+    )
+
+    # Find phases
+    phases = find_contact_phases(contact_states)
+
+    print(f"\nTotal frames: {len(contact_states)}")
+    print(f"Total phases detected: {len(phases)}")
+    print("\nPhases:")
+    for i, (start, end, state) in enumerate(phases[:10]):  # Show first 10
+        duration = (end - start) / fps * 1000
+        state_name = "ON_GROUND" if state == ContactState.ON_GROUND else "IN_AIR"
+        print(f"  {i+1}. Frames {start:3d}-{end:3d} ({duration:6.1f}ms): {state_name}")
+        if i == 9 and len(phases) > 10:
+            print(f"  ... and {len(phases) - 10} more phases")
+
+    # Check contact states around key events
+    print(f"\nContact states around key events:")
+    print(f"  Drop GT ({drop_gt}): {contact_states[drop_gt].name if drop_gt < len(contact_states) else 'OUT OF RANGE'}")
+    print(f"  Landing GT ({landing_gt}): {contact_states[landing_gt].name if landing_gt < len(contact_states) else 'OUT OF RANGE'}")
+    print(f"  Takeoff GT ({takeoff_gt}): {contact_states[takeoff_gt].name if takeoff_gt < len(contact_states) else 'OUT OF RANGE'}")
+
+    # Count state distribution
+    on_ground = sum(1 for s in contact_states if s == ContactState.ON_GROUND)
+    in_air = sum(1 for s in contact_states if s == ContactState.IN_AIR)
+    unknown = sum(1 for s in contact_states if s == ContactState.UNKNOWN)
+
+    print(f"\nContact state distribution:")
+    print(f"  ON_GROUND: {on_ground} frames ({on_ground/len(contact_states)*100:.1f}%)")
+    print(f"  IN_AIR: {in_air} frames ({in_air/len(contact_states)*100:.1f}%)")
+    print(f"  UNKNOWN: {unknown} frames ({unknown/len(contact_states)*100:.1f}%)")
+    print()