kinemotion 0.22.1__tar.gz → 0.24.0__tar.gz

{kinemotion-0.22.1 → kinemotion-0.24.0}/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.24.0 (2025-11-11)
+
+### Features
+
+- Document platform-specific system dependencies for Windows, macOS, and Linux
+  ([`928a6ad`](https://github.com/feniix/kinemotion/commit/928a6adbef18df77f5941ae0b2e82ba9d62a38b7))
+
+
+## v0.23.0 (2025-11-10)
+
+### Features
+
+- Extract visibility calculation helper to improve code maintainability
+  ([`2839d6e`](https://github.com/feniix/kinemotion/commit/2839d6eca4b4f6ff8b6247501560939953282943))
+
+
 ## v0.22.1 (2025-11-10)
 
 ### Bug Fixes

{kinemotion-0.22.1 → kinemotion-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.22.1
+Version: 0.24.0
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion
@@ -103,15 +103,24 @@ For clinical, research, or performance assessment requiring validated accuracy,
 
 #### Windows
 
-No additional system dependencies required.
+**Required system dependencies:**
+
+- [Microsoft Visual C++ 2022 Redistributable](https://visualstudio.microsoft.com/visual-cpp-build-tools/) - Runtime libraries for OpenCV/MediaPipe
+- Python 3.10-3.12 (64-bit) - MediaPipe requires 64-bit Python
 
 **Recommended for mobile video support:**
 
-- [FFmpeg](https://ffmpeg.org/download.html) - Download and add to PATH
+- [FFmpeg](https://ffmpeg.org/download.html) - Download and add to PATH for full video codec support
 
 #### macOS
 
-No additional system dependencies required.
+**Required system dependencies:**
+
+- Xcode Command Line Tools - Provides compilers and system frameworks
+
+  ```bash
+  xcode-select --install
+  ```
 
 **Recommended for mobile video support:**
 
@@ -126,9 +135,10 @@ brew install ffmpeg
 ```bash
 sudo apt-get update
 sudo apt-get install -y \
-    libgl1-mesa-glx \
-    libglib2.0-0 \
-    ffmpeg
+    libgl1 \           # OpenGL library for OpenCV
+    libglib2.0-0 \     # GLib library for MediaPipe
+    libgomp1 \         # OpenMP library for multi-threading
+    ffmpeg             # Video codec support and metadata extraction
 ```
 
 **Note:** `ffmpeg` provides the `ffprobe` tool for video metadata extraction (rotation, aspect ratio). Kinemotion works without it, but mobile/rotated videos may not process correctly. A warning will be shown if `ffprobe` is not available.

{kinemotion-0.22.1 → kinemotion-0.24.0}/README.md

@@ -74,15 +74,24 @@ For clinical, research, or performance assessment requiring validated accuracy,
 
 #### Windows
 
-No additional system dependencies required.
+**Required system dependencies:**
+
+- [Microsoft Visual C++ 2022 Redistributable](https://visualstudio.microsoft.com/visual-cpp-build-tools/) - Runtime libraries for OpenCV/MediaPipe
+- Python 3.10-3.12 (64-bit) - MediaPipe requires 64-bit Python
 
 **Recommended for mobile video support:**
 
-- [FFmpeg](https://ffmpeg.org/download.html) - Download and add to PATH
+- [FFmpeg](https://ffmpeg.org/download.html) - Download and add to PATH for full video codec support
 
 #### macOS
 
-No additional system dependencies required.
+**Required system dependencies:**
+
+- Xcode Command Line Tools - Provides compilers and system frameworks
+
+  ```bash
+  xcode-select --install
+  ```
 
 **Recommended for mobile video support:**
 
@@ -97,9 +106,10 @@ brew install ffmpeg
 ```bash
 sudo apt-get update
 sudo apt-get install -y \
-    libgl1-mesa-glx \
-    libglib2.0-0 \
-    ffmpeg
+    libgl1 \           # OpenGL library for OpenCV
+    libglib2.0-0 \     # GLib library for MediaPipe
+    libgomp1 \         # OpenMP library for multi-threading
+    ffmpeg             # Video codec support and metadata extraction
 ```
 
 **Note:** `ffmpeg` provides the `ffprobe` tool for video metadata extraction (rotation, aspect ratio). Kinemotion works without it, but mobile/rotated videos may not process correctly. A warning will be shown if `ffprobe` is not available.

{kinemotion-0.22.1 → kinemotion-0.24.0}/pyproject.toml

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

{kinemotion-0.22.1 → kinemotion-0.24.0}/src/kinemotion/dropjump/analysis.py

@@ -754,6 +754,22 @@ def compute_average_foot_position(
     return (float(np.mean(x_positions)), float(np.mean(y_positions)))
 
 
+def _calculate_average_visibility(
+    frame_landmarks: dict[str, tuple[float, float, float]],
+) -> float:
+    """Calculate average visibility of foot landmarks in a frame.
+
+    Args:
+        frame_landmarks: Landmark dictionary for a single frame
+
+    Returns:
+        Average visibility of foot landmarks (0.0 if none visible)
+    """
+    foot_keys = ["left_ankle", "right_ankle", "left_heel", "right_heel"]
+    foot_vis = [frame_landmarks[key][2] for key in foot_keys if key in frame_landmarks]
+    return float(np.mean(foot_vis)) if foot_vis else 0.0
+
+
 def extract_foot_positions_and_visibilities(
     smoothed_landmarks: list[dict[str, tuple[float, float, float]] | None],
 ) -> tuple[np.ndarray, np.ndarray]:
@@ -775,13 +791,7 @@ def extract_foot_positions_and_visibilities(
         if frame_landmarks:
             _, foot_y = compute_average_foot_position(frame_landmarks)
             position_list.append(foot_y)
-
-            # Average visibility of foot landmarks
-            foot_vis = []
-            for key in ["left_ankle", "right_ankle", "left_heel", "right_heel"]:
-                if key in frame_landmarks:
-                    foot_vis.append(frame_landmarks[key][2])
-            visibilities_list.append(float(np.mean(foot_vis)) if foot_vis else 0.0)
+            visibilities_list.append(_calculate_average_visibility(frame_landmarks))
         else:
             # Fill missing frames with last known position or default
             position_list.append(position_list[-1] if position_list else 0.5)

{kinemotion-0.22.1 → kinemotion-0.24.0}/uv.lock

@@ -700,7 +700,7 @@ wheels = [
 
 [[package]]
 name = "kinemotion"
-version = "0.22.1"
+version = "0.24.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },