kinemotion 0.15.1__tar.gz → 0.15.3__tar.gz

{kinemotion-0.15.1 → kinemotion-0.15.3}/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -53,7 +53,7 @@ body:
       label: Command Used
       description: The exact command you ran (please remove any sensitive paths if needed).
       placeholder: |
-        kinemotion dropjump-analyze video.mp4 --drop-height 0.40 --output debug.mp4
+        kinemotion dropjump-analyze video.mp4 --output debug.mp4
       render: bash
     validations:
       required: false

{kinemotion-0.15.1 → kinemotion-0.15.3}/.github/pull_request_template.md

@@ -52,7 +52,8 @@ Related to #
 
 ```bash
 # Example test commands
-uv run kinemotion dropjump-analyze test_video.mp4 --drop-height 0.40
+uv run kinemotion dropjump-analyze test_video.mp4
+uv run kinemotion cmj-analyze test_video.mp4
 ```
 
 ## Code Quality Checklist

{kinemotion-0.15.1 → kinemotion-0.15.3}/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.15.3 (2025-11-10)
+
+### Bug Fixes
+
+- **dropjump**: Correct API imports in CLI module
+  ([`b456d4c`](https://github.com/feniix/kinemotion/commit/b456d4c0a09234df70da3d67de0ed53c4fe55cfe))
+
+### Documentation
+
+- **development**: Add HYROX wall ball no-rep detection implementation plan
+  ([`f38f5ae`](https://github.com/feniix/kinemotion/commit/f38f5ae21b2cb767fdf0156f193ce988d58fee7f))
+
+
+## v0.15.2 (2025-11-07)
+
+### Bug Fixes
+
+- **docs**: Update documentation to match current auto-tuning API
+  ([`a07b40d`](https://github.com/feniix/kinemotion/commit/a07b40d9057438912a44fc4eb5b9b3e6e34a6d56))
+
+
 ## v0.15.1 (2025-11-06)
 
 ### Bug Fixes

{kinemotion-0.15.1 → kinemotion-0.15.3}/CLAUDE.md

@@ -13,13 +13,13 @@ Kinemotion: Video-based kinematic analysis for athletic performance using MediaP
 ```bash
 asdf install        # Install Python 3.12.7 + uv
 uv sync            # Install dependencies
-uv run kinemotion dropjump-analyze video.mp4 --drop-height 0.40
+uv run kinemotion dropjump-analyze video.mp4
 uv run kinemotion cmj-analyze video.mp4
 ```
 
 **Development:**
 ```bash
-uv run pytest                           # Run all 70 tests
+uv run pytest                           # Run all 75 tests
 uv run ruff check --fix && uv run pyright  # Lint + type check
 ```
 
@@ -35,7 +35,7 @@ src/kinemotion/
 ├── dropjump/               # Drop jump: cli, analysis, kinematics, debug_overlay
 └── cmj/                    # CMJ: cli, analysis, kinematics, joint_angles, debug_overlay
 
-tests/                      # 70 tests total (61 drop jump, 9 CMJ)
+tests/                      # 75 tests total (61 drop jump, 9 CMJ, 5 CLI import)
 docs/                       # CMJ_GUIDE, TRIPLE_EXTENSION, REAL_TIME_ANALYSIS, etc.
 ```
 
@@ -48,7 +48,7 @@ docs/                       # CMJ_GUIDE, TRIPLE_EXTENSION, REAL_TIME_ANALYSIS, e
 | Starting | Elevated box | Floor level |
 | Algorithm | Forward search | Backward search from peak |
 | Velocity | Absolute (magnitude) | Signed (direction matters) |
-| Parameter | `--drop-height` required | No calibration needed |
+| Parameters | Auto-tuned quality presets | Auto-tuned quality presets |
 | Key Metric | Ground contact time | Jump height from flight time |
 
 ## Critical Implementation Details
@@ -178,13 +178,13 @@ When writing new code, follow these principles to maintain low duplication:
 ### CLI
 
 ```bash
-# Drop jump (requires --drop-height)
-kinemotion dropjump-analyze video.mp4 --drop-height 0.40
+# Drop jump (auto-tuned parameters)
+kinemotion dropjump-analyze video.mp4
 
-# CMJ (no calibration needed)
+# CMJ with debug video
 kinemotion cmj-analyze video.mp4 --output debug.mp4
 
-# Batch
+# Batch processing
 kinemotion cmj-analyze videos/*.mp4 --batch --workers 4
 ```
 
@@ -193,11 +193,11 @@ kinemotion cmj-analyze videos/*.mp4 --batch --workers 4
 ```python
 # Drop jump
 from kinemotion import process_dropjump_video
-metrics = process_video("video.mp4", drop_height=0.40)
+metrics = process_dropjump_video("video.mp4", quality="balanced")
 
 # CMJ
 from kinemotion import process_cmj_video
-metrics = process_cmj_video("video.mp4")
+metrics = process_cmj_video("video.mp4", quality="balanced")
 ```
 
 ## Important Gotchas

{kinemotion-0.15.1 → kinemotion-0.15.3}/CONTRIBUTING.md

@@ -83,10 +83,10 @@ We actively welcome pull requests! Here's how to submit one:
 
 ```bash
 # Run from source
-uv run kinemotion dropjump-analyze <video_path> --drop-height 0.40
+uv run kinemotion dropjump-analyze <video_path>
 
 # With debug output
-uv run kinemotion dropjump-analyze <video_path> --drop-height 0.40 --output debug.mp4 --verbose
+uv run kinemotion dropjump-analyze <video_path> --output debug.mp4 --verbose
 ```
 
 ## Code Quality Standards

{kinemotion-0.15.1 → kinemotion-0.15.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.15.1
+Version: 0.15.3
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion
@@ -125,8 +125,8 @@ Kinemotion supports two jump types with intelligent auto-tuning that automatical
 Analyzes reactive strength and ground contact time:
 
 ```bash
-# Drop-height is REQUIRED for accurate calibration
-kinemotion dropjump-analyze video.mp4 --drop-height 0.40
+# Automatic parameter tuning based on video characteristics
+kinemotion dropjump-analyze video.mp4
 ```
 
 ### Counter Movement Jump (CMJ) Analysis
@@ -176,9 +176,9 @@ Process multiple videos in parallel:
 
 ```bash
 # Drop jumps
-kinemotion dropjump-analyze videos/*.mp4 --batch --drop-height 0.40 --workers 4
+kinemotion dropjump-analyze videos/*.mp4 --batch --workers 4
 
-# CMJ (no drop height needed)
+# CMJ with output directories
 kinemotion cmj-analyze videos/*.mp4 --batch --workers 4 \
   --json-output-dir results/ \
   --csv-summary summary.csv
@@ -194,9 +194,8 @@ Use kinemotion as a library for automated pipelines and custom analysis.
 from kinemotion import process_dropjump_video
 
 # Process a single video
-metrics = process_video(
+metrics = process_dropjump_video(
     video_path="athlete_jump.mp4",
-    drop_height=0.40,  # 40cm drop box
     quality="balanced",
     verbose=True
 )
@@ -214,11 +213,11 @@ print(f"Flight time: {metrics.flight_time * 1000:.1f} ms")
 from kinemotion import DropJumpVideoConfig, process_dropjump_videos_bulk
 
 configs = [
-    VideoConfig("video1.mp4", drop_height=0.40),
-    VideoConfig("video2.mp4", drop_height=0.30, quality="accurate"),
+    DropJumpVideoConfig("video1.mp4", quality="balanced"),
+    DropJumpVideoConfig("video2.mp4", quality="accurate"),
 ]
 
-results = process_videos_bulk(configs, max_workers=4)
+results = process_dropjump_videos_bulk(configs, max_workers=4)
 
 # CMJ bulk processing
 from kinemotion import CMJVideoConfig, process_cmj_videos_bulk

{kinemotion-0.15.1 → kinemotion-0.15.3}/README.md

@@ -96,8 +96,8 @@ Kinemotion supports two jump types with intelligent auto-tuning that automatical
 Analyzes reactive strength and ground contact time:
 
 ```bash
-# Drop-height is REQUIRED for accurate calibration
-kinemotion dropjump-analyze video.mp4 --drop-height 0.40
+# Automatic parameter tuning based on video characteristics
+kinemotion dropjump-analyze video.mp4
 ```
 
 ### Counter Movement Jump (CMJ) Analysis
@@ -147,9 +147,9 @@ Process multiple videos in parallel:
 
 ```bash
 # Drop jumps
-kinemotion dropjump-analyze videos/*.mp4 --batch --drop-height 0.40 --workers 4
+kinemotion dropjump-analyze videos/*.mp4 --batch --workers 4
 
-# CMJ (no drop height needed)
+# CMJ with output directories
 kinemotion cmj-analyze videos/*.mp4 --batch --workers 4 \
   --json-output-dir results/ \
   --csv-summary summary.csv
@@ -165,9 +165,8 @@ Use kinemotion as a library for automated pipelines and custom analysis.
 from kinemotion import process_dropjump_video
 
 # Process a single video
-metrics = process_video(
+metrics = process_dropjump_video(
     video_path="athlete_jump.mp4",
-    drop_height=0.40,  # 40cm drop box
     quality="balanced",
     verbose=True
 )
@@ -185,11 +184,11 @@ print(f"Flight time: {metrics.flight_time * 1000:.1f} ms")
 from kinemotion import DropJumpVideoConfig, process_dropjump_videos_bulk
 
 configs = [
-    VideoConfig("video1.mp4", drop_height=0.40),
-    VideoConfig("video2.mp4", drop_height=0.30, quality="accurate"),
+    DropJumpVideoConfig("video1.mp4", quality="balanced"),
+    DropJumpVideoConfig("video2.mp4", quality="accurate"),
 ]
 
-results = process_videos_bulk(configs, max_workers=4)
+results = process_dropjump_videos_bulk(configs, max_workers=4)
 
 # CMJ bulk processing
 from kinemotion import CMJVideoConfig, process_cmj_videos_bulk

{kinemotion-0.15.1 → kinemotion-0.15.3}/docs/README.md

@@ -41,6 +41,7 @@ Welcome to the kinemotion documentation. This directory contains guides, technic
 
 - **[Validation Plan](development/validation-plan.md)** - Testing and validation strategy
 - **[Errors & Findings](development/errors-findings.md)** - Known issues and debugging information
+- **[Wall Ball No-Rep Detection](development/wallball-norep-detection.md)** - Future feature implementation plan for HYROX wall ball analysis
 
 ### 🌍 Translations
 
@@ -100,4 +101,4 @@ Ensure cross-references use relative paths and follow conventional commits forma
 
 ______________________________________________________________________
 
-**Last Updated:** November 6, 2025
+**Last Updated:** November 7, 2025

{kinemotion-0.15.1 → kinemotion-0.15.3}/docs/api/cmj.md

@@ -9,8 +9,9 @@ from kinemotion import process_cmj_video
 
 metrics = process_cmj_video(
     video_path="cmj.mp4",
-    output_path="debug.mp4",  # optional
-    smoothing=True
+    quality="balanced",  # fast, balanced, or accurate
+    output_video="debug.mp4",  # optional
+    verbose=True
 )
 
 print(f"Jump height: {metrics.jump_height:.2f}m")

kinemotion-0.15.3/docs/api/dropjump.md

@@ -0,0 +1,106 @@
+# Drop Jump API
+
+The drop jump API provides functions for analyzing drop jump videos and extracting kinematic metrics.
+
+## Quick Example
+
+```python
+from kinemotion import process_dropjump_video
+
+metrics = process_dropjump_video(
+    video_path="dropjump.mp4",
+    quality="balanced",  # fast, balanced, or accurate
+    output_video="debug.mp4",  # optional
+    verbose=True
+)
+
+print(f"Ground contact time: {metrics.ground_contact_time:.3f}s")
+print(f"Flight time: {metrics.flight_time:.3f}s")
+print(f"RSI: {metrics.reactive_strength_index:.2f}")
+```
+
+## Main Functions
+
+::: kinemotion.api.process_dropjump_video
+options:
+show_root_heading: true
+show_source: false
+
+::: kinemotion.api.process_dropjump_videos_bulk
+options:
+show_root_heading: true
+show_source: false
+
+## Configuration
+
+::: kinemotion.api.DropJumpVideoConfig
+options:
+show_root_heading: true
+show_source: false
+
+## Results
+
+::: kinemotion.api.DropJumpVideoResult
+options:
+show_root_heading: true
+show_source: false
+
+## Metrics
+
+::: kinemotion.dropjump.kinematics.DropJumpMetrics
+options:
+show_root_heading: true
+show_source: false
+
+## Key Parameters
+
+### quality
+
+Analysis quality preset that determines processing speed and accuracy. The system automatically tunes parameters based on video characteristics and the selected preset.
+
+Options:
+
+- `"fast"` - Quick processing, lower precision
+- `"balanced"` - Default, good for most cases
+- `"accurate"` - Research-grade, slower processing
+
+Default: `"balanced"`
+
+```python
+metrics = process_dropjump_video("video.mp4", quality="accurate")
+```
+
+### output_video
+
+Path to write debug video with overlay visualization. If not provided, no debug video is created.
+
+```python
+metrics = process_dropjump_video(
+    "video.mp4",
+    quality="balanced",
+    output_video="debug.mp4"
+)
+```
+
+### json_output
+
+Path to write JSON metrics output. If not provided, metrics are only returned as a Python object.
+
+```python
+metrics = process_dropjump_video(
+    "video.mp4",
+    json_output="metrics.json"
+)
+```
+
+### Expert Parameters
+
+For advanced users, you can override auto-tuned parameters:
+
+- `smoothing_window` - Override auto-tuned smoothing window size
+- `velocity_threshold` - Override velocity threshold for ground contact detection
+- `min_contact_frames` - Override minimum contact frames
+- `visibility_threshold` - Override visibility threshold
+- `detection_confidence` - Override pose detection confidence
+- `tracking_confidence` - Override pose tracking confidence
+- `drop_start_frame` - Manually specify frame where drop begins

{kinemotion-0.15.1 → kinemotion-0.15.3}/docs/api/overview.md

@@ -8,10 +8,10 @@ Kinemotion provides a Python API for video-based kinematic analysis. The API is
 
 Process drop jump videos and extract kinematic metrics:
 
-- `process_video()` - Analyze a single drop jump video
-- `process_videos_bulk()` - Batch process multiple drop jump videos
-- `VideoConfig` - Configuration for drop jump analysis
-- `VideoResult` - Results from drop jump analysis
+- `process_dropjump_video()` - Analyze a single drop jump video
+- `process_dropjump_videos_bulk()` - Batch process multiple drop jump videos
+- `DropJumpVideoConfig` - Configuration for drop jump analysis
+- `DropJumpVideoResult` - Results from drop jump analysis
 - `DropJumpMetrics` - Kinematic metrics for drop jumps
 
 See [Drop Jump API](dropjump.md) for detailed documentation.
@@ -34,31 +34,35 @@ See [CMJ API](cmj.md) for detailed documentation.
 from kinemotion import process_dropjump_video, process_cmj_video
 
 # Drop jump analysis
-drop_metrics = process_video("dropjump.mp4", drop_height=0.40)
+drop_metrics = process_dropjump_video("dropjump.mp4", quality="balanced")
 
 # CMJ analysis
-cmj_metrics = process_cmj_video("cmj.mp4")
+cmj_metrics = process_cmj_video("cmj.mp4", quality="balanced")
 ```
 
 ## Batch Processing
 
 ```python
-from kinemotion import process_dropjump_videos_bulk, process_cmj_videos_bulk
+from kinemotion import (
+    DropJumpVideoConfig,
+    CMJVideoConfig,
+    process_dropjump_videos_bulk,
+    process_cmj_videos_bulk
+)
 
 # Batch drop jump analysis
-results = process_videos_bulk(
-    video_paths=["video1.mp4", "video2.mp4"],
-    drop_height=0.40,
-    output_dir="results/",
-    workers=4
-)
+configs = [
+    DropJumpVideoConfig("video1.mp4", quality="balanced"),
+    DropJumpVideoConfig("video2.mp4", quality="accurate"),
+]
+results = process_dropjump_videos_bulk(configs, max_workers=4)
 
 # Batch CMJ analysis
-cmj_results = process_cmj_videos_bulk(
-    video_paths=["cmj1.mp4", "cmj2.mp4"],
-    output_dir="results/",
-    workers=4
-)
+cmj_configs = [
+    CMJVideoConfig("cmj1.mp4", quality="balanced"),
+    CMJVideoConfig("cmj2.mp4", quality="accurate"),
+]
+cmj_results = process_cmj_videos_bulk(cmj_configs, max_workers=4)
 ```
 
 ## Core Utilities