kinemotion 0.11.2__tar.gz → 0.11.4__tar.gz

{kinemotion-0.11.2 → kinemotion-0.11.4}/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.11.4 (2025-11-06)
+
+### Bug Fixes
+
+- **api**: Remove countermovement_threshold from CMJVideoConfig and bulk processing
+  ([`66ac915`](https://github.com/feniix/kinemotion/commit/66ac915810853b6c7aeca79f07f6470ef5da4041))
+
+
+## v0.11.3 (2025-11-06)
+
+### Bug Fixes
+
+- Deduplicate CLI utilities across CMJ and drop jump modules
+  ([`c314083`](https://github.com/feniix/kinemotion/commit/c314083dd6601071f75ded38864f7ba9a9daab3d))
+
+- **cmj**: Remove unused countermovement_threshold parameter from process_cmj_video
+  ([`a8d9425`](https://github.com/feniix/kinemotion/commit/a8d9425a509b44ccf5c9e983e2d8552e9b5f8839))
+
+
 ## v0.11.2 (2025-11-06)
 
 ### Bug Fixes

{kinemotion-0.11.2 → kinemotion-0.11.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.11.2
+Version: 0.11.4
 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.11.2 → kinemotion-0.11.4}/pyproject.toml

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

{kinemotion-0.11.2 → kinemotion-0.11.4}/src/kinemotion/api.py

@@ -620,7 +620,6 @@ class CMJVideoConfig:
     json_output: str | None = None
     smoothing_window: int | None = None
     velocity_threshold: float | None = None
-    countermovement_threshold: float | None = None
     min_contact_frames: int | None = None
     visibility_threshold: float | None = None
     detection_confidence: float | None = None
@@ -689,7 +688,6 @@ def process_cmj_video(
     json_output: str | None = None,
     smoothing_window: int | None = None,
     velocity_threshold: float | None = None,
-    countermovement_threshold: float | None = None,
     min_contact_frames: int | None = None,
     visibility_threshold: float | None = None,
     detection_confidence: float | None = None,
@@ -710,7 +708,6 @@ def process_cmj_video(
         json_output: Optional path for JSON metrics output
         smoothing_window: Optional override for smoothing window
         velocity_threshold: Optional override for velocity threshold
-        countermovement_threshold: Optional override for countermovement threshold
         min_contact_frames: Optional override for minimum contact frames
         visibility_threshold: Optional override for visibility threshold
         detection_confidence: Optional override for pose detection confidence
@@ -929,7 +926,6 @@ def _process_cmj_video_wrapper(config: CMJVideoConfig) -> CMJVideoResult:
             json_output=config.json_output,
             smoothing_window=config.smoothing_window,
             velocity_threshold=config.velocity_threshold,
-            countermovement_threshold=config.countermovement_threshold,
             min_contact_frames=config.min_contact_frames,
             visibility_threshold=config.visibility_threshold,
             detection_confidence=config.detection_confidence,

{kinemotion-0.11.2 → kinemotion-0.11.4}/src/kinemotion/cmj/cli.py

@@ -18,8 +18,12 @@ from ..core.auto_tuning import (
     analyze_video_sample,
     auto_tune_parameters,
 )
+from ..core.cli_utils import (
+    determine_initial_confidence,
+    smooth_landmark_sequence,
+    track_all_frames,
+)
 from ..core.pose import PoseTracker
-from ..core.smoothing import smooth_landmarks, smooth_landmarks_advanced
 from ..core.video_io import VideoProcessor
 from .analysis import detect_cmj_phases
 from .debug_overlay import CMJDebugOverlayRenderer
@@ -295,53 +299,6 @@ def cmj_analyze(  # NOSONAR(S107) - Click CLI requires individual parameters for
             sys.exit(1)
 
 
-def _determine_initial_confidence(
-    quality_preset: QualityPreset,
-    expert_params: AnalysisParameters,
-) -> tuple[float, float]:
-    """Determine initial detection and tracking confidence levels."""
-    initial_detection_conf = 0.5
-    initial_tracking_conf = 0.5
-
-    if quality_preset == QualityPreset.FAST:
-        initial_detection_conf = 0.3
-        initial_tracking_conf = 0.3
-    elif quality_preset == QualityPreset.ACCURATE:
-        initial_detection_conf = 0.6
-        initial_tracking_conf = 0.6
-
-    # Override with expert values if provided
-    if expert_params.detection_confidence is not None:
-        initial_detection_conf = expert_params.detection_confidence
-    if expert_params.tracking_confidence is not None:
-        initial_tracking_conf = expert_params.tracking_confidence
-
-    return initial_detection_conf, initial_tracking_conf
-
-
-def _track_all_frames(video: VideoProcessor, tracker: PoseTracker) -> tuple[list, list]:
-    """Track pose landmarks in all video frames."""
-    click.echo("Tracking pose landmarks...", err=True)
-    landmarks_sequence = []
-    frames = []
-
-    bar: Any
-    with click.progressbar(length=video.frame_count, label="Processing frames") as bar:
-        while True:
-            frame = video.read_frame()
-            if frame is None:
-                break
-
-            frames.append(frame)
-            landmarks = tracker.process_frame(frame)
-            landmarks_sequence.append(landmarks)
-
-            bar.update(1)
-
-    tracker.close()
-    return frames, landmarks_sequence
-
-
 def _apply_expert_param_overrides(
     params: AutoTunedParams, expert_params: AnalysisParameters
 ) -> AutoTunedParams:
@@ -386,34 +343,6 @@ def _print_auto_tuned_params(
     click.echo("=" * 60 + "\n", err=True)
 
 
-def _smooth_landmark_sequence(
-    landmarks_sequence: list, params: AutoTunedParams
-) -> list:
-    """Apply smoothing to landmark sequence."""
-    if params.outlier_rejection or params.bilateral_filter:
-        if params.outlier_rejection:
-            click.echo("Smoothing landmarks with outlier rejection...", err=True)
-        if params.bilateral_filter:
-            click.echo(
-                "Using bilateral temporal filter for edge-preserving smoothing...",
-                err=True,
-            )
-        return smooth_landmarks_advanced(
-            landmarks_sequence,
-            window_length=params.smoothing_window,
-            polyorder=params.polyorder,
-            use_outlier_rejection=params.outlier_rejection,
-            use_bilateral=params.bilateral_filter,
-        )
-    else:
-        click.echo("Smoothing landmarks...", err=True)
-        return smooth_landmarks(
-            landmarks_sequence,
-            window_length=params.smoothing_window,
-            polyorder=params.polyorder,
-        )
-
-
 def _get_foot_position(frame_landmarks: dict | None, last_position: float) -> float:
     """Extract average foot position from frame landmarks."""
     if not frame_landmarks:
@@ -470,7 +399,7 @@ def _process_single(
             )
 
             # Determine confidence levels
-            detection_conf, tracking_conf = _determine_initial_confidence(
+            detection_conf, tracking_conf = determine_initial_confidence(
                 quality_preset, expert_params
             )
 
@@ -479,7 +408,7 @@ def _process_single(
                 min_detection_confidence=detection_conf,
                 min_tracking_confidence=tracking_conf,
             )
-            frames, landmarks_sequence = _track_all_frames(video, tracker)
+            frames, landmarks_sequence = track_all_frames(video, tracker)
 
             if not landmarks_sequence:
                 click.echo("Error: No frames processed", err=True)
@@ -505,7 +434,7 @@ def _process_single(
                 )
 
             # Apply smoothing
-            smoothed_landmarks = _smooth_landmark_sequence(landmarks_sequence, params)
+            smoothed_landmarks = smooth_landmark_sequence(landmarks_sequence, params)
 
             # Extract foot positions
             vertical_positions, tracking_method = _extract_positions_from_landmarks(

kinemotion-0.11.4/src/kinemotion/core/cli_utils.py

@@ -0,0 +1,113 @@
+"""Shared CLI utilities for drop jump and CMJ analysis."""
+
+from typing import Any, Protocol
+
+import click
+
+from .auto_tuning import AutoTunedParams, QualityPreset
+from .pose import PoseTracker
+from .smoothing import smooth_landmarks, smooth_landmarks_advanced
+from .video_io import VideoProcessor
+
+
+class ExpertParameters(Protocol):
+    """Protocol for expert parameter overrides."""
+
+    detection_confidence: float | None
+    tracking_confidence: float | None
+
+
+def determine_initial_confidence(
+    quality_preset: QualityPreset,
+    expert_params: ExpertParameters,
+) -> tuple[float, float]:
+    """Determine initial detection and tracking confidence levels.
+
+    Args:
+        quality_preset: Quality preset enum
+        expert_params: Expert parameter overrides
+
+    Returns:
+        Tuple of (detection_confidence, tracking_confidence)
+    """
+    initial_detection_conf = 0.5
+    initial_tracking_conf = 0.5
+
+    if quality_preset == QualityPreset.FAST:
+        initial_detection_conf = 0.3
+        initial_tracking_conf = 0.3
+    elif quality_preset == QualityPreset.ACCURATE:
+        initial_detection_conf = 0.6
+        initial_tracking_conf = 0.6
+
+    # Override with expert values if provided
+    if expert_params.detection_confidence is not None:
+        initial_detection_conf = expert_params.detection_confidence
+    if expert_params.tracking_confidence is not None:
+        initial_tracking_conf = expert_params.tracking_confidence
+
+    return initial_detection_conf, initial_tracking_conf
+
+
+def track_all_frames(video: VideoProcessor, tracker: PoseTracker) -> tuple[list, list]:
+    """Track pose landmarks in all video frames.
+
+    Args:
+        video: Video processor
+        tracker: Pose tracker
+
+    Returns:
+        Tuple of (frames, landmarks_sequence)
+    """
+    click.echo("Tracking pose landmarks...", err=True)
+    landmarks_sequence = []
+    frames = []
+
+    bar: Any
+    with click.progressbar(length=video.frame_count, label="Processing frames") as bar:
+        while True:
+            frame = video.read_frame()
+            if frame is None:
+                break
+
+            frames.append(frame)
+            landmarks = tracker.process_frame(frame)
+            landmarks_sequence.append(landmarks)
+            bar.update(1)
+
+    tracker.close()
+    return frames, landmarks_sequence
+
+
+def smooth_landmark_sequence(landmarks_sequence: list, params: AutoTunedParams) -> list:
+    """Apply smoothing to landmark sequence.
+
+    Args:
+        landmarks_sequence: Raw landmark sequence
+        params: Auto-tuned parameters
+
+    Returns:
+        Smoothed landmark sequence
+    """
+    if params.outlier_rejection or params.bilateral_filter:
+        if params.outlier_rejection:
+            click.echo("Smoothing landmarks with outlier rejection...", err=True)
+        if params.bilateral_filter:
+            click.echo(
+                "Using bilateral temporal filter for edge-preserving smoothing...",
+                err=True,
+            )
+        return smooth_landmarks_advanced(
+            landmarks_sequence,
+            window_length=params.smoothing_window,
+            polyorder=params.polyorder,
+            use_outlier_rejection=params.outlier_rejection,
+            use_bilateral=params.bilateral_filter,
+        )
+    else:
+        click.echo("Smoothing landmarks...", err=True)
+        return smooth_landmarks(
+            landmarks_sequence,
+            window_length=params.smoothing_window,
+            polyorder=params.polyorder,
+        )

{kinemotion-0.11.2 → kinemotion-0.11.4}/src/kinemotion/dropjump/cli.py

@@ -21,8 +21,12 @@ from ..core.auto_tuning import (
     analyze_video_sample,
     auto_tune_parameters,
 )
+from ..core.cli_utils import (
+    determine_initial_confidence,
+    smooth_landmark_sequence,
+    track_all_frames,
+)
 from ..core.pose import PoseTracker
-from ..core.smoothing import smooth_landmarks, smooth_landmarks_advanced
 from ..core.video_io import VideoProcessor
 from .analysis import (
     ContactState,
@@ -256,69 +260,6 @@ def dropjump_analyze(  # NOSONAR(S107) - Click CLI requires individual parameter
         )
 
 
-def _determine_initial_confidence(
-    quality_preset: QualityPreset,
-    expert_params: AnalysisParameters,
-) -> tuple[float, float]:
-    """Determine initial detection and tracking confidence levels.
-
-    Args:
-        quality_preset: Quality preset enum
-        expert_params: Expert parameter overrides
-
-    Returns:
-        Tuple of (detection_confidence, tracking_confidence)
-    """
-    initial_detection_conf = 0.5
-    initial_tracking_conf = 0.5
-
-    if quality_preset == QualityPreset.FAST:
-        initial_detection_conf = 0.3
-        initial_tracking_conf = 0.3
-    elif quality_preset == QualityPreset.ACCURATE:
-        initial_detection_conf = 0.6
-        initial_tracking_conf = 0.6
-
-    # Override with expert values if provided
-    if expert_params.detection_confidence is not None:
-        initial_detection_conf = expert_params.detection_confidence
-    if expert_params.tracking_confidence is not None:
-        initial_tracking_conf = expert_params.tracking_confidence
-
-    return initial_detection_conf, initial_tracking_conf
-
-
-def _track_all_frames(video: VideoProcessor, tracker: PoseTracker) -> tuple[list, list]:
-    """Track pose landmarks in all video frames.
-
-    Args:
-        video: Video processor
-        tracker: Pose tracker
-
-    Returns:
-        Tuple of (frames, landmarks_sequence)
-    """
-    click.echo("Tracking pose landmarks...", err=True)
-    landmarks_sequence = []
-    frames = []
-
-    bar: Any
-    with click.progressbar(length=video.frame_count, label="Processing frames") as bar:
-        while True:
-            frame = video.read_frame()
-            if frame is None:
-                break
-
-            frames.append(frame)
-            landmarks = tracker.process_frame(frame)
-            landmarks_sequence.append(landmarks)
-
-            bar.update(1)
-
-    tracker.close()
-    return frames, landmarks_sequence
-
-
 def _apply_expert_param_overrides(
     params: AutoTunedParams, expert_params: AnalysisParameters
 ) -> AutoTunedParams:
@@ -380,42 +321,6 @@ def _print_auto_tuned_params(
     click.echo("=" * 60 + "\n", err=True)
 
 
-def _smooth_landmark_sequence(
-    landmarks_sequence: list, params: AutoTunedParams
-) -> list:
-    """Apply smoothing to landmark sequence.
-
-    Args:
-        landmarks_sequence: Raw landmark sequence
-        params: Auto-tuned parameters
-
-    Returns:
-        Smoothed landmarks
-    """
-    if params.outlier_rejection or params.bilateral_filter:
-        if params.outlier_rejection:
-            click.echo("Smoothing landmarks with outlier rejection...", err=True)
-        if params.bilateral_filter:
-            click.echo(
-                "Using bilateral temporal filter for edge-preserving smoothing...",
-                err=True,
-            )
-        return smooth_landmarks_advanced(
-            landmarks_sequence,
-            window_length=params.smoothing_window,
-            polyorder=params.polyorder,
-            use_outlier_rejection=params.outlier_rejection,
-            use_bilateral=params.bilateral_filter,
-        )
-    else:
-        click.echo("Smoothing landmarks...", err=True)
-        return smooth_landmarks(
-            landmarks_sequence,
-            window_length=params.smoothing_window,
-            polyorder=params.polyorder,
-        )
-
-
 def _extract_positions_and_visibilities(
     smoothed_landmarks: list,
 ) -> tuple[np.ndarray, np.ndarray]:
@@ -533,7 +438,7 @@ def _process_single(
             )
 
             # Determine confidence levels
-            detection_conf, tracking_conf = _determine_initial_confidence(
+            detection_conf, tracking_conf = determine_initial_confidence(
                 quality_preset, expert_params
             )
 
@@ -542,7 +447,7 @@ def _process_single(
                 min_detection_confidence=detection_conf,
                 min_tracking_confidence=tracking_conf,
             )
-            frames, landmarks_sequence = _track_all_frames(video, tracker)
+            frames, landmarks_sequence = track_all_frames(video, tracker)
 
             if not landmarks_sequence:
                 click.echo("Error: No frames processed", err=True)
@@ -560,7 +465,7 @@ def _process_single(
                 _print_auto_tuned_params(video, characteristics, quality_preset, params)
 
             # Apply smoothing
-            smoothed_landmarks = _smooth_landmark_sequence(landmarks_sequence, params)
+            smoothed_landmarks = smooth_landmark_sequence(landmarks_sequence, params)
 
             # Extract positions
             vertical_positions, visibilities = _extract_positions_and_visibilities(

{kinemotion-0.11.2 → kinemotion-0.11.4}/uv.lock

@@ -603,7 +603,7 @@ wheels = [
 
 [[package]]
 name = "kinemotion"
-version = "0.11.2"
+version = "0.11.4"
 source = { editable = "." }
 dependencies = [
     { name = "click" },