kinemotion 0.75.0__py3-none-any.whl → 0.76.0__py3-none-any.whl

{kinemotion-0.75.0.dist-info → kinemotion-0.76.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.75.0
+Version: 0.76.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
@@ -51,6 +51,7 @@ Description-Content-Type: text/markdown
 
 - **Drop Jump**: Ground contact time, flight time, reactive strength index
 - **Counter Movement Jump (CMJ)**: Jump height, flight time, countermovement depth, triple extension biomechanics
+- **Squat Jump (SJ)**: Pure concentric power, force production, requires athlete mass
 
 ## Features
 
@@ -83,6 +84,14 @@ Description-Content-Type: text/markdown
 - **Metrics**: Jump height, flight time, countermovement depth, eccentric/concentric durations
 - **Validated accuracy**: 50.6cm jump (±1 frame precision)
 
+### Squat Jump (SJ) Analysis
+
+- **Static squat start** - pure concentric power test (no countermovement)
+- **Power/Force calculations** - Sayers regression (R² = 0.87, \<1% error vs force plates)
+- **Mass required** - athlete body weight needed for kinetic calculations
+- **Metrics**: Jump height, flight time, squat hold/concentric durations, peak/mean power, peak force
+- **Phase detection**: Squat hold → concentric → flight → landing
+
 ## ⚠️ Validation Status
 
 **Current Status:** Pre-validation (not validated against force plates or motion capture systems)
@@ -228,7 +237,22 @@ kinemotion cmj-analyze video.mp4
 kinemotion cmj-analyze video.mp4 --output debug.mp4
 ```
 
-### Common Options (Both Jump Types)
+### Analyzing Squat Jump (SJ)
+
+Analyzes pure concentric power production:
+
+```bash
+# Mass is required for power/force calculations
+kinemotion sj-analyze video.mp4 --mass 75.0
+
+# Complete analysis with all outputs
+kinemotion sj-analyze video.mp4 --mass 75.0 \
+  --output debug.mp4 \
+  --json-output results.json \
+  --verbose
+```
+
+### Common Options (All Jump Types)
 
 ```bash
 # Save metrics to JSON
@@ -390,6 +414,31 @@ metrics = process_cmj_video("video.mp4", output_video="debug.mp4")
 # - Phase-coded visualization
 ```
 
+### Squat Jump (SJ) API
+
+```python
+from kinemotion import process_sj_video
+
+# Mass is required for power/force calculations
+metrics = process_sj_video(
+    video_path="athlete_sj.mp4",
+    mass_kg=75.0,  # Required: athlete body mass
+    quality="balanced",
+    verbose=True
+)
+
+# Access results
+print(f"Jump height: {metrics.jump_height:.3f}m")
+print(f"Squat hold: {metrics.squat_hold_duration*1000:.1f}ms")
+print(f"Concentric: {metrics.concentric_duration*1000:.1f}ms")
+
+# Power/force (only available if mass provided)
+if metrics.peak_power:
+    print(f"Peak power: {metrics.peak_power:.0f}W")
+    print(f"Mean power: {metrics.mean_power:.0f}W")
+    print(f"Peak force: {metrics.peak_force:.0f}N")
+```
+
 ### CSV Export Example
 
 ```python

{kinemotion-0.75.0.dist-info → kinemotion-0.76.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-kinemotion/__init__.py,sha256=GovgX2mxUmfTH2HsMqlOCfU28niiTdu0c7iTIACcly4,1079
-kinemotion/api.py,sha256=x7rHYgh-bpc6a1kMp9fnnFkU7y96qYelDbzcqN3oUKY,1110
-kinemotion/cli.py,sha256=H3--5whfauDuOyW31lrK1MF-2U-61V11ft5RIndZuUU,644
+kinemotion/__init__.py,sha256=vGZ0XeiQSiqE9aKPWbGFfB4_wDQtiOPgloytgX_dcP4,1364
+kinemotion/api.py,sha256=2bUXUfBSGFL01xRmgOurH3bNGms0eJYwhLCf3UCOkLk,1570
+kinemotion/cli.py,sha256=4QpXr6pU4kbIC3NjphSY5yZV7CtJI4_Ew1Rh7iGSa9s,741
 kinemotion/core/__init__.py,sha256=E7HDsetuKTJ7EBb8ftNifJoKS8uhS4snRO7HgISyBoM,2035
 kinemotion/core/auto_tuning.py,sha256=ZDmHJJw69wzlRkEJ8OtLPE6KV5wLHcMha1RePVRICkI,11836
 kinemotion/core/cli_utils.py,sha256=6VA8HSnVvKaWMm7d9ahrqwFPXuRPp53s0dib1yCE7yQ,4179
@@ -43,9 +43,17 @@ kinemotion/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 kinemotion/models/pose_landmarker_lite.task,sha256=WZKeHR7pUodzXd2DOxnPSsRtKbx6_du_Z1PEWWkNV0o,5777746
 kinemotion/models/rtmpose-s_simcc-body7_pt-body7-halpe26_700e-256x192-7f134165_20230605.onnx,sha256=dfZTq8kbhv8RxWiXS0HUIJNCUpxYTBN45dFIorPflEs,133
 kinemotion/models/yolox_tiny_8xb8-300e_humanart-6f3252f9.onnx,sha256=UsutHVQ6GP3X5pCcp52EN8q7o2J3d-TnxZqlF48kY6I,133
+kinemotion/squat_jump/__init__.py,sha256=h6ubO3BUANxqjKMdN-KtlN6m77HARAP25PLzHw9k-Lk,99
+kinemotion/squat_jump/analysis.py,sha256=lr8C4UDVRI1fHmzMhtcsPXWlt7bNjAKS6EytIgayzTE,12497
+kinemotion/squat_jump/api.py,sha256=YMbq2BQzB_SnZ_Z-2KnR_OO2xuua-Zg0hP29Ghbk_d4,20111
+kinemotion/squat_jump/cli.py,sha256=09Q9O4_sHxw6QWDyPiynDQZSMixTO32NrJ5PTXTJNIk,9806
+kinemotion/squat_jump/debug_overlay.py,sha256=tCIeE9BqCfK-RCURCOM2oqF5qgYGMWD27QWdREpeuSc,6429
+kinemotion/squat_jump/kinematics.py,sha256=deJV1qDEn6-CLA3SxAOuuI-YDWIbEe9N8lWeZvswmgA,12231
+kinemotion/squat_jump/metrics_validator.py,sha256=F0jycY7waDxf6RqUwBulcaKD3frD7EobykgQB-Ayluk,16106
+kinemotion/squat_jump/validation_bounds.py,sha256=q01eQ8Eg01Y5UV3KlvZS1S9iY628OVPUwLoukHZvQOs,7276
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.75.0.dist-info/METADATA,sha256=4fzPj_5WXli6xDqcMMbGGz1PXo2sTJzeJIxTGeUy_1s,26125
-kinemotion-0.75.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-kinemotion-0.75.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.75.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.75.0.dist-info/RECORD,,
+kinemotion-0.76.0.dist-info/METADATA,sha256=S4_rnobPn-X8PmMBwe7jOoj-voa_dk0xBJsuhw15au4,27690
+kinemotion-0.76.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.76.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.76.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.76.0.dist-info/RECORD,,