kinemotion 0.40.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

kinemotion/core/__init__.py

@@ -22,6 +22,7 @@ from .smoothing import (
     smooth_landmarks,
     smooth_landmarks_advanced,
 )
+from .timing import PerformanceTimer
 from .video_io import VideoProcessor
 
 __all__ = [
@@ -46,6 +47,8 @@ __all__ = [
     "QualityIndicators",
     "assess_jump_quality",
     "calculate_position_stability",
+    # Timing
+    "PerformanceTimer",
     # Video I/O
     "VideoProcessor",
 ]

kinemotion/core/debug_overlay_utils.py

@@ -121,6 +121,8 @@ class BaseDebugOverlayRenderer:
         self.height = height
         self.display_width = display_width
         self.display_height = display_height
+        # Duration of ffmpeg re-encoding (0.0 if not needed)
+        self.reencode_duration_s = 0.0
         self.writer, self.needs_resize, self.used_codec = create_video_writer(
             output_path, width, height, display_width, display_height, fps
         )
@@ -201,8 +203,8 @@ class BaseDebugOverlayRenderer:
                     stdout=subprocess.DEVNULL,
                     stderr=subprocess.PIPE,
                 )
-                reencode_duration = time.time() - reencode_start
-                print(f"Debug video re-encoded in {reencode_duration:.2f}s")
+                self.reencode_duration_s = time.time() - reencode_start
+                print(f"Debug video re-encoded in {self.reencode_duration_s:.2f}s")
 
                 # Overwrite original file
                 os.replace(temp_path, self.output_path)

kinemotion/core/metadata.py

@@ -49,21 +49,29 @@ class ProcessingInfo:
         timestamp: ISO 8601 timestamp of when analysis was performed
         quality_preset: Quality preset used ("fast", "balanced", "accurate")
         processing_time_s: Time taken to process video in seconds
+        timing_breakdown: Optional dict mapping stage names to duration in seconds
     """
 
     version: str
     timestamp: str
     quality_preset: str
     processing_time_s: float
+    timing_breakdown: dict[str, float] | None = None
 
     def to_dict(self) -> dict:
         """Convert to JSON-serializable dictionary."""
-        return {
+        result: dict = {
             "version": self.version,
             "timestamp": self.timestamp,
             "quality_preset": self.quality_preset,
             "processing_time_s": round(self.processing_time_s, 3),
         }
+        if self.timing_breakdown:
+            result["timing_breakdown_ms"] = {
+                stage: round(duration * 1000, 1)
+                for stage, duration in self.timing_breakdown.items()
+            }
+        return result
 
 
 @dataclass

kinemotion/core/pose.py

@@ -4,6 +4,8 @@ import cv2
 import mediapipe as mp
 import numpy as np
 
+from .timing import PerformanceTimer
+
 
 class PoseTracker:
     """Tracks human pose landmarks in video frames using MediaPipe."""
@@ -12,14 +14,17 @@ class PoseTracker:
         self,
         min_detection_confidence: float = 0.5,
         min_tracking_confidence: float = 0.5,
-    ):
+        timer: PerformanceTimer | None = None,
+    ) -> None:
         """
         Initialize the pose tracker.
 
         Args:
             min_detection_confidence: Minimum confidence for pose detection
             min_tracking_confidence: Minimum confidence for pose tracking
+            timer: Optional PerformanceTimer for measuring operations
         """
+        self.timer = timer
         self.mp_pose = mp.solutions.pose
         self.pose = self.mp_pose.Pose(
             static_image_mode=False,  # Use tracking mode for better performance
@@ -45,7 +50,11 @@ class PoseTracker:
         rgb_frame = cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)
 
         # Process the frame
-        results = self.pose.process(rgb_frame)
+        if self.timer:
+            with self.timer.measure("mediapipe_inference"):
+                results = self.pose.process(rgb_frame)
+        else:
+            results = self.pose.process(rgb_frame)
 
         if not results.pose_landmarks:
             return None

kinemotion/core/timing.py

@@ -0,0 +1,49 @@
+"""Timing utilities for performance profiling."""
+
+import time
+from collections.abc import Generator
+from contextlib import contextmanager
+
+
+class PerformanceTimer:
+    """Simple timer for tracking execution duration of named steps.
+
+    Uses context manager pattern for clean, testable timing instrumentation.
+    Accumulates timing data in metrics dictionary accessible via get_metrics().
+    """
+
+    def __init__(self) -> None:
+        """Initialize timer with empty metrics dictionary."""
+        self.metrics: dict[str, float] = {}
+
+    @contextmanager
+    def measure(self, name: str) -> Generator[None, None, None]:
+        """Context manager to measure execution time of a block.
+
+        Args:
+            name: Name of the step being measured (e.g., "pose_tracking")
+
+        Yields:
+            None
+
+        Example:
+            timer = PerformanceTimer()
+            with timer.measure("video_initialization"):
+                # code to measure
+                pass
+            metrics = timer.get_metrics()  # {"video_initialization": 0.123}
+        """
+        start_time = time.time()
+        try:
+            yield
+        finally:
+            duration = time.time() - start_time
+            self.metrics[name] = duration
+
+    def get_metrics(self) -> dict[str, float]:
+        """Get collected timing metrics in seconds.
+
+        Returns:
+            A copy of the metrics dictionary to prevent external modification.
+        """
+        return self.metrics.copy()

kinemotion/core/video_io.py

@@ -7,6 +7,8 @@ import warnings
 import cv2
 import numpy as np
 
+from .timing import PerformanceTimer
+
 
 class VideoProcessor:
     """
@@ -16,14 +18,16 @@ class VideoProcessor:
     No dimensions are hardcoded - all dimensions are extracted from actual frame data.
     """
 
-    def __init__(self, video_path: str):
+    def __init__(self, video_path: str, timer: PerformanceTimer | None = None) -> None:
         """
         Initialize video processor.
 
         Args:
             video_path: Path to input video file
+            timer: Optional PerformanceTimer for measuring operations
         """
         self.video_path = video_path
+        self.timer = timer
         self.cap = cv2.VideoCapture(video_path)
 
         if not self.cap.isOpened():
@@ -175,7 +179,12 @@ class VideoProcessor:
         OpenCV ignores rotation metadata, so we manually apply rotation
         based on the display matrix metadata extracted from the video.
         """
-        ret, frame = self.cap.read()
+        if self.timer:
+            with self.timer.measure("frame_read"):
+                ret, frame = self.cap.read()
+        else:
+            ret, frame = self.cap.read()
+
         if not ret:
             return None
 

{kinemotion-0.40.0.dist-info → kinemotion-0.41.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.40.0
+Version: 0.41.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

{kinemotion-0.40.0.dist-info → kinemotion-0.41.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 kinemotion/__init__.py,sha256=wPItmyGJUOFM6GPRVhAEvRz0-ErI7e2qiUREYJ9EfPQ,943
-kinemotion/api.py,sha256=1MsBvkznlP_OaBZ37a0hG9uMTESv2iJMHR01tnPv5sA,41046
+kinemotion/api.py,sha256=B_orKAJ5KNsL5zse5B0s4pumT_4OcAVoxdSEa3N9qMY,52843
 kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
 kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
 kinemotion/cmj/analysis.py,sha256=qtULzp9uYzm5M0_Qu5YGJpuwjg9fz1VKAg6xg4NJxvM,21639
@@ -9,20 +9,21 @@ kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKt
 kinemotion/cmj/kinematics.py,sha256=Lq9m9MNQxnXv31VhKmXVrlM7rRkhi8PxW50N_CC8_8Y,11860
 kinemotion/cmj/metrics_validator.py,sha256=V_fmlczYH06SBtwqESv-IfGi3wDsIy3RQbd7VwOyNo0,31359
 kinemotion/cmj/validation_bounds.py,sha256=9ZTo68fl3ooyWjXXyTMRLpK9tFANa_rQf3oHhq7iQGE,11995
-kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
+kinemotion/core/__init__.py,sha256=GTLnE_gGIk7HC51epWUXVuNxcvS5lf7UL6qeWRlgMV0,1352
 kinemotion/core/auto_tuning.py,sha256=wtCUMOhBChVJNXfEeku3GCMW4qED6MF-O_mv2sPTiVQ,11324
 kinemotion/core/cli_utils.py,sha256=zbnifPhD-OYofJioeYfJtshuWcl8OAEWtqCGVF4ctAI,7966
-kinemotion/core/debug_overlay_utils.py,sha256=-HRHw5Ew7hVH0MWwdutZV1JwPqQwzQ6Jex7xHWc3q88,7511
+kinemotion/core/debug_overlay_utils.py,sha256=sUx_A14iZkJJjmUVeqvD_g2zAO9PwlzF3xrP4FLuiTc,7625
 kinemotion/core/determinism.py,sha256=NwVrHqJiVxxFHTBPVy8aDBJH2SLIcYIpdGFp7glblB8,2515
 kinemotion/core/experimental.py,sha256=IK05AF4aZS15ke85hF3TWCqRIXU1AlD_XKzFz735Ua8,3640
 kinemotion/core/filtering.py,sha256=GsC9BB71V07LJJHgS2lsaxUAtJsupcUiwtZFDgODh8c,11417
 kinemotion/core/formatting.py,sha256=G_3eqgOtym9RFOZVEwCxye4A2cyrmgvtQ214vIshowU,2480
-kinemotion/core/metadata.py,sha256=iz9YdkesHo-85TVBCoQVn7zkbrSde_fqjU79s_b-TZk,6829
-kinemotion/core/pose.py,sha256=MQa7ebbuvk_vxJzVlwARKvEaJOqSFJMRRap2dz0O__0,8613
+kinemotion/core/metadata.py,sha256=bJAVa4nym__zx1hNowSZduMGKBSGOPxTbBQkjm6N0D0,7207
+kinemotion/core/pose.py,sha256=Tq4VS0YmMzrprVUsELm6FQczyLhP8UKurM9ccYn1LLU,8959
 kinemotion/core/quality.py,sha256=dPGQp08y8DdEUbUdjTThnUOUsALgF0D2sdz50cm6wLI,13098
 kinemotion/core/smoothing.py,sha256=GAfC-jxu1eqNyDjsUXqUBicKx9um5hrk49wz1FxfRNM,15219
+kinemotion/core/timing.py,sha256=bdRg1g7J0-eWB3oj7tEF5Ucp_tiad1IxsM14edAZQu4,1484
 kinemotion/core/validation.py,sha256=LmKfSl4Ayw3DgwKD9IrhsPdzp5ia4drLsHA2UuU1SCM,6310
-kinemotion/core/video_io.py,sha256=fDdyYVIKqUSgCjBJa8l_S0SrDPDAhrWYfsDBNRuz1oM,7549
+kinemotion/core/video_io.py,sha256=Nn5xIt4iZCQxaP9g0cpWFeNsz5AgUlWbZ_B8ZCfd4lw,7869
 kinemotion/dropjump/__init__.py,sha256=tC3H3BrCg8Oj-db-Vrtx4PH_llR1Ppkd5jwaOjhQcLg,862
 kinemotion/dropjump/analysis.py,sha256=MjxO-vps0nz_hXlnGk7cgq3jFenJYzsM0VVpHwnHXsM,27935
 kinemotion/dropjump/cli.py,sha256=n_Wfv3AC6YIgRPYhO3F2nTSai0NR7fh95nAoWjryQeY,16250
@@ -31,8 +32,8 @@ kinemotion/dropjump/kinematics.py,sha256=kH-XM66wlOCYMpjvyb6_Qh5ZebyOfFZ47rmhgE1
 kinemotion/dropjump/metrics_validator.py,sha256=CrTlGup8q2kyPXtA6HNwm7_yq0AsBaDllG7RVZdXmYA,9342
 kinemotion/dropjump/validation_bounds.py,sha256=5b4I3CKPybuvrbn-nP5yCcGF_sH4Vtyw3a5AWWvWnBk,4645
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.40.0.dist-info/METADATA,sha256=0X_uEEzEi-DH9d4HwfseQVEzlDmbJRw96Dn1o-m5DbI,26020
-kinemotion-0.40.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-kinemotion-0.40.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.40.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.40.0.dist-info/RECORD,,
+kinemotion-0.41.0.dist-info/METADATA,sha256=EBKGUp37-fef8bfIS_ourVqYqVHUQGRAhwQoTH1Y4sU,26020
+kinemotion-0.41.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.41.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.41.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.41.0.dist-info/RECORD,,