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

kinemotion/api.py

@@ -1,25 +1,9 @@
 """Public API for programmatic use of kinemotion 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
-
+This module provides a unified interface for both drop jump and CMJ video analysis.
 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,21 +1,4 @@
-"""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")
-"""
+"""Landmark smoothing utilities to reduce jitter in pose tracking."""
 
 from typing import TypeAlias
 

kinemotion/core/validation.py

@@ -47,16 +47,23 @@ class AthleteProfile(Enum):
 
 @dataclass
 class MetricBounds:
-    """Physiological bounds for a single metric.
+    """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).
 
     Attributes:
-        absolute_min: Absolute minimum value (error threshold)
-        practical_min: Practical minimum for weakest athletes
-        recreational_min: Minimum for recreational athletes
+        absolute_min: Absolute minimum (error threshold, marks data corruption)
+        practical_min: Minimum for untrained/elderly athletes
+        recreational_min: Minimum for recreational athletes (moderate activity)
         recreational_max: Maximum for recreational athletes
-        elite_min: Minimum for elite athletes
+        elite_min: Minimum for elite athletes (competitive level)
         elite_max: Maximum for elite athletes
-        absolute_max: Absolute maximum value (error threshold)
+        absolute_max: Absolute maximum (error threshold, marks data corruption)
         unit: Unit of measurement (e.g., "m", "s", "m/s", "degrees")
     """
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.51.0
+Version: 0.52.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.51.0.dist-info → kinemotion-0.52.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 kinemotion/__init__.py,sha256=wPItmyGJUOFM6GPRVhAEvRz0-ErI7e2qiUREYJ9EfPQ,943
-kinemotion/api.py,sha256=sxtlgP63SrjmNegRGhoH0jwodIeDQqH2Pr1CGkfRUEE,1596
+kinemotion/api.py,sha256=q33-C6xlZKzXthjii1FKnschFU_WT60EHabRgczy3ic,1039
 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=6Ia0Q0eNMvjTc08Q4sYTBrGyoopBwiymdh-i1wuv9Rk,16304
+kinemotion/core/smoothing.py,sha256=FZmv3rumn0mYKU2y3JPKz46EvD8TVmQ6_GsN_Vp3BdU,15650
 kinemotion/core/timing.py,sha256=d1rjZc07Nbi5Jrio9AC-zeS0dNAlbPyNIydLz7X75Pk,7804
-kinemotion/core/validation.py,sha256=LmKfSl4Ayw3DgwKD9IrhsPdzp5ia4drLsHA2UuU1SCM,6310
+kinemotion/core/validation.py,sha256=UOdB0v-xZjYvUogwlSdX4luDHy1E0VCJvmu4VvrVPyc,6817
 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.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,,
+kinemotion-0.52.0.dist-info/METADATA,sha256=yGE83lM-tG2MOVq9ZzFTKb46IH_Hfn6WGHIAejWcsH8,26020
+kinemotion-0.52.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.52.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.52.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.52.0.dist-info/RECORD,,