kinemotion 0.30.0__py3-none-any.whl → 0.31.1__py3-none-any.whl

kinemotion/api.py

@@ -62,7 +62,8 @@ def _parse_quality_preset(quality: str) -> QualityPreset:
         return QualityPreset(quality.lower())
     except ValueError as e:
         raise ValueError(
-            f"Invalid quality preset: {quality}. Must be 'fast', 'balanced', or 'accurate'"
+            f"Invalid quality preset: {quality}. "
+            "Must be 'fast', 'balanced', or 'accurate'"
         ) from e
 
 
@@ -501,7 +502,8 @@ def process_dropjump_video(
         if verbose:
             print("Assessing tracking quality...")
 
-        # Detect outliers for quality scoring (doesn't affect results, just for assessment)
+        # Detect outliers for quality scoring (doesn't affect results, just
+        # for assessment)
         _, outlier_mask = reject_outliers(
             vertical_positions,
             use_ransac=True,
@@ -626,9 +628,11 @@ def process_dropjump_videos_bulk(
     Process multiple drop jump videos in parallel using ProcessPoolExecutor.
 
     Args:
-        configs: List of DropJumpVideoConfig objects specifying video paths and parameters
+        configs: List of DropJumpVideoConfig objects specifying video paths
+            and parameters
         max_workers: Maximum number of parallel workers (default: 4)
-        progress_callback: Optional callback function called after each video completes.
+        progress_callback: Optional callback function called after each video
+            completes.
                          Receives DropJumpVideoResult object.
 
     Returns:
@@ -953,7 +957,8 @@ def process_cmj_video(
         if verbose:
             print("Assessing tracking quality...")
 
-        # Detect outliers for quality scoring (doesn't affect results, just for assessment)
+        # Detect outliers for quality scoring (doesn't affect results, just
+        # for assessment)
         _, outlier_mask = reject_outliers(
             vertical_positions,
             use_ransac=True,
@@ -1047,7 +1052,7 @@ def process_cmj_video(
 
         if verbose:
             print(f"\nJump height: {metrics.jump_height:.3f}m")
-            print(f"Flight time: {metrics.flight_time*1000:.1f}ms")
+            print(f"Flight time: {metrics.flight_time * 1000:.1f}ms")
             print(f"Countermovement depth: {metrics.countermovement_depth:.3f}m")
 
         # Validate metrics against physiological bounds
@@ -1126,7 +1131,8 @@ def process_cmj_videos_bulk(
 
 def _process_cmj_video_wrapper(config: CMJVideoConfig) -> CMJVideoResult:
     """
-    Wrapper function for parallel CMJ processing. Must be picklable (top-level function).
+    Wrapper function for parallel CMJ processing. Must be picklable
+    (top-level function).
 
     Args:
         config: CMJVideoConfig object with processing parameters

kinemotion/cmj/analysis.py

@@ -62,7 +62,8 @@ def find_standing_phase(
     """
     Find the end of standing phase (start of countermovement).
 
-    Looks for a period of low velocity (standing) followed by consistent downward motion.
+    Looks for a period of low velocity (standing) followed by consistent
+    downward motion.
 
     Args:
         positions: Array of vertical positions (normalized 0-1)
@@ -109,11 +110,13 @@ def find_countermovement_start(
     """
     Find the start of countermovement (eccentric phase).
 
-    Detects when velocity becomes consistently positive (downward motion in normalized coords).
+    Detects when velocity becomes consistently positive (downward motion in
+    normalized coords).
 
     Args:
         velocities: Array of SIGNED vertical velocities
-        countermovement_threshold: Velocity threshold for detecting downward motion (POSITIVE)
+        countermovement_threshold: Velocity threshold for detecting downward
+            motion (POSITIVE)
         min_eccentric_frames: Minimum consecutive frames of downward motion
         standing_start: Optional frame where standing phase ended
 

kinemotion/cmj/cli.py

@@ -177,7 +177,8 @@ def _process_batch_videos(
     default=None,
     help="[EXPERT] Override pose tracking confidence",
 )
-def cmj_analyze(  # NOSONAR(S107) - Click CLI requires individual parameters for each option
+def cmj_analyze(  # NOSONAR(S107) - Click CLI requires individual parameters
+    # for each option
     video_path: tuple[str, ...],
     output: str | None,
     json_output: str | None,
@@ -197,10 +198,12 @@ def cmj_analyze(  # NOSONAR(S107) - Click CLI requires individual parameters for
     tracking_confidence: float | None,
 ) -> None:
     """
-    Analyze counter movement jump (CMJ) video(s) to estimate jump performance metrics.
+    Analyze counter movement jump (CMJ) video(s) to estimate jump performance
+    metrics.
 
-    Uses intelligent auto-tuning to select optimal parameters based on video characteristics.
-    Parameters are automatically adjusted for frame rate, tracking quality, and analysis preset.
+    Uses intelligent auto-tuning to select optimal parameters based on video
+    characteristics. Parameters are automatically adjusted for frame rate,
+    tracking quality, and analysis preset.
 
     VIDEO_PATH: Path(s) to video file(s). Supports glob patterns in batch mode.
 
@@ -341,11 +344,13 @@ def _output_results(metrics: Any, json_output: str | None) -> None:
         f"Total movement time: {metrics.total_movement_time * 1000:.1f} ms", err=True
     )
     click.echo(
-        f"Peak eccentric velocity: {abs(metrics.peak_eccentric_velocity):.3f} m/s (downward)",
+        f"Peak eccentric velocity: {abs(metrics.peak_eccentric_velocity):.3f} "
+        "m/s (downward)",
         err=True,
     )
     click.echo(
-        f"Peak concentric velocity: {metrics.peak_concentric_velocity:.3f} m/s (upward)",
+        f"Peak concentric velocity: {metrics.peak_concentric_velocity:.3f} "
+        "m/s (upward)",
         err=True,
     )
     if metrics.transition_time is not None:

kinemotion/cmj/debug_overlay.py

@@ -370,10 +370,10 @@ class CMJDebugOverlayRenderer(BaseDebugOverlayRenderer):
 
         metrics_text = [
             f"Jump Height: {metrics.jump_height:.3f}m",
-            f"Flight Time: {metrics.flight_time*1000:.0f}ms",
+            f"Flight Time: {metrics.flight_time * 1000:.0f}ms",
             f"CM Depth: {metrics.countermovement_depth:.3f}m",
-            f"Ecc Duration: {metrics.eccentric_duration*1000:.0f}ms",
-            f"Con Duration: {metrics.concentric_duration*1000:.0f}ms",
+            f"Ecc Duration: {metrics.eccentric_duration * 1000:.0f}ms",
+            f"Con Duration: {metrics.concentric_duration * 1000:.0f}ms",
         ]
 
         # Draw background

kinemotion/cmj/kinematics.py

@@ -48,12 +48,17 @@ class CMJMetrics:
     Attributes:
         jump_height: Maximum jump height in meters
         flight_time: Time spent in the air in milliseconds
-        countermovement_depth: Vertical distance traveled during eccentric phase in meters
-        eccentric_duration: Time from countermovement start to lowest point in milliseconds
+        countermovement_depth: Vertical distance traveled during eccentric
+            phase in meters
+        eccentric_duration: Time from countermovement start to lowest point in
+            milliseconds
         concentric_duration: Time from lowest point to takeoff in milliseconds
-        total_movement_time: Total time from countermovement start to takeoff in milliseconds
-        peak_eccentric_velocity: Maximum downward velocity during countermovement in m/s
-        peak_concentric_velocity: Maximum upward velocity during propulsion in m/s
+        total_movement_time: Total time from countermovement start to takeoff
+            in milliseconds
+        peak_eccentric_velocity: Maximum downward velocity during
+            countermovement in m/s
+        peak_concentric_velocity: Maximum upward velocity during propulsion in
+            m/s
         transition_time: Duration at lowest point (amortization phase) in milliseconds
         standing_start_frame: Frame where standing phase ends (countermovement begins)
         lowest_point_frame: Frame at lowest point of countermovement

kinemotion/core/cli_utils.py

@@ -120,8 +120,10 @@ def print_auto_tuned_params(
         video: Video processor
         quality_preset: Quality preset
         params: Auto-tuned parameters
-        characteristics: Optional video characteristics (for tracking quality display)
-        extra_params: Optional extra parameters to display (e.g., countermovement_threshold)
+        characteristics: Optional video characteristics (for tracking quality
+            display)
+        extra_params: Optional extra parameters to display (e.g.,
+            countermovement_threshold)
     """
     click.echo("\n" + "=" * 60, err=True)
     click.echo("AUTO-TUNED PARAMETERS", err=True)

kinemotion/core/cmj_metrics_validator.py

@@ -236,7 +236,8 @@ class CMJMetricsValidator:
         elif bounds.contains(flight_time, profile):
             result.add_info(
                 "flight_time",
-                f"Flight time {flight_time:.3f}s within expected range for {profile.value}",
+                f"Flight time {flight_time:.3f}s within expected range for "
+                f"{profile.value}",
                 value=flight_time,
             )
         else:
@@ -278,7 +279,8 @@ class CMJMetricsValidator:
         elif bounds.contains(jump_height, profile):
             result.add_info(
                 "jump_height",
-                f"Jump height {jump_height:.3f}m within expected range for {profile.value}",
+                f"Jump height {jump_height:.3f}m within expected range for "
+                f"{profile.value}",
                 value=jump_height,
             )
         else:
@@ -319,7 +321,8 @@ class CMJMetricsValidator:
         elif bounds.contains(depth, profile):
             result.add_info(
                 "countermovement_depth",
-                f"Countermovement depth {depth:.3f}m within expected range for {profile.value}",
+                f"Countermovement depth {depth:.3f}m within expected range for "
+                f"{profile.value}",
                 value=depth,
             )
         else:
@@ -353,14 +356,16 @@ class CMJMetricsValidator:
             else:
                 result.add_error(
                     "concentric_duration",
-                    f"Concentric duration {duration:.3f}s likely includes standing phase",
+                    f"Concentric duration {duration:.3f}s likely includes "
+                    "standing phase",
                     value=duration,
                     bounds=(bounds.absolute_min, bounds.absolute_max),
                 )
         elif bounds.contains(duration, profile):
             result.add_info(
                 "concentric_duration",
-                f"Concentric duration {duration:.3f}s within expected range for {profile.value}",
+                f"Concentric duration {duration:.3f}s within expected range for "
+                f"{profile.value}",
                 value=duration,
             )
         else:
@@ -393,7 +398,8 @@ class CMJMetricsValidator:
         elif bounds.contains(duration, profile):
             result.add_info(
                 "eccentric_duration",
-                f"Eccentric duration {duration:.3f}s within expected range for {profile.value}",
+                f"Eccentric duration {duration:.3f}s within expected range for "
+                f"{profile.value}",
                 value=duration,
             )
         else:
@@ -424,7 +430,8 @@ class CMJMetricsValidator:
             elif bounds.contains(ecc_vel, profile):
                 result.add_info(
                     "peak_eccentric_velocity",
-                    f"Peak eccentric velocity {ecc_vel:.2f} m/s within range for {profile.value}",
+                    f"Peak eccentric velocity {ecc_vel:.2f} m/s within range "
+                    f"for {profile.value}",
                     value=ecc_vel,
                 )
             else:
@@ -445,21 +452,24 @@ class CMJMetricsValidator:
                 if con_vel < bounds.absolute_min:
                     result.add_error(
                         "peak_concentric_velocity",
-                        f"Peak concentric velocity {con_vel:.2f} m/s insufficient to leave ground",
+                        f"Peak concentric velocity {con_vel:.2f} m/s "
+                        "insufficient to leave ground",
                         value=con_vel,
                         bounds=(bounds.absolute_min, bounds.absolute_max),
                     )
                 else:
                     result.add_error(
                         "peak_concentric_velocity",
-                        f"Peak concentric velocity {con_vel:.2f} m/s exceeds elite capability",
+                        f"Peak concentric velocity {con_vel:.2f} m/s exceeds "
+                        "elite capability",
                         value=con_vel,
                         bounds=(bounds.absolute_min, bounds.absolute_max),
                     )
             elif bounds.contains(con_vel, profile):
                 result.add_info(
                     "peak_concentric_velocity",
-                    f"Peak concentric velocity {con_vel:.2f} m/s within range for {profile.value}",
+                    f"Peak concentric velocity {con_vel:.2f} m/s within range "
+                    f"for {profile.value}",
                     value=con_vel,
                 )
             else:
@@ -492,15 +502,17 @@ class CMJMetricsValidator:
         if error_pct > MetricConsistency.HEIGHT_FLIGHT_TIME_TOLERANCE:
             result.add_error(
                 "height_flight_time_consistency",
-                f"Jump height {jump_height:.3f}m inconsistent with flight time {flight_time:.3f}s "
-                f"(expected {expected_height:.3f}m, error {error_pct*100:.1f}%)",
+                f"Jump height {jump_height:.3f}m inconsistent with flight "
+                f"time {flight_time:.3f}s (expected {expected_height:.3f}m, "
+                f"error {error_pct * 100:.1f}%)",
                 value=error_pct,
                 bounds=(0, MetricConsistency.HEIGHT_FLIGHT_TIME_TOLERANCE),
             )
         else:
             result.add_info(
                 "height_flight_time_consistency",
-                f"Jump height and flight time consistent (error {error_pct*100:.1f}%)",
+                f"Jump height and flight time consistent "
+                f"(error {error_pct * 100:.1f}%)",
                 value=error_pct,
             )
 
@@ -525,7 +537,7 @@ class CMJMetricsValidator:
             error_msg = (
                 f"Peak velocity {velocity:.2f} m/s inconsistent with "
                 f"jump height {jump_height:.3f}m (expected {expected_velocity:.2f} "
-                f"m/s, error {error_pct*100:.1f}%)"
+                f"m/s, error {error_pct * 100:.1f}%)"
             )
             result.add_warning(
                 "velocity_height_consistency",
@@ -536,7 +548,8 @@ class CMJMetricsValidator:
         else:
             result.add_info(
                 "velocity_height_consistency",
-                f"Peak velocity and jump height consistent (error {error_pct*100:.1f}%)",
+                f"Peak velocity and jump height consistent "
+                f"(error {error_pct * 100:.1f}%)",
                 value=error_pct,
             )
 
@@ -577,14 +590,16 @@ class CMJMetricsValidator:
             if expected_min <= rsi <= expected_max:
                 result.add_info(
                     "rsi",
-                    f"RSI {rsi:.2f} within expected range [{expected_min:.2f}-{expected_max:.2f}] "
+                    f"RSI {rsi:.2f} within expected range "
+                    f"[{expected_min:.2f}-{expected_max:.2f}] "
                     f"for {profile.value}",
                     value=rsi,
                 )
             else:
                 result.add_warning(
                     "rsi",
-                    f"RSI {rsi:.2f} outside typical range [{expected_min:.2f}-{expected_max:.2f}] "
+                    f"RSI {rsi:.2f} outside typical range "
+                    f"[{expected_min:.2f}-{expected_max:.2f}] "
                     f"for {profile.value}",
                     value=rsi,
                     bounds=(expected_min, expected_max),
@@ -650,7 +665,8 @@ class CMJMetricsValidator:
         if ratio < MetricConsistency.CONTACT_DEPTH_RATIO_MIN:
             result.add_warning(
                 "contact_depth_ratio",
-                f"Contact time {ratio:.2f}s/m to depth ratio: Very fast for depth traversed",
+                f"Contact time {ratio:.2f}s/m to depth ratio: Very fast for "
+                "depth traversed",
                 value=ratio,
                 bounds=(
                     MetricConsistency.CONTACT_DEPTH_RATIO_MIN,
@@ -702,7 +718,8 @@ class CMJMetricsValidator:
             if not TripleExtensionBounds.knee_angle_valid(knee, profile):
                 result.add_warning(
                     "knee_angle",
-                    f"Knee angle {knee:.1f}° outside expected range for {profile.value}",
+                    f"Knee angle {knee:.1f}° outside expected range for "
+                    f"{profile.value}",
                     value=knee,
                 )
             else:
@@ -717,13 +734,15 @@ class CMJMetricsValidator:
             if not TripleExtensionBounds.ankle_angle_valid(ankle, profile):
                 result.add_warning(
                     "ankle_angle",
-                    f"Ankle angle {ankle:.1f}° outside expected range for {profile.value}",
+                    f"Ankle angle {ankle:.1f}° outside expected range for "
+                    f"{profile.value}",
                     value=ankle,
                 )
             else:
                 result.add_info(
                     "ankle_angle",
-                    f"Ankle angle {ankle:.1f}° within expected range for {profile.value}",
+                    f"Ankle angle {ankle:.1f}° within expected range for "
+                    f"{profile.value}",
                     value=ankle,
                 )
 

kinemotion/core/dropjump_metrics_validator.py

@@ -227,7 +227,8 @@ class DropJumpMetricsValidator:
             profile_name = result.athlete_profile.value
             result.add_warning(
                 "contact_time",
-                f"Contact time {contact_time_s:.3f}s unusual for {profile_name} athlete",
+                f"Contact time {contact_time_s:.3f}s unusual for "
+                f"{profile_name} athlete",
                 value=contact_time_s,
             )
 
@@ -285,7 +286,7 @@ class DropJumpMetricsValidator:
         contact_time_s = contact_time_ms / 1000.0
         flight_time_s = flight_time_ms / 1000.0
 
-        if contact_time_s > 0:
+        if contact_time_s > 0 and flight_time_s > 0:
             rsi = flight_time_s / contact_time_s
             result.rsi = rsi
             result.contact_flight_ratio = contact_time_s / flight_time_s
@@ -317,7 +318,8 @@ class DropJumpMetricsValidator:
         """Validate consistency between kinematic and trajectory-based heights.
 
         Kinematic height (h = g*t²/8) comes from flight time (objective).
-        Trajectory height comes from position tracking (subject to landmark detection noise).
+        Trajectory height comes from position tracking (subject to landmark
+        detection noise).
 
         Expected correlation: r > 0.95, absolute difference < 5% for quality video.
         """
@@ -336,8 +338,9 @@ class DropJumpMetricsValidator:
                 result.add_warning(
                     "height_consistency",
                     f"Kinematic ({jump_height_kinematic_m:.3f}m) and trajectory "
-                    f"({jump_height_trajectory_m:.3f}m) heights differ by {percent_error:.1f}%. "
-                    f"May indicate landmark detection issues or video quality problems.",
+                    f"({jump_height_trajectory_m:.3f}m) heights differ by "
+                    f"{percent_error:.1f}%. May indicate landmark detection "
+                    "issues or video quality problems.",
                     value=percent_error,
                     bounds=(0, 10),
                 )

kinemotion/core/metadata.py

@@ -146,7 +146,8 @@ class AlgorithmConfig:
     """Complete algorithm configuration for reproducibility.
 
     Attributes:
-        detection_method: Algorithm used ("backward_search" for CMJ, "forward_search" for drop)
+        detection_method: Algorithm used ("backward_search" for CMJ,
+            "forward_search" for drop)
         tracking_method: Pose tracking method ("mediapipe_pose")
         model_complexity: MediaPipe model complexity (0, 1, or 2)
         smoothing: Smoothing configuration

kinemotion/core/quality.py

@@ -307,8 +307,9 @@ def _generate_warnings(
     # Tracking stability warnings
     if not indicators.tracking_stable:
         warnings.append(
-            f"Unstable landmark tracking detected (variance {indicators.position_variance:.4f}). "
-            "This may indicate jitter or occlusion. Consider better lighting or camera position."
+            f"Unstable landmark tracking detected "
+            f"(variance {indicators.position_variance:.4f}). This may indicate "
+            "jitter or occlusion. Consider better lighting or camera position."
         )
 
     # Outlier warnings
@@ -349,8 +350,8 @@ def _generate_warnings(
     # Overall confidence warning
     if confidence == "low":
         warnings.append(
-            "⚠️ LOW CONFIDENCE: Results may be unreliable. "
-            "Review quality indicators and consider re-recording with better conditions."
+            "⚠️ LOW CONFIDENCE: Results may be unreliable. Review quality "
+            "indicators and consider re-recording with better conditions."
         )
     elif confidence == "medium":
         warnings.append(

kinemotion/core/smoothing.py

@@ -124,7 +124,8 @@ def _store_smoothed_landmarks(
             )
 
 
-def _smooth_landmarks_core(  # NOSONAR(S1172) - polyorder used via closure capture in smoother_fn
+def _smooth_landmarks_core(  # NOSONAR(S1172) - polyorder used via closure
+    # capture in smoother_fn
     landmark_sequence: LandmarkSequence,
     window_length: int,
     polyorder: int,
@@ -136,7 +137,8 @@ def _smooth_landmarks_core(  # NOSONAR(S1172) - polyorder used via closure captu
     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 (captured by smoother_fn closure)
+        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)
 

kinemotion/core/video_io.py

@@ -46,8 +46,9 @@ class VideoProcessor:
             self.width = int(self.cap.get(cv2.CAP_PROP_FRAME_WIDTH))
             self.height = int(self.cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
 
-        # Extract rotation metadata from video (iPhones store rotation in side_data_list)
-        # OpenCV ignores rotation metadata, so we need to extract and apply it manually
+        # Extract rotation metadata from video (iPhones store rotation in
+        # side_data_list). OpenCV ignores rotation metadata, so we need to
+        # extract and apply it manually
         self.rotation = 0  # Will be set by _extract_video_metadata()
 
         # Extract codec information from video metadata

kinemotion/dropjump/analysis.py

@@ -98,7 +98,8 @@ def _find_stable_baseline(
     """Find first stable period and return baseline position.
 
     Returns:
-        Tuple of (baseline_start_frame, baseline_position). Returns (-1, 0.0) if not found.
+        Tuple of (baseline_start_frame, baseline_position). Returns (-1, 0.0)
+        if not found.
     """
     stable_window = min_stable_frames
 
@@ -159,8 +160,8 @@ def _find_drop_from_baseline(
                     f"{position_change_threshold:.4f}"
                 )
                 print(
-                    f"  avg_position: {avg_position:.4f} vs "
-                    f"baseline: {baseline_position:.4f}"
+                    f"  avg_position: {avg_position:.4f} vs baseline: "
+                    f"{baseline_position:.4f}"
                 )
 
             return drop_frame
@@ -179,7 +180,8 @@ def detect_drop_start(
     debug: bool = False,
 ) -> int:
     """
-    Detect when the drop jump actually starts by finding stable period then detecting drop.
+    Detect when the drop jump actually starts by finding stable period then
+    detecting drop.
 
     Strategy:
     1. Scan forward to find first STABLE period (low variance over N frames)
@@ -191,7 +193,8 @@ def detect_drop_start(
     Args:
         positions: Array of vertical positions (0-1 normalized, y increases downward)
         fps: Video frame rate
-        min_stationary_duration: Minimum duration (seconds) of stable period (default: 1.0s)
+        min_stationary_duration: Minimum duration (seconds) of stable period
+            (default: 1.0s)
         position_change_threshold: Position change indicating start of drop
             (default: 0.02 = 2% of frame)
         smoothing_window: Window for computing position variance
@@ -832,9 +835,11 @@ def extract_foot_positions_and_visibilities(
     smoothed_landmarks: list[dict[str, tuple[float, float, float]] | None],
 ) -> tuple[np.ndarray, np.ndarray]:
     """
-    Extract vertical positions and average visibilities from smoothed landmarks.
+    Extract vertical positions and average visibilities from smoothed
+    landmarks.
 
-    This utility function eliminates code duplication between CLI and programmatic usage.
+    This utility function eliminates code duplication between CLI and
+    programmatic usage.
 
     Args:
         smoothed_landmarks: Smoothed landmark sequence from tracking

kinemotion/dropjump/cli.py

@@ -133,7 +133,8 @@ class AnalysisParameters:
     default=None,
     help="[EXPERT] Override pose tracking confidence",
 )
-def dropjump_analyze(  # NOSONAR(S107) - Click CLI requires individual parameters for each option
+def dropjump_analyze(  # NOSONAR(S107) - Click CLI requires individual
+    # parameters for each option
     video_path: tuple[str, ...],
     output: str | None,
     json_output: str | None,
@@ -153,10 +154,12 @@ def dropjump_analyze(  # NOSONAR(S107) - Click CLI requires individual parameter
     tracking_confidence: float | None,
 ) -> None:
     """
-    Analyze drop-jump video(s) to estimate ground contact time, flight time, and jump height.
+    Analyze drop-jump video(s) to estimate ground contact time, flight time,
+    and jump height.
 
-    Uses intelligent auto-tuning to select optimal parameters based on video characteristics.
-    Parameters are automatically adjusted for frame rate, tracking quality, and analysis preset.
+    Uses intelligent auto-tuning to select optimal parameters based on video
+    characteristics. Parameters are automatically adjusted for frame rate,
+    tracking quality, and analysis preset.
 
     VIDEO_PATH: Path(s) to video file(s). Supports glob patterns in batch mode
     (e.g., "videos/*.mp4").

kinemotion/dropjump/kinematics.py

@@ -235,7 +235,8 @@ def _identify_main_contact_phase(
         ]
 
         if ground_after_air and first_ground_idx < first_air_idx:
-            # Check if first ground is at higher elevation (lower y) than ground after air
+            # Check if first ground is at higher elevation (lower y) than
+            # ground after air
             first_ground_y = float(
                 np.mean(foot_y_positions[first_ground_start : first_ground_end + 1])
             )
@@ -394,8 +395,10 @@ def calculate_drop_jump_metrics(
         foot_y_positions: Vertical positions of feet (normalized 0-1)
         fps: Video frame rate
         drop_start_frame: Optional manual drop start frame
-        velocity_threshold: Velocity threshold used for contact detection (for interpolation)
-        smoothing_window: Window size for velocity/acceleration smoothing (must be odd)
+        velocity_threshold: Velocity threshold used for contact detection
+            (for interpolation)
+        smoothing_window: Window size for velocity/acceleration smoothing
+            (must be odd)
         polyorder: Polynomial order for Savitzky-Golay filter (default: 2)
         use_curvature: Whether to use curvature analysis for refining transitions
 

{kinemotion-0.30.0.dist-info → kinemotion-0.31.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.30.0
+Version: 0.31.1
 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.31.1.dist-info/RECORD

@@ -0,0 +1,35 @@
+kinemotion/__init__.py,sha256=sxdDOekOrIgjxm842gy-6zfq7OWmGl9ShJtXCm4JI7c,723
+kinemotion/api.py,sha256=IcvtjK38Eoh5u53yu99NaeChLDNvv7NSnlDcK8fhVS8,39349
+kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
+kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
+kinemotion/cmj/analysis.py,sha256=88zRNufM88Mc4p_YdnbXoSJM-pWAe4C9I7TqcH7QM9U,19815
+kinemotion/cmj/cli.py,sha256=Mj2h9It1jVjAauvtCxfLWTRijj7zbYhxZuebhw2Zz6w,10828
+kinemotion/cmj/debug_overlay.py,sha256=fXmWoHhqMLGo4vTtB6Ezs3yLUDOLw63zLIgU2gFlJQU,15892
+kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKts,9960
+kinemotion/cmj/kinematics.py,sha256=qRBe87NkX-7HQTQ8RoF-EpvfcffgP5vycJJRrxpHboc,10307
+kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
+kinemotion/core/auto_tuning.py,sha256=j6cul_qC6k0XyryCG93C1AWH2MKPj3UBMzuX02xaqfI,11235
+kinemotion/core/cli_utils.py,sha256=8xQvTiZFAQULGdpB9g-Mvf0doSgoXi1ZZfVY2T2zWss,7278
+kinemotion/core/cmj_metrics_validator.py,sha256=VVRn56pG3GKna_EDv8jQ5msYNv4VOUR5fTcqpSUzdIA,31334
+kinemotion/core/cmj_validation_bounds.py,sha256=NXW0d4S8hDqSkzAiyX9UyWDnKsWf61ygEKTKE2a1uNc,14069
+kinemotion/core/debug_overlay_utils.py,sha256=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAOTm-8LwTno,4587
+kinemotion/core/dropjump_metrics_validator.py,sha256=zTkWslex9qGQuJSEZltUXYyFLBtisPGGxwqpYpE_Mx4,12040
+kinemotion/core/dropjump_validation_bounds.py,sha256=Ow7T-0IK_qy0k9UZdiCuT_tttxklWAkuXFalQkF8Jbs,6927
+kinemotion/core/filtering.py,sha256=f-m-aA59e4WqE6u-9MA51wssu7rI-Y_7n1cG8IWdeRQ,11241
+kinemotion/core/formatting.py,sha256=G_3eqgOtym9RFOZVEwCxye4A2cyrmgvtQ214vIshowU,2480
+kinemotion/core/metadata.py,sha256=iz9YdkesHo-85TVBCoQVn7zkbrSde_fqjU79s_b-TZk,6829
+kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
+kinemotion/core/quality.py,sha256=dPGQp08y8DdEUbUdjTThnUOUsALgF0D2sdz50cm6wLI,13098
+kinemotion/core/smoothing.py,sha256=J-GjFP6xW9TO4teOqFd5523zTY2jYIY1Nd99cZvoM3s,14110
+kinemotion/core/video_io.py,sha256=fDdyYVIKqUSgCjBJa8l_S0SrDPDAhrWYfsDBNRuz1oM,7549
+kinemotion/dropjump/__init__.py,sha256=yc1XiZ9vfo5h_n7PKVSiX2TTgaIfGL7Y7SkQtiDZj_E,838
+kinemotion/dropjump/analysis.py,sha256=Sz1lnAsQSp9fzkDy8AuqQtE47LKBqNwiLkaKzz4W_Wk,29099
+kinemotion/dropjump/cli.py,sha256=n_Wfv3AC6YIgRPYhO3F2nTSai0NR7fh95nAoWjryQeY,16250
+kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
+kinemotion/dropjump/kinematics.py,sha256=IH6nCOwTuocQNX1VPS_am9vPpMRUUla0a0MjDhEiXnA,17129
+kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kinemotion-0.31.1.dist-info/METADATA,sha256=bZB-v07C8eFhrmm0QArfwocLbYOxHkRIwLJkX_5ZQxM,26020
+kinemotion-0.31.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.31.1.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.31.1.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.31.1.dist-info/RECORD,,

{kinemotion-0.30.0.dist-info → kinemotion-0.31.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

kinemotion-0.30.0.dist-info/RECORD

@@ -1,35 +0,0 @@
-kinemotion/__init__.py,sha256=sxdDOekOrIgjxm842gy-6zfq7OWmGl9ShJtXCm4JI7c,723
-kinemotion/api.py,sha256=ozt6GLZtw2ZWki0tBlkpOQgcNH_M7GfrRPlc_Rg8ROw,39284
-kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
-kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
-kinemotion/cmj/analysis.py,sha256=il7-sfM89ZetxLhmw9boViaP4E8Y3mlS_XI-B5txmMs,19795
-kinemotion/cmj/cli.py,sha256=12FEfWrseG4kCUbgHHdBPkWp6zzVQ0VAzfgNJotArmM,10792
-kinemotion/cmj/debug_overlay.py,sha256=D-y2FQKI01KY0WXFKTKg6p9Qj3AkXCE7xjau3Ais080,15886
-kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKts,9960
-kinemotion/cmj/kinematics.py,sha256=ax2RijtAWItZPNRmNr-CvC7bOSsZQw2qdCEnm5hUUpU,10247
-kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
-kinemotion/core/auto_tuning.py,sha256=j6cul_qC6k0XyryCG93C1AWH2MKPj3UBMzuX02xaqfI,11235
-kinemotion/core/cli_utils.py,sha256=Pq1JF7yvK1YbH0tOUWKjplthCbWsJQt4Lv7esPYH4FM,7254
-kinemotion/core/cmj_metrics_validator.py,sha256=bbOPTbFqDEZv3lDA8qejjCcMqXE7TYvHizCcWzHRW9Y,30902
-kinemotion/core/cmj_validation_bounds.py,sha256=NXW0d4S8hDqSkzAiyX9UyWDnKsWf61ygEKTKE2a1uNc,14069
-kinemotion/core/debug_overlay_utils.py,sha256=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAOTm-8LwTno,4587
-kinemotion/core/dropjump_metrics_validator.py,sha256=yGcg8ub6Z791qj5BxCn9mHin608tfxvxxfIeTql8HcY,11967
-kinemotion/core/dropjump_validation_bounds.py,sha256=Ow7T-0IK_qy0k9UZdiCuT_tttxklWAkuXFalQkF8Jbs,6927
-kinemotion/core/filtering.py,sha256=f-m-aA59e4WqE6u-9MA51wssu7rI-Y_7n1cG8IWdeRQ,11241
-kinemotion/core/formatting.py,sha256=G_3eqgOtym9RFOZVEwCxye4A2cyrmgvtQ214vIshowU,2480
-kinemotion/core/metadata.py,sha256=PyGHL6sx7Hj21lyorg2VsWP9BGTj_y_-wWU6eKCEfJo,6817
-kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
-kinemotion/core/quality.py,sha256=OC9nuf5IrQ9xURf3eA50VoNWOqkGwbjJpS90q2FDQzA,13082
-kinemotion/core/smoothing.py,sha256=x4o3BnG6k8OaV3emgpoJDF84CE9k5RYR7BeSYH_-8Es,14092
-kinemotion/core/video_io.py,sha256=SQBJSgAV8uOkAh96gNZRjd6XJG1G9dZzDc8kAZ_twy0,7538
-kinemotion/dropjump/__init__.py,sha256=yc1XiZ9vfo5h_n7PKVSiX2TTgaIfGL7Y7SkQtiDZj_E,838
-kinemotion/dropjump/analysis.py,sha256=BQ5NqSPNJjFQOb-W4bXSLvjCgWd-nvqx5NElyeqZJC4,29067
-kinemotion/dropjump/cli.py,sha256=ZyroaYPwz8TgfL39Wcaj6m68Awl6lYXC75ttaflU-c0,16236
-kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
-kinemotion/dropjump/kinematics.py,sha256=AfqIS8kaI3B8olPX9EY1QxQsuNmuJA5GRsI1EL4NHHg,17091
-kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.30.0.dist-info/METADATA,sha256=AUhSzQW2siu-R4KfUyS5YRDy1i9eYzzYxOMdWZXF2ww,26020
-kinemotion-0.30.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-kinemotion-0.30.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.30.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.30.0.dist-info/RECORD,,