kinemotion 0.34.0__py3-none-any.whl → 0.35.1__py3-none-any.whl

kinemotion/{core/dropjump_metrics_validator.py → dropjump/metrics_validator.py}

@@ -7,114 +7,26 @@ Provides severity levels (ERROR, WARNING, INFO) for different categories
 of metric issues.
 """
 
-from dataclasses import dataclass, field
-from enum import Enum
+from dataclasses import dataclass
 
-from kinemotion.core.dropjump_validation_bounds import (
-    AthleteProfile,
+from kinemotion.core.validation import (
+    MetricsValidator,
+    ValidationResult,
+)
+from kinemotion.dropjump.validation_bounds import (
     DropJumpBounds,
     estimate_athlete_profile,
 )
 
 
-class ValidationSeverity(Enum):
-    """Severity level for validation issues."""
-
-    ERROR = "ERROR"  # Metrics invalid, likely data corruption
-    WARNING = "WARNING"  # Metrics valid but unusual, needs review
-    INFO = "INFO"  # Normal variation, informational only
-
-
 @dataclass
-class ValidationIssue:
-    """Single validation issue."""
+class DropJumpValidationResult(ValidationResult):
+    """Drop jump-specific validation result."""
 
-    severity: ValidationSeverity
-    metric: str
-    message: str
-    value: float | None = None
-    bounds: tuple[float, float] | None = None
-
-
-@dataclass
-class ValidationResult:
-    """Complete validation result for drop jump metrics."""
-
-    issues: list[ValidationIssue] = field(default_factory=list)
-    status: str = "PASS"  # "PASS", "PASS_WITH_WARNINGS", "FAIL"
-    athlete_profile: AthleteProfile | None = None
     rsi: float | None = None
     contact_flight_ratio: float | None = None
     height_kinematic_trajectory_consistency: float | None = None  # % error
 
-    def add_error(
-        self,
-        metric: str,
-        message: str,
-        value: float | None = None,
-        bounds: tuple[float, float] | None = None,
-    ) -> None:
-        """Add error-level issue."""
-        self.issues.append(
-            ValidationIssue(
-                severity=ValidationSeverity.ERROR,
-                metric=metric,
-                message=message,
-                value=value,
-                bounds=bounds,
-            )
-        )
-
-    def add_warning(
-        self,
-        metric: str,
-        message: str,
-        value: float | None = None,
-        bounds: tuple[float, float] | None = None,
-    ) -> None:
-        """Add warning-level issue."""
-        self.issues.append(
-            ValidationIssue(
-                severity=ValidationSeverity.WARNING,
-                metric=metric,
-                message=message,
-                value=value,
-                bounds=bounds,
-            )
-        )
-
-    def add_info(
-        self,
-        metric: str,
-        message: str,
-        value: float | None = None,
-    ) -> None:
-        """Add info-level issue."""
-        self.issues.append(
-            ValidationIssue(
-                severity=ValidationSeverity.INFO,
-                metric=metric,
-                message=message,
-                value=value,
-            )
-        )
-
-    def finalize_status(self) -> None:
-        """Determine final pass/fail status based on issues."""
-        has_errors = any(
-            issue.severity == ValidationSeverity.ERROR for issue in self.issues
-        )
-        has_warnings = any(
-            issue.severity == ValidationSeverity.WARNING for issue in self.issues
-        )
-
-        if has_errors:
-            self.status = "FAIL"
-        elif has_warnings:
-            self.status = "PASS_WITH_WARNINGS"
-        else:
-            self.status = "PASS"
-
     def to_dict(self) -> dict:
         """Convert validation result to JSON-serializable dictionary.
 
@@ -144,28 +56,19 @@ class ValidationResult:
         }
 
 
-class DropJumpMetricsValidator:
+class DropJumpMetricsValidator(MetricsValidator):
     """Comprehensive drop jump metrics validator."""
 
-    def __init__(self, assumed_profile: AthleteProfile | None = None):
-        """Initialize validator.
-
-        Args:
-            assumed_profile: If provided, validate against this specific profile.
-                            Otherwise, estimate from metrics.
-        """
-        self.assumed_profile = assumed_profile
-
-    def validate(self, metrics: dict) -> ValidationResult:
+    def validate(self, metrics: dict) -> DropJumpValidationResult:
         """Validate drop jump metrics comprehensively.
 
         Args:
             metrics: Dictionary with drop jump metric values
 
         Returns:
-            ValidationResult with all issues and status
+            DropJumpValidationResult with all issues and status
         """
-        result = ValidationResult()
+        result = DropJumpValidationResult()
 
         # Estimate athlete profile if not provided
         if self.assumed_profile:
@@ -208,7 +111,7 @@ class DropJumpMetricsValidator:
         return result
 
     def _check_contact_time(
-        self, contact_time_ms: float, result: ValidationResult
+        self, contact_time_ms: float, result: DropJumpValidationResult
     ) -> None:
         """Validate contact time."""
         contact_time_s = contact_time_ms / 1000.0
@@ -233,7 +136,7 @@ class DropJumpMetricsValidator:
             )
 
     def _check_flight_time(
-        self, flight_time_ms: float, result: ValidationResult
+        self, flight_time_ms: float, result: DropJumpValidationResult
     ) -> None:
         """Validate flight time."""
         flight_time_s = flight_time_ms / 1000.0
@@ -257,7 +160,7 @@ class DropJumpMetricsValidator:
             )
 
     def _check_jump_height(
-        self, jump_height_m: float, result: ValidationResult
+        self, jump_height_m: float, result: DropJumpValidationResult
     ) -> None:
         """Validate jump height."""
         bounds = DropJumpBounds.JUMP_HEIGHT
@@ -280,7 +183,10 @@ class DropJumpMetricsValidator:
             )
 
     def _check_rsi(
-        self, contact_time_ms: float, flight_time_ms: float, result: ValidationResult
+        self,
+        contact_time_ms: float,
+        flight_time_ms: float,
+        result: DropJumpValidationResult,
     ) -> None:
         """Validate RSI and cross-check consistency."""
         contact_time_s = contact_time_ms / 1000.0
@@ -313,7 +219,7 @@ class DropJumpMetricsValidator:
         self,
         jump_height_kinematic_m: float,
         jump_height_trajectory_m: float,
-        result: ValidationResult,
+        result: DropJumpValidationResult,
     ) -> None:
         """Validate consistency between kinematic and trajectory-based heights.
 

kinemotion/{core/dropjump_validation_bounds.py → dropjump/validation_bounds.py}

@@ -15,64 +15,7 @@ References:
 - Covens et al. (2019): Drop jump kinetics across athletes
 """
 
-from dataclasses import dataclass
-from enum import Enum
-
-
-class AthleteProfile(Enum):
-    """Athlete performance categories for metric bounds."""
-
-    ELDERLY = "elderly"  # 70+, deconditioned
-    UNTRAINED = "untrained"  # Sedentary, no training
-    RECREATIONAL = "recreational"  # Fitness class, moderate activity
-    TRAINED = "trained"  # Regular athlete, 3-5 years training
-    ELITE = "elite"  # Competitive athlete, college/professional level
-
-
-@dataclass
-class MetricBounds:
-    """Physiological bounds for a single metric.
-
-    Attributes:
-        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
-        elite_max: Maximum for elite athletes
-        absolute_max: Absolute maximum value (error threshold)
-        unit: Unit of measurement (e.g., "s", "m", "ratio")
-    """
-
-    absolute_min: float
-    practical_min: float
-    recreational_min: float
-    recreational_max: float
-    elite_min: float
-    elite_max: float
-    absolute_max: float
-    unit: str
-
-    def contains(self, value: float, profile: AthleteProfile) -> bool:
-        """Check if value is within bounds for athlete profile."""
-        if profile == AthleteProfile.ELDERLY:
-            return self.practical_min <= value <= self.recreational_max
-        elif profile == AthleteProfile.UNTRAINED:
-            return self.practical_min <= value <= self.recreational_max
-        elif profile == AthleteProfile.RECREATIONAL:
-            return self.recreational_min <= value <= self.recreational_max
-        elif profile == AthleteProfile.TRAINED:
-            # Trained athletes: midpoint between recreational and elite
-            trained_min = (self.recreational_min + self.elite_min) / 2
-            trained_max = (self.recreational_max + self.elite_max) / 2
-            return trained_min <= value <= trained_max
-        elif profile == AthleteProfile.ELITE:
-            return self.elite_min <= value <= self.elite_max
-        return False
-
-    def is_physically_possible(self, value: float) -> bool:
-        """Check if value is within absolute physiological limits."""
-        return self.absolute_min <= value <= self.absolute_max
+from kinemotion.core.validation import AthleteProfile, MetricBounds
 
 
 class DropJumpBounds:

{kinemotion-0.34.0.dist-info → kinemotion-0.35.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.34.0
+Version: 0.35.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.35.1.dist-info/RECORD

@@ -0,0 +1,37 @@
+kinemotion/__init__.py,sha256=sxdDOekOrIgjxm842gy-6zfq7OWmGl9ShJtXCm4JI7c,723
+kinemotion/api.py,sha256=oZB4Xk8KLqwOEYJCZnmEKPn_mAyQacw4s4QAhwTPH8I,39479
+kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
+kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
+kinemotion/cmj/analysis.py,sha256=OfNTMLPwZIRYbX-Yd8jgZ-7pqnHRz7L2bWAHVYFsQ60,18955
+kinemotion/cmj/cli.py,sha256=Mj2h9It1jVjAauvtCxfLWTRijj7zbYhxZuebhw2Zz6w,10828
+kinemotion/cmj/debug_overlay.py,sha256=fXmWoHhqMLGo4vTtB6Ezs3yLUDOLw63zLIgU2gFlJQU,15892
+kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKts,9960
+kinemotion/cmj/kinematics.py,sha256=qRBe87NkX-7HQTQ8RoF-EpvfcffgP5vycJJRrxpHboc,10307
+kinemotion/cmj/metrics_validator.py,sha256=p_hgg0Q0UAiWGNXKSW4E9kPvyEgPNAujaxrk2XUmsBY,28619
+kinemotion/cmj/validation_bounds.py,sha256=yRhmpUzGJs0QYyL1o3mOkgUSTe4XTO2MONMITTjCv3c,11778
+kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
+kinemotion/core/auto_tuning.py,sha256=wtCUMOhBChVJNXfEeku3GCMW4qED6MF-O_mv2sPTiVQ,11324
+kinemotion/core/cli_utils.py,sha256=zbnifPhD-OYofJioeYfJtshuWcl8OAEWtqCGVF4ctAI,7966
+kinemotion/core/debug_overlay_utils.py,sha256=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAOTm-8LwTno,4587
+kinemotion/core/experimental.py,sha256=IK05AF4aZS15ke85hF3TWCqRIXU1AlD_XKzFz735Ua8,3640
+kinemotion/core/filtering.py,sha256=GsC9BB71V07LJJHgS2lsaxUAtJsupcUiwtZFDgODh8c,11417
+kinemotion/core/formatting.py,sha256=G_3eqgOtym9RFOZVEwCxye4A2cyrmgvtQ214vIshowU,2480
+kinemotion/core/metadata.py,sha256=iz9YdkesHo-85TVBCoQVn7zkbrSde_fqjU79s_b-TZk,6829
+kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
+kinemotion/core/quality.py,sha256=dPGQp08y8DdEUbUdjTThnUOUsALgF0D2sdz50cm6wLI,13098
+kinemotion/core/smoothing.py,sha256=GAfC-jxu1eqNyDjsUXqUBicKx9um5hrk49wz1FxfRNM,15219
+kinemotion/core/validation.py,sha256=LmKfSl4Ayw3DgwKD9IrhsPdzp5ia4drLsHA2UuU1SCM,6310
+kinemotion/core/video_io.py,sha256=fDdyYVIKqUSgCjBJa8l_S0SrDPDAhrWYfsDBNRuz1oM,7549
+kinemotion/dropjump/__init__.py,sha256=tC3H3BrCg8Oj-db-Vrtx4PH_llR1Ppkd5jwaOjhQcLg,862
+kinemotion/dropjump/analysis.py,sha256=B_N_51WoChyQ8I7yaeKeqj3vw7NufgV_3QL-FBZEtW4,28752
+kinemotion/dropjump/cli.py,sha256=n_Wfv3AC6YIgRPYhO3F2nTSai0NR7fh95nAoWjryQeY,16250
+kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
+kinemotion/dropjump/kinematics.py,sha256=yB4ws4VG59SUGcw1J-uXfDFfCMXBdzRh5C4jo0osXbs,17404
+kinemotion/dropjump/metrics_validator.py,sha256=sx4RodHpeiW8_PRB0GUJvkUWto1Ard1Dvrc9z8eKk7M,9351
+kinemotion/dropjump/validation_bounds.py,sha256=5b4I3CKPybuvrbn-nP5yCcGF_sH4Vtyw3a5AWWvWnBk,4645
+kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kinemotion-0.35.1.dist-info/METADATA,sha256=n93tZOI22N9m3SF1OHG2HImIGP7_fru3jN22Jr8xKrw,26020
+kinemotion-0.35.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+kinemotion-0.35.1.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.35.1.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.35.1.dist-info/RECORD,,

kinemotion-0.34.0.dist-info/RECORD

@@ -1,35 +0,0 @@
-kinemotion/__init__.py,sha256=sxdDOekOrIgjxm842gy-6zfq7OWmGl9ShJtXCm4JI7c,723
-kinemotion/api.py,sha256=IcvtjK38Eoh5u53yu99NaeChLDNvv7NSnlDcK8fhVS8,39349
-kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
-kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
-kinemotion/cmj/analysis.py,sha256=88zRNufM88Mc4p_YdnbXoSJM-pWAe4C9I7TqcH7QM9U,19815
-kinemotion/cmj/cli.py,sha256=Mj2h9It1jVjAauvtCxfLWTRijj7zbYhxZuebhw2Zz6w,10828
-kinemotion/cmj/debug_overlay.py,sha256=fXmWoHhqMLGo4vTtB6Ezs3yLUDOLw63zLIgU2gFlJQU,15892
-kinemotion/cmj/joint_angles.py,sha256=HmheIEiKcQz39cRezk4h-htorOhGNPsqKIR9RsAEKts,9960
-kinemotion/cmj/kinematics.py,sha256=qRBe87NkX-7HQTQ8RoF-EpvfcffgP5vycJJRrxpHboc,10307
-kinemotion/core/__init__.py,sha256=HsqolRa60cW3vrG8F9Lvr9WvWcs5hCmsTzSgo7imi-4,1278
-kinemotion/core/auto_tuning.py,sha256=j6cul_qC6k0XyryCG93C1AWH2MKPj3UBMzuX02xaqfI,11235
-kinemotion/core/cli_utils.py,sha256=8xQvTiZFAQULGdpB9g-Mvf0doSgoXi1ZZfVY2T2zWss,7278
-kinemotion/core/cmj_metrics_validator.py,sha256=VVRn56pG3GKna_EDv8jQ5msYNv4VOUR5fTcqpSUzdIA,31334
-kinemotion/core/cmj_validation_bounds.py,sha256=NXW0d4S8hDqSkzAiyX9UyWDnKsWf61ygEKTKE2a1uNc,14069
-kinemotion/core/debug_overlay_utils.py,sha256=TyUb5okv5qw8oeaX3jsUO_kpwf1NnaHEAOTm-8LwTno,4587
-kinemotion/core/dropjump_metrics_validator.py,sha256=zTkWslex9qGQuJSEZltUXYyFLBtisPGGxwqpYpE_Mx4,12040
-kinemotion/core/dropjump_validation_bounds.py,sha256=Ow7T-0IK_qy0k9UZdiCuT_tttxklWAkuXFalQkF8Jbs,6927
-kinemotion/core/filtering.py,sha256=f-m-aA59e4WqE6u-9MA51wssu7rI-Y_7n1cG8IWdeRQ,11241
-kinemotion/core/formatting.py,sha256=G_3eqgOtym9RFOZVEwCxye4A2cyrmgvtQ214vIshowU,2480
-kinemotion/core/metadata.py,sha256=iz9YdkesHo-85TVBCoQVn7zkbrSde_fqjU79s_b-TZk,6829
-kinemotion/core/pose.py,sha256=ztemdZ_ysVVK3gbXabm8qS_dr1VfJX9KZjmcO-Z-iNE,8532
-kinemotion/core/quality.py,sha256=dPGQp08y8DdEUbUdjTThnUOUsALgF0D2sdz50cm6wLI,13098
-kinemotion/core/smoothing.py,sha256=J-GjFP6xW9TO4teOqFd5523zTY2jYIY1Nd99cZvoM3s,14110
-kinemotion/core/video_io.py,sha256=fDdyYVIKqUSgCjBJa8l_S0SrDPDAhrWYfsDBNRuz1oM,7549
-kinemotion/dropjump/__init__.py,sha256=yc1XiZ9vfo5h_n7PKVSiX2TTgaIfGL7Y7SkQtiDZj_E,838
-kinemotion/dropjump/analysis.py,sha256=Sz1lnAsQSp9fzkDy8AuqQtE47LKBqNwiLkaKzz4W_Wk,29099
-kinemotion/dropjump/cli.py,sha256=n_Wfv3AC6YIgRPYhO3F2nTSai0NR7fh95nAoWjryQeY,16250
-kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
-kinemotion/dropjump/kinematics.py,sha256=IH6nCOwTuocQNX1VPS_am9vPpMRUUla0a0MjDhEiXnA,17129
-kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.34.0.dist-info/METADATA,sha256=nXaUGuRRgIpqZt2D9iEhrsP9bmAAXRORt6WHb27RNAI,26020
-kinemotion-0.34.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-kinemotion-0.34.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.34.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.34.0.dist-info/RECORD,,