kinemotion 0.50.1__py3-none-any.whl → 0.51.0__py3-none-any.whl

kinemotion/api.py

@@ -1,9 +1,25 @@
 """Public API for programmatic use of kinemotion analysis.
 
-This module provides a unified interface for both drop jump and CMJ video analysis.
+This module provides a unified interface for both drop jump and counter-movement
+jump (CMJ) video analysis. Users can import analysis functions and configuration
+classes directly from this module.
+
+Supported jump analysis types:
+- Drop jump (DJ): Ground contact time, reactive strength index (RSI)
+- Counter-movement jump (CMJ): Jump height, flight time, countermovement depth
+
 The actual implementations have been moved to their respective submodules:
 - Drop jump: kinemotion.dropjump.api
 - CMJ: kinemotion.cmj.api
+
+Example:
+    from kinemotion import process_dropjump_video, process_cmj_video
+
+    # Analyze drop jump
+    dj_result = process_dropjump_video("video.mp4", quality="balanced")
+
+    # Analyze CMJ
+    cmj_result = process_cmj_video("video.mp4", quality="balanced")
 """
 
 # CMJ API

kinemotion/core/smoothing.py

@@ -1,4 +1,21 @@
-"""Landmark smoothing utilities to reduce jitter in pose tracking."""
+"""Landmark smoothing utilities to reduce jitter in pose tracking.
+
+This module provides filtering and smoothing techniques to improve the quality of
+MediaPipe pose landmarks by removing noise and jitter while preserving key movement
+features. Techniques include:
+
+- Savitzky-Golay filtering: Smooth temporal data while preserving edges
+- Bilateral temporal filtering: Edge-preserving smoothing with adaptive weights
+- Outlier rejection: Remove erratic landmark detections
+
+Used extensively in jump analysis to ensure accurate velocity and position calculations
+across video frames.
+
+Example:
+    from kinemotion.core.smoothing import smooth_landmarks
+
+    smoothed = smooth_landmarks(raw_landmarks, quality="balanced")
+"""
 
 from typing import TypeAlias
 

kinemotion/core/validation.py

@@ -47,23 +47,16 @@ class AthleteProfile(Enum):
 
 @dataclass
 class MetricBounds:
-    """Physiological bounds for a single metric across athlete performance levels.
-
-    Defines nested ranges for validating metrics: absolute limits mark impossible
-    values (likely data corruption), while performance-level ranges assess whether
-    results are typical for an athlete's training background.
-
-    Bounds are ordered: absolute_min < practical_min < recreational_min < elite_min
-    and elite_max < recreational_max < absolute_max (symmetric about typical values).
+    """Physiological bounds for a single metric.
 
     Attributes:
-        absolute_min: Absolute minimum (error threshold, marks data corruption)
-        practical_min: Minimum for untrained/elderly athletes
-        recreational_min: Minimum for recreational athletes (moderate activity)
+        absolute_min: Absolute minimum value (error threshold)
+        practical_min: Practical minimum for weakest athletes
+        recreational_min: Minimum for recreational athletes
         recreational_max: Maximum for recreational athletes
-        elite_min: Minimum for elite athletes (competitive level)
+        elite_min: Minimum for elite athletes
         elite_max: Maximum for elite athletes
-        absolute_max: Absolute maximum (error threshold, marks data corruption)
+        absolute_max: Absolute maximum value (error threshold)
         unit: Unit of measurement (e.g., "m", "s", "m/s", "degrees")
     """
 

{kinemotion-0.50.1.dist-info → kinemotion-0.51.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.50.1
+Version: 0.51.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

{kinemotion-0.50.1.dist-info → kinemotion-0.51.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 kinemotion/__init__.py,sha256=wPItmyGJUOFM6GPRVhAEvRz0-ErI7e2qiUREYJ9EfPQ,943
-kinemotion/api.py,sha256=q33-C6xlZKzXthjii1FKnschFU_WT60EHabRgczy3ic,1039
+kinemotion/api.py,sha256=sxtlgP63SrjmNegRGhoH0jwodIeDQqH2Pr1CGkfRUEE,1596
 kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
 kinemotion/cmj/__init__.py,sha256=SkAw9ka8Yd1Qfv9hcvk22m3EfucROzYrSNGNF5kDzho,113
 kinemotion/cmj/analysis.py,sha256=3l0vYQB9tN4HtEO2MPFHVtrdzSmXgwpCm03qzYLCF0c,22196
@@ -22,9 +22,9 @@ kinemotion/core/metadata.py,sha256=bJAVa4nym__zx1hNowSZduMGKBSGOPxTbBQkjm6N0D0,7
 kinemotion/core/pipeline_utils.py,sha256=0u7o-UFZX6cOu3NaWpFmEy5ejS0WUKggZ1HSdeZXhoA,14964
 kinemotion/core/pose.py,sha256=z1OGuwnc-NdK6Aoc9UYCyPBzomw4eInexOWonZbsEoA,9057
 kinemotion/core/quality.py,sha256=dPGQp08y8DdEUbUdjTThnUOUsALgF0D2sdz50cm6wLI,13098
-kinemotion/core/smoothing.py,sha256=FZmv3rumn0mYKU2y3JPKz46EvD8TVmQ6_GsN_Vp3BdU,15650
+kinemotion/core/smoothing.py,sha256=6Ia0Q0eNMvjTc08Q4sYTBrGyoopBwiymdh-i1wuv9Rk,16304
 kinemotion/core/timing.py,sha256=d1rjZc07Nbi5Jrio9AC-zeS0dNAlbPyNIydLz7X75Pk,7804
-kinemotion/core/validation.py,sha256=UOdB0v-xZjYvUogwlSdX4luDHy1E0VCJvmu4VvrVPyc,6817
+kinemotion/core/validation.py,sha256=LmKfSl4Ayw3DgwKD9IrhsPdzp5ia4drLsHA2UuU1SCM,6310
 kinemotion/core/video_io.py,sha256=vCwpWnlW2y29l48dFXokdehQn42w_IQvayxbVTjpXqQ,7863
 kinemotion/dropjump/__init__.py,sha256=tC3H3BrCg8Oj-db-Vrtx4PH_llR1Ppkd5jwaOjhQcLg,862
 kinemotion/dropjump/analysis.py,sha256=p7nnCe7V6vnhQKZVYk--_nhsTvVa_WY-A3zXmyplsew,28211
@@ -35,8 +35,8 @@ kinemotion/dropjump/kinematics.py,sha256=PATlGaClutGKJslL-LRIXHmTsvb-xEB8PUIMScU
 kinemotion/dropjump/metrics_validator.py,sha256=CrTlGup8q2kyPXtA6HNwm7_yq0AsBaDllG7RVZdXmYA,9342
 kinemotion/dropjump/validation_bounds.py,sha256=fyl04ZV7nfvHkL5eob6oEpV9Hxce6aiOWQ9pclLp7AQ,5077
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.50.1.dist-info/METADATA,sha256=MuAflS2V4-d86s_sLYwqg1y6-rw6MSZQWWgLqnH8Xks,26020
-kinemotion-0.50.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-kinemotion-0.50.1.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.50.1.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.50.1.dist-info/RECORD,,
+kinemotion-0.51.0.dist-info/METADATA,sha256=ogLrmcrusmQ5EbNnRwH-OfenqNJaz21M9OVrTUf3O3g,26020
+kinemotion-0.51.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.51.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.51.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.51.0.dist-info/RECORD,,