kinemotion 0.12.0__tar.gz → 0.12.1__tar.gz

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

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## 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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.12.0
+Version: 0.12.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.12.0 → kinemotion-0.12.1}/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.1}/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.1}/pyproject.toml

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

{kinemotion-0.12.0 → kinemotion-0.12.1}/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.1}/src/kinemotion/dropjump/kinematics.py

@@ -255,55 +255,6 @@ def _find_precise_phase_timing(
     return contact_start_frac, contact_end_frac
 
 
-def _calculate_calibration_scale(
-    drop_height_m: float | None,
-    phases: list[tuple[int, int, ContactState]],
-    air_phases_indexed: list[tuple[int, int, int]],
-    foot_y_positions: np.ndarray,
-) -> float:
-    """Calculate calibration scale factor from known drop height.
-
-    Args:
-        drop_height_m: Known drop height in meters
-        phases: All phase tuples
-        air_phases_indexed: Air phases with indices
-        foot_y_positions: Vertical position array
-
-    Returns:
-        Scale factor (1.0 if no calibration possible)
-    """
-    scale_factor = 1.0
-
-    if drop_height_m is None or len(phases) < 2:
-        return scale_factor
-
-    if not air_phases_indexed:
-        return scale_factor
-
-    # Get first air phase (the drop)
-    first_air_start, first_air_end, _ = air_phases_indexed[0]
-
-    # Initial position: at start of drop (on the box)
-    lookback_start = max(0, first_air_start - 5)
-    if lookback_start < first_air_start:
-        initial_position = float(
-            np.mean(foot_y_positions[lookback_start:first_air_start])
-        )
-    else:
-        initial_position = float(foot_y_positions[first_air_start])
-
-    # Landing position: at the ground after drop
-    landing_position = float(foot_y_positions[first_air_end])
-
-    # Drop distance in normalized coordinates (y increases downward)
-    drop_normalized = landing_position - initial_position
-
-    if drop_normalized > 0.01:  # Sanity check
-        scale_factor = drop_height_m / drop_normalized
-
-    return scale_factor
-
-
 def _analyze_flight_phase(
     metrics: DropJumpMetrics,
     phases: list[tuple[int, int, ContactState]],
@@ -311,9 +262,6 @@ def _analyze_flight_phase(
     contact_end: int,
     foot_y_positions: np.ndarray,
     fps: float,
-    drop_height_m: float | None,
-    scale_factor: float,
-    kinematic_correction_factor: float,
     smoothing_window: int,
     polyorder: int,
 ) -> None:
@@ -329,9 +277,6 @@ def _analyze_flight_phase(
         contact_end: End of contact phase
         foot_y_positions: Vertical position array
         fps: Video frame rate
-        drop_height_m: Known drop height (optional, for RSI calculation)
-        scale_factor: Calibration scale factor
-        kinematic_correction_factor: Correction for kinematic method
         smoothing_window: Window size for acceleration computation
         polyorder: Polynomial order for Savitzky-Golay filter
     """
@@ -489,11 +434,6 @@ def calculate_drop_jump_metrics(
     metrics.contact_start_frame_precise = contact_start_frac
     metrics.contact_end_frame_precise = contact_end_frac
 
-    # Calculate calibration scale factor
-    scale_factor = _calculate_calibration_scale(
-        drop_height_m, phases, air_phases_indexed, foot_y_positions
-    )
-
     # Analyze flight phase and calculate jump height
     _analyze_flight_phase(
         metrics,
@@ -502,9 +442,6 @@ def calculate_drop_jump_metrics(
         contact_end,
         foot_y_positions,
         fps,
-        drop_height_m,
-        scale_factor,
-        kinematic_correction_factor,
         smoothing_window,
         polyorder,
     )

{kinemotion-0.12.0 → kinemotion-0.12.1}/uv.lock

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