kinemotion 0.12.0__tar.gz → 0.12.2__tar.gz

{kinemotion-0.12.0 → kinemotion-0.12.2}/CHANGELOG.md

@@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.12.2 (2025-11-06)
+
+### Bug Fixes
+
+- **core**: Suppress false positive for polyorder parameter
+  ([`ae5ffea`](https://github.com/feniix/kinemotion/commit/ae5ffea708741592e1cd356cdf35dcc388cbe97f))
+
+- **dropjump**: Remove unused parameters from calculate_drop_jump_metrics
+  ([`6130c11`](https://github.com/feniix/kinemotion/commit/6130c113be71dcd8c278b1f31a3b5e300a6b4532))
+
+### Refactoring
+
+- **core**: Reduce cognitive complexity in pose.py
+  ([`f0a3805`](https://github.com/feniix/kinemotion/commit/f0a380561844e54b4372f57c93b82f8c8a1440ee))
+
+- **dropjump**: Reduce cognitive complexity in analysis.py
+  ([`180bb37`](https://github.com/feniix/kinemotion/commit/180bb373f63675ef6ecacaea8e9ee9f63c3d3746))
+
+- **dropjump**: Reduce cognitive complexity in debug_overlay.py
+  ([`076cb56`](https://github.com/feniix/kinemotion/commit/076cb560c55baaff0ba93d0631eb38d69f8a7d7b))
+
+
+## v0.12.1 (2025-11-06)
+
+### Bug Fixes
+
+- **core**: Remove unreachable duplicate return statement
+  ([`294115d`](https://github.com/feniix/kinemotion/commit/294115da761b2851ecc4405a6503138851a56ad1))
+
+- **examples**: Remove drop_height from API examples
+  ([`f3da09e`](https://github.com/feniix/kinemotion/commit/f3da09ef4ab050b13b80b9fdd8c7734e4556647a))
+
+### Refactoring
+
+- **dropjump**: Remove unused calibration parameters
+  ([`1a7572c`](https://github.com/feniix/kinemotion/commit/1a7572c83ff4e990e39dcb96ff61220adf40818e))
+
+
 ## v0.12.0 (2025-11-06)
 
 ### Documentation

{kinemotion-0.12.0 → kinemotion-0.12.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.12.0
+Version: 0.12.2
 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.12.0 → kinemotion-0.12.2}/examples/bulk/bulk_processing.py

@@ -18,9 +18,9 @@ def example_simple_bulk() -> None:
     print("=" * 80)
 
     video_configs = [
-        VideoConfig(video_path="video1.mp4", drop_height=0.40),
-        VideoConfig(video_path="video2.mp4", drop_height=0.30),
-        VideoConfig(video_path="video3.mp4", drop_height=0.50),
+        VideoConfig(video_path="video1.mp4"),
+        VideoConfig(video_path="video2.mp4"),
+        VideoConfig(video_path="video3.mp4"),
     ]
 
     # Process videos with 4 parallel workers
@@ -41,21 +41,18 @@ def example_advanced_configuration() -> None:
         # Fast analysis for quick screening
         VideoConfig(
             video_path="athlete1_trial1.mp4",
-            drop_height=0.40,
             quality="fast",
             json_output="results/athlete1_trial1.json",
         ),
         # Balanced analysis (default)
         VideoConfig(
             video_path="athlete1_trial2.mp4",
-            drop_height=0.40,
             quality="balanced",
             json_output="results/athlete1_trial2.json",
         ),
         # Research-grade accurate analysis with debug video
         VideoConfig(
             video_path="athlete1_trial3.mp4",
-            drop_height=0.40,
             quality="accurate",
             output_video="debug/athlete1_trial3_debug.mp4",
             json_output="results/athlete1_trial3.json",
@@ -101,7 +98,6 @@ def example_process_directory() -> list[VideoResult]:
     dir_configs = [
         VideoConfig(
             video_path=str(video_file),
-            drop_height=0.40,
             quality="balanced",
             json_output=f"results/{video_file.stem}.json",
         )
@@ -187,7 +183,6 @@ def example_custom_parameters() -> None:
         # Low quality video - use more aggressive smoothing
         VideoConfig(
             video_path="low_quality.mp4",
-            drop_height=0.40,
             smoothing_window=7,  # More smoothing
             velocity_threshold=0.025,  # Higher threshold
             quality="accurate",
@@ -195,7 +190,6 @@ def example_custom_parameters() -> None:
         # High speed video - adjust for higher framerate
         VideoConfig(
             video_path="high_speed_120fps.mp4",
-            drop_height=0.40,
             quality="accurate",
             # Auto-tuning will handle FPS adjustments
         ),
@@ -290,7 +284,6 @@ def example_single_video() -> None:
         # Process single video with verbose output
         metrics = process_video(
             video_path="sample.mp4",
-            drop_height=0.40,
             quality="balanced",
             output_video="sample_debug.mp4",
             json_output="sample_results.json",

{kinemotion-0.12.0 → kinemotion-0.12.2}/examples/bulk/simple_example.py

@@ -12,10 +12,9 @@ def process_single_video_example() -> None:
     """Process a single video - the simplest usage."""
     print("Processing single video...")
 
-    # Process with just the required parameters
+    # Process with just the video path
     metrics = process_video(
         video_path="my_video.mp4",
-        drop_height=0.40,  # 40cm drop box
         verbose=True,
     )
 
@@ -36,10 +35,10 @@ def process_multiple_videos_example() -> None:
 
     # Configure videos to process
     configs = [
-        VideoConfig("athlete1_jump1.mp4", drop_height=0.40),
-        VideoConfig("athlete1_jump2.mp4", drop_height=0.40),
-        VideoConfig("athlete1_jump3.mp4", drop_height=0.40),
-        VideoConfig("athlete2_jump1.mp4", drop_height=0.30),  # Different drop height
+        VideoConfig("athlete1_jump1.mp4"),
+        VideoConfig("athlete1_jump2.mp4"),
+        VideoConfig("athlete1_jump3.mp4"),
+        VideoConfig("athlete2_jump1.mp4", quality="accurate"),
     ]
 
     # Process all videos using 4 parallel workers
@@ -74,7 +73,6 @@ def process_with_outputs_example() -> None:
 
     metrics = process_video(
         video_path="my_video.mp4",
-        drop_height=0.40,
         output_video="debug_output.mp4",  # Save annotated video
         json_output="results.json",  # Save metrics as JSON
         quality="accurate",  # Use highest quality analysis

{kinemotion-0.12.0 → kinemotion-0.12.2}/pyproject.toml

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

{kinemotion-0.12.0 → kinemotion-0.12.2}/src/kinemotion/api.py

@@ -463,13 +463,11 @@ def process_video(
             contact_states,
             vertical_positions,
             video.fps,
-            drop_height_m=None,
             drop_start_frame=drop_start_frame,
             velocity_threshold=params.velocity_threshold,
             smoothing_window=params.smoothing_window,
             polyorder=params.polyorder,
             use_curvature=params.use_curvature,
-            kinematic_correction_factor=1.0,
         )
 
         # Generate outputs (JSON and debug video)

{kinemotion-0.12.0 → kinemotion-0.12.2}/src/kinemotion/core/cli_utils.py

@@ -210,5 +210,3 @@ def common_output_options(func: Callable) -> Callable:  # type: ignore[type-arg]
         help="Path for JSON metrics output (default: stdout)",
     )(func)
     return func
-
-    return func

{kinemotion-0.12.0 → kinemotion-0.12.2}/src/kinemotion/core/pose.py

@@ -81,6 +81,100 @@ class PoseTracker:
         self.pose.close()
 
 
+def _add_head_segment(
+    segments: list,
+    weights: list,
+    visibilities: list,
+    landmarks: dict[str, tuple[float, float, float]],
+    vis_threshold: float,
+) -> None:
+    """Add head segment (8% body mass) if visible."""
+    if "nose" in landmarks:
+        x, y, vis = landmarks["nose"]
+        if vis > vis_threshold:
+            segments.append((x, y))
+            weights.append(0.08)
+            visibilities.append(vis)
+
+
+def _add_trunk_segment(
+    segments: list,
+    weights: list,
+    visibilities: list,
+    landmarks: dict[str, tuple[float, float, float]],
+    vis_threshold: float,
+) -> None:
+    """Add trunk segment (50% body mass) if visible."""
+    trunk_keys = ["left_shoulder", "right_shoulder", "left_hip", "right_hip"]
+    trunk_pos = [
+        (x, y, vis)
+        for key in trunk_keys
+        if key in landmarks
+        for x, y, vis in [landmarks[key]]
+        if vis > vis_threshold
+    ]
+    if len(trunk_pos) >= 2:
+        trunk_x = float(np.mean([p[0] for p in trunk_pos]))
+        trunk_y = float(np.mean([p[1] for p in trunk_pos]))
+        trunk_vis = float(np.mean([p[2] for p in trunk_pos]))
+        segments.append((trunk_x, trunk_y))
+        weights.append(0.50)
+        visibilities.append(trunk_vis)
+
+
+def _add_limb_segment(
+    segments: list,
+    weights: list,
+    visibilities: list,
+    landmarks: dict[str, tuple[float, float, float]],
+    side: str,
+    proximal_key: str,
+    distal_key: str,
+    segment_weight: float,
+    vis_threshold: float,
+) -> None:
+    """Add a limb segment (thigh or lower leg) if both endpoints visible."""
+    prox_full = f"{side}_{proximal_key}"
+    dist_full = f"{side}_{distal_key}"
+
+    if prox_full in landmarks and dist_full in landmarks:
+        px, py, pvis = landmarks[prox_full]
+        dx, dy, dvis = landmarks[dist_full]
+        if pvis > vis_threshold and dvis > vis_threshold:
+            seg_x = (px + dx) / 2
+            seg_y = (py + dy) / 2
+            seg_vis = (pvis + dvis) / 2
+            segments.append((seg_x, seg_y))
+            weights.append(segment_weight)
+            visibilities.append(seg_vis)
+
+
+def _add_foot_segment(
+    segments: list,
+    weights: list,
+    visibilities: list,
+    landmarks: dict[str, tuple[float, float, float]],
+    side: str,
+    vis_threshold: float,
+) -> None:
+    """Add foot segment (1.5% body mass per foot) if visible."""
+    foot_keys = [f"{side}_ankle", f"{side}_heel", f"{side}_foot_index"]
+    foot_pos = [
+        (x, y, vis)
+        for key in foot_keys
+        if key in landmarks
+        for x, y, vis in [landmarks[key]]
+        if vis > vis_threshold
+    ]
+    if foot_pos:
+        foot_x = float(np.mean([p[0] for p in foot_pos]))
+        foot_y = float(np.mean([p[1] for p in foot_pos]))
+        foot_vis = float(np.mean([p[2] for p in foot_pos]))
+        segments.append((foot_x, foot_y))
+        weights.append(0.015)
+        visibilities.append(foot_vis)
+
+
 def compute_center_of_mass(
     landmarks: dict[str, tuple[float, float, float]],
     visibility_threshold: float = 0.5,
@@ -106,114 +200,59 @@ def compute_center_of_mass(
         (x, y, visibility) tuple for estimated CoM position
         visibility = average visibility of all segments used
     """
-    # Define segment representatives and their weights (as fraction of body mass)
-    # Each segment uses midpoint or average of its bounding landmarks
-    segments = []
-    segment_weights = []
-    visibilities = []
+    segments: list = []
+    weights: list = []
+    visibilities: list = []
 
-    # Head segment: 8% (use nose as proxy)
-    if "nose" in landmarks:
-        x, y, vis = landmarks["nose"]
-        if vis > visibility_threshold:
-            segments.append((x, y))
-            segment_weights.append(0.08)
-            visibilities.append(vis)
+    # Add body segments
+    _add_head_segment(segments, weights, visibilities, landmarks, visibility_threshold)
+    _add_trunk_segment(segments, weights, visibilities, landmarks, visibility_threshold)
 
-    # Trunk segment: 50% (midpoint between shoulders and hips)
-    trunk_landmarks = ["left_shoulder", "right_shoulder", "left_hip", "right_hip"]
-    trunk_positions = [
-        (x, y, vis)
-        for key in trunk_landmarks
-        if key in landmarks
-        for x, y, vis in [landmarks[key]]
-        if vis > visibility_threshold
-    ]
-    if len(trunk_positions) >= 2:
-        trunk_x = float(np.mean([pos[0] for pos in trunk_positions]))
-        trunk_y = float(np.mean([pos[1] for pos in trunk_positions]))
-        trunk_vis = float(np.mean([pos[2] for pos in trunk_positions]))
-        segments.append((trunk_x, trunk_y))
-        segment_weights.append(0.50)
-        visibilities.append(trunk_vis)
-
-    # Thigh segment: 20% total (midpoint hip to knee for each leg)
+    # Add bilateral limb segments
     for side in ["left", "right"]:
-        hip_key = f"{side}_hip"
-        knee_key = f"{side}_knee"
-        if hip_key in landmarks and knee_key in landmarks:
-            hip_x, hip_y, hip_vis = landmarks[hip_key]
-            knee_x, knee_y, knee_vis = landmarks[knee_key]
-            if hip_vis > visibility_threshold and knee_vis > visibility_threshold:
-                thigh_x = (hip_x + knee_x) / 2
-                thigh_y = (hip_y + knee_y) / 2
-                thigh_vis = (hip_vis + knee_vis) / 2
-                segments.append((thigh_x, thigh_y))
-                segment_weights.append(0.10)  # 10% per leg
-                visibilities.append(thigh_vis)
-
-    # Lower leg segment: 10% total (midpoint knee to ankle for each leg)
-    for side in ["left", "right"]:
-        knee_key = f"{side}_knee"
-        ankle_key = f"{side}_ankle"
-        if knee_key in landmarks and ankle_key in landmarks:
-            knee_x, knee_y, knee_vis = landmarks[knee_key]
-            ankle_x, ankle_y, ankle_vis = landmarks[ankle_key]
-            if knee_vis > visibility_threshold and ankle_vis > visibility_threshold:
-                leg_x = (knee_x + ankle_x) / 2
-                leg_y = (knee_y + ankle_y) / 2
-                leg_vis = (knee_vis + ankle_vis) / 2
-                segments.append((leg_x, leg_y))
-                segment_weights.append(0.05)  # 5% per leg
-                visibilities.append(leg_vis)
-
-    # Foot segment: 3% total (average of ankle, heel, foot_index)
-    for side in ["left", "right"]:
-        foot_keys = [f"{side}_ankle", f"{side}_heel", f"{side}_foot_index"]
-        foot_positions = [
-            (x, y, vis)
-            for key in foot_keys
-            if key in landmarks
-            for x, y, vis in [landmarks[key]]
-            if vis > visibility_threshold
-        ]
-        if foot_positions:
-            foot_x = float(np.mean([pos[0] for pos in foot_positions]))
-            foot_y = float(np.mean([pos[1] for pos in foot_positions]))
-            foot_vis = float(np.mean([pos[2] for pos in foot_positions]))
-            segments.append((foot_x, foot_y))
-            segment_weights.append(0.015)  # 1.5% per foot
-            visibilities.append(foot_vis)
-
-    # If no segments found, fall back to hip average
+        _add_limb_segment(
+            segments,
+            weights,
+            visibilities,
+            landmarks,
+            side,
+            "hip",
+            "knee",
+            0.10,
+            visibility_threshold,
+        )
+        _add_limb_segment(
+            segments,
+            weights,
+            visibilities,
+            landmarks,
+            side,
+            "knee",
+            "ankle",
+            0.05,
+            visibility_threshold,
+        )
+        _add_foot_segment(
+            segments, weights, visibilities, landmarks, side, visibility_threshold
+        )
+
+    # Fallback if no segments found
     if not segments:
         if "left_hip" in landmarks and "right_hip" in landmarks:
             lh_x, lh_y, lh_vis = landmarks["left_hip"]
             rh_x, rh_y, rh_vis = landmarks["right_hip"]
-            return (
-                (lh_x + rh_x) / 2,
-                (lh_y + rh_y) / 2,
-                (lh_vis + rh_vis) / 2,
-            )
-        # Ultimate fallback: center of frame
+            return ((lh_x + rh_x) / 2, (lh_y + rh_y) / 2, (lh_vis + rh_vis) / 2)
         return (0.5, 0.5, 0.0)
 
-    # Normalize weights to sum to 1.0
-    total_weight = sum(segment_weights)
-    normalized_weights = [w / total_weight for w in segment_weights]
+    # Normalize weights and compute weighted average
+    total_weight = sum(weights)
+    normalized_weights = [w / total_weight for w in weights]
 
-    # Compute weighted average of segment positions
     com_x = float(
-        sum(
-            pos[0] * weight
-            for pos, weight in zip(segments, normalized_weights, strict=True)
-        )
+        sum(p[0] * w for p, w in zip(segments, normalized_weights, strict=True))
     )
     com_y = float(
-        sum(
-            pos[1] * weight
-            for pos, weight in zip(segments, normalized_weights, strict=True)
-        )
+        sum(p[1] * w for p, w in zip(segments, normalized_weights, strict=True))
     )
     com_visibility = float(np.mean(visibilities)) if visibilities else 0.0
 

{kinemotion-0.12.0 → kinemotion-0.12.2}/src/kinemotion/core/smoothing.py

@@ -117,7 +117,7 @@ def _store_smoothed_landmarks(
             )
 
 
-def _smooth_landmarks_core(
+def _smooth_landmarks_core(  # NOSONAR(S1172) - polyorder used via closure capture in smoother_fn
     landmark_sequence: list[dict[str, tuple[float, float, float]] | None],
     window_length: int,
     polyorder: int,
@@ -129,7 +129,7 @@ def _smooth_landmarks_core(
     Args:
         landmark_sequence: List of landmark dictionaries from each frame
         window_length: Length of filter window (must be odd)
-        polyorder: Order of polynomial used to fit samples
+        polyorder: Order of polynomial used to fit samples (captured by smoother_fn closure)
         smoother_fn: Function that takes (x_coords, y_coords, valid_frames)
             and returns (x_smooth, y_smooth)