kinemotion 0.22.1__py3-none-any.whl → 0.24.0__py3-none-any.whl

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.dist-info → kinemotion-0.24.0.dist-info}/METADATA

@@ -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.dist-info → kinemotion-0.24.0.dist-info}/RECORD

@@ -16,13 +16,13 @@ kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
 kinemotion/core/smoothing.py,sha256=x4o3BnG6k8OaV3emgpoJDF84CE9k5RYR7BeSYH_-8Es,14092
 kinemotion/core/video_io.py,sha256=0bJTheYidEqxGP5Y2dSO2x6sbOrnBDBu2TEiV8gT23A,7285
 kinemotion/dropjump/__init__.py,sha256=yc1XiZ9vfo5h_n7PKVSiX2TTgaIfGL7Y7SkQtiDZj_E,838
-kinemotion/dropjump/analysis.py,sha256=xx5NWy6s0eb9BEyO_FByY1Ahunaoh3TyaTAxjlPrvxg,27153
+kinemotion/dropjump/analysis.py,sha256=1AsIsgWg5wuwJo7poFK7aMCFr93yHVms-fEvaOGQQWs,27448
 kinemotion/dropjump/cli.py,sha256=J2F8ij-UcybY7YjK_bncQZiHNzrgS3Y7uTBkNo7y_L4,21328
 kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
 kinemotion/dropjump/kinematics.py,sha256=VZWdytkw58Vk9dsNe8U15sFB84kfZKLo4argvt0CTPM,16361
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.22.1.dist-info/METADATA,sha256=EQIW0y1JMyzRkmnig1MhMCNt7dzCjdZxc5jOueLtdD4,20249
-kinemotion-0.22.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-kinemotion-0.22.1.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.22.1.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.22.1.dist-info/RECORD,,
+kinemotion-0.24.0.dist-info/METADATA,sha256=q-Zj983PFHne1aGTqC7JU90XxUC6g0c_SFT1p1HPGXQ,20762
+kinemotion-0.24.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+kinemotion-0.24.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.24.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.24.0.dist-info/RECORD,,