kinemotion 0.35.0__py3-none-any.whl → 0.35.1__py3-none-any.whl

kinemotion/api.py

@@ -548,9 +548,12 @@ def process_dropjump_video(
 
         # Check if drop start was auto-detected
         drop_frame = None
-        if drop_start_frame is None and metrics.contact_start_frame is not None:
-            # Auto-detected
-            drop_frame = metrics.contact_start_frame
+        if drop_start_frame is None and metrics.drop_start_frame is not None:
+            # Auto-detected drop start from box
+            drop_frame = metrics.drop_start_frame
+        elif drop_start_frame is not None:
+            # Manual drop start provided
+            drop_frame = drop_start_frame
 
         algorithm_config = AlgorithmConfig(
             detection_method="forward_search",

kinemotion/cmj/analysis.py

@@ -422,11 +422,59 @@ def find_landing_frame(
     return float(landing_search_start + landing_idx)
 
 
-def find_standing_end(velocities: np.ndarray, lowest_point: float) -> float | None:
-    """Find end of standing phase before lowest point."""
+def find_standing_end(
+    velocities: np.ndarray,
+    lowest_point: float,
+    positions: np.ndarray | None = None,
+    accelerations: np.ndarray | None = None,
+) -> float | None:
+    """
+    Find end of standing phase before lowest point.
+
+    Uses acceleration-based detection to identify when downward movement begins.
+    Acceleration captures movement initiation even when velocity is negligible,
+    making it ideal for detecting slow countermovement starts.
+
+    Args:
+        velocities: Signed velocity array (for backward compatibility)
+        lowest_point: Frame index of lowest point
+        positions: Position array (unused, kept for backward compatibility)
+        accelerations: Acceleration array (if provided, uses
+            acceleration-based detection)
+
+    Returns:
+        Frame index where standing ends (countermovement begins), or None
+    """
     if lowest_point <= 20:
         return None
 
+    # Acceleration-based detection (best for detecting movement initiation)
+    if accelerations is not None:
+        # Use middle section of standing phase as baseline (avoids initial settling)
+        baseline_start = 10
+        baseline_end = min(40, int(lowest_point) - 10)
+
+        if baseline_end <= baseline_start:
+            return None
+
+        # Calculate baseline acceleration statistics
+        baseline_accel = accelerations[baseline_start:baseline_end]
+        baseline_mean = float(np.mean(baseline_accel))
+        baseline_std = float(np.std(baseline_accel))
+
+        # Threshold: 3 standard deviations above baseline
+        # This detects when acceleration significantly increases (movement starts)
+        accel_threshold = baseline_mean + 3.0 * baseline_std
+
+        # Search forward from baseline for acceleration spike
+        for i in range(baseline_end, int(lowest_point)):
+            if accelerations[i] > accel_threshold:
+                # Found start of downward acceleration
+                return float(i)
+
+        return None
+
+    # Fallback: velocity-based detection (legacy)
     standing_search = velocities[: int(lowest_point)]
     low_vel = np.abs(standing_search) < 0.005
     if np.any(low_vel):
@@ -479,6 +527,6 @@ def detect_cmj_phases(
     takeoff_frame = find_takeoff_frame(velocities, peak_height_frame, fps)
     lowest_point = find_lowest_frame(velocities, positions, takeoff_frame, fps)
     landing_frame = find_landing_frame(accelerations, peak_height_frame, fps)
-    standing_end = find_standing_end(velocities, lowest_point)
+    standing_end = find_standing_end(velocities, lowest_point, positions, accelerations)
 
     return (standing_end, lowest_point, takeoff_frame, landing_frame)

kinemotion/core/auto_tuning.py

@@ -108,10 +108,12 @@ def auto_tune_parameters(
     # =================================================================
 
     # Velocity threshold: Scale inversely with fps
-    # At 30fps, feet move ~2% of frame per frame when "stationary"
-    # At 60fps, feet move ~1% of frame per frame when "stationary"
-    # Formula: threshold = 0.02 * (30 / fps)
-    base_velocity_threshold = 0.02 * (30.0 / fps)
+    # Empirically validated with 45° oblique videos at 60fps:
+    # - Standing (stationary): ~0.001 mean, 0.0011 max
+    # - Flight/drop (moving): ~0.005-0.009
+    # Target threshold: 0.002 at 60fps for clear separation
+    # Formula: threshold = 0.004 * (30 / fps)
+    base_velocity_threshold = 0.004 * (30.0 / fps)
 
     # Min contact frames: Scale with fps to maintain same time duration
     # Goal: ~100ms minimum contact (3 frames @ 30fps, 6 frames @ 60fps)

kinemotion/dropjump/kinematics.py

@@ -57,6 +57,7 @@ class DropJumpMetrics:
         self.jump_height: float | None = None
         self.jump_height_kinematic: float | None = None  # From flight time
         self.jump_height_trajectory: float | None = None  # From position tracking
+        self.drop_start_frame: int | None = None  # Frame when athlete leaves box
         self.contact_start_frame: int | None = None
         self.contact_end_frame: int | None = None
         self.flight_start_frame: int | None = None
@@ -164,7 +165,7 @@ def _determine_drop_start_frame(
             foot_y_positions,
             fps,
             min_stationary_duration=0.5,
-            position_change_threshold=0.005,
+            position_change_threshold=0.01,  # Improved from 0.005 for better accuracy
             smoothing_window=smoothing_window,
         )
     return drop_start_frame
@@ -412,6 +413,11 @@ def calculate_drop_jump_metrics(
         drop_start_frame, foot_y_positions, fps, smoothing_window
     )
 
+    # Store drop start frame in metrics
+    metrics.drop_start_frame = (
+        drop_start_frame_value if drop_start_frame_value > 0 else None
+    )
+
     # Find contact phases
     phases = find_contact_phases(contact_states)
     interpolated_phases = find_interpolated_phase_transitions_with_curvature(

{kinemotion-0.35.0.dist-info → kinemotion-0.35.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.35.0
+Version: 0.35.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.35.0.dist-info → kinemotion-0.35.1.dist-info}/RECORD

@@ -1,8 +1,8 @@
 kinemotion/__init__.py,sha256=sxdDOekOrIgjxm842gy-6zfq7OWmGl9ShJtXCm4JI7c,723
-kinemotion/api.py,sha256=Rdz5XjFsIMK-9rByzOYiDTPz27vINB01fmdeDzPoxZY,39339
+kinemotion/api.py,sha256=oZB4Xk8KLqwOEYJCZnmEKPn_mAyQacw4s4QAhwTPH8I,39479
 kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
 kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
-kinemotion/cmj/analysis.py,sha256=DmZ7vptPd5PAkaWW-oSablA6DWrCj8u2qPxlKQm9cVU,17089
+kinemotion/cmj/analysis.py,sha256=OfNTMLPwZIRYbX-Yd8jgZ-7pqnHRz7L2bWAHVYFsQ60,18955
 kinemotion/cmj/cli.py,sha256=Mj2h9It1jVjAauvtCxfLWTRijj7zbYhxZuebhw2Zz6w,10828
 kinemotion/cmj/debug_overlay.py,sha256=fXmWoHhqMLGo4vTtB6Ezs3yLUDOLw63zLIgU2gFlJQU,15892
 kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKts,9960
@@ -10,7 +10,7 @@ kinemotion/cmj/kinematics.py,sha256=qRBe87NkX-7HQTQ8RoF-EpvfcffgP5vycJJRrxpHboc,
 kinemotion/cmj/metrics_validator.py,sha256=p_hgg0Q0UAiWGNXKSW4E9kPvyEgPNAujaxrk2XUmsBY,28619
 kinemotion/cmj/validation_bounds.py,sha256=yRhmpUzGJs0QYyL1o3mOkgUSTe4XTO2MONMITTjCv3c,11778
 kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
-kinemotion/core/auto_tuning.py,sha256=j6cul_qC6k0XyryCG93C1AWH2MKPj3UBMzuX02xaqfI,11235
+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=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAOTm-8LwTno,4587
 kinemotion/core/experimental.py,sha256=IK05AF4aZS15ke85hF3TWCqRIXU1AlD_XKzFz735Ua8,3640
@@ -26,12 +26,12 @@ kinemotion/dropjump/__init__.py,sha256=tC3H3BrCg8Oj-db-Vrtx4PH_llR1Ppkd5jwaOjhQc
 kinemotion/dropjump/analysis.py,sha256=B_N_51WoChyQ8I7yaeKeqj3vw7NufgV_3QL-FBZEtW4,28752
 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/dropjump/kinematics.py,sha256=yB4ws4VG59SUGcw1J-uXfDFfCMXBdzRh5C4jo0osXbs,17404
 kinemotion/dropjump/metrics_validator.py,sha256=sx4RodHpeiW8_PRB0GUJvkUWto1Ard1Dvrc9z8eKk7M,9351
 kinemotion/dropjump/validation_bounds.py,sha256=5b4I3CKPybuvrbn-nP5yCcGF_sH4Vtyw3a5AWWvWnBk,4645
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.35.0.dist-info/METADATA,sha256=vMAyXr_N5nJrQ4WvcnmQClVOw_EyvliO3PN09HMIsMw,26020
-kinemotion-0.35.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-kinemotion-0.35.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.35.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.35.0.dist-info/RECORD,,
+kinemotion-0.35.1.dist-info/METADATA,sha256=n93tZOI22N9m3SF1OHG2HImIGP7_fru3jN22Jr8xKrw,26020
+kinemotion-0.35.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.35.1.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.35.1.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.35.1.dist-info/RECORD,,