kinemotion 0.14.3__py3-none-any.whl → 0.15.0__py3-none-any.whl

kinemotion/__init__.py

@@ -3,12 +3,12 @@
 from .api import (
     CMJVideoConfig,
     CMJVideoResult,
-    VideoConfig,
-    VideoResult,
+    DropJumpVideoConfig,
+    DropJumpVideoResult,
     process_cmj_video,
     process_cmj_videos_bulk,
-    process_video,
-    process_videos_bulk,
+    process_dropjump_video,
+    process_dropjump_videos_bulk,
 )
 from .cmj.kinematics import CMJMetrics
 from .dropjump.kinematics import DropJumpMetrics
@@ -17,10 +17,10 @@ __version__ = "0.1.0"
 
 __all__ = [
     # Drop jump API
-    "process_video",
-    "process_videos_bulk",
-    "VideoConfig",
-    "VideoResult",
+    "process_dropjump_video",
+    "process_dropjump_videos_bulk",
+    "DropJumpVideoConfig",
+    "DropJumpVideoResult",
     "DropJumpMetrics",
     # CMJ API
     "process_cmj_video",

kinemotion/api.py

@@ -322,8 +322,8 @@ def _generate_outputs(
 
 
 @dataclass
-class VideoResult:
-    """Result of processing a single video."""
+class DropJumpVideoResult:
+    """Result of processing a single drop jump video."""
 
     video_path: str
     success: bool
@@ -333,8 +333,8 @@ class VideoResult:
 
 
 @dataclass
-class VideoConfig:
-    """Configuration for processing a single video."""
+class DropJumpVideoConfig:
+    """Configuration for processing a single drop jump video."""
 
     video_path: str
     quality: str = "balanced"
@@ -349,7 +349,7 @@ class VideoConfig:
     tracking_confidence: float | None = None
 
 
-def process_video(
+def process_dropjump_video(
     video_path: str,
     quality: str = "balanced",
     output_video: str | None = None,
@@ -488,56 +488,56 @@ def process_video(
         return metrics
 
 
-def process_videos_bulk(
-    configs: list[VideoConfig],
+def process_dropjump_videos_bulk(
+    configs: list[DropJumpVideoConfig],
     max_workers: int = 4,
-    progress_callback: Callable[[VideoResult], None] | None = None,
-) -> list[VideoResult]:
+    progress_callback: Callable[[DropJumpVideoResult], None] | None = None,
+) -> list[DropJumpVideoResult]:
     """
-    Process multiple videos in parallel using ProcessPoolExecutor.
+    Process multiple drop jump videos in parallel using ProcessPoolExecutor.
 
     Args:
-        configs: List of VideoConfig objects specifying video paths and parameters
+        configs: List of DropJumpVideoConfig objects specifying video paths and parameters
         max_workers: Maximum number of parallel workers (default: 4)
         progress_callback: Optional callback function called after each video completes.
-                         Receives VideoResult object.
+                         Receives DropJumpVideoResult object.
 
     Returns:
-        List of VideoResult objects, one per input video, in completion order
+        List of DropJumpVideoResult objects, one per input video, in completion order
 
     Example:
         >>> configs = [
-        ...     VideoConfig("video1.mp4"),
-        ...     VideoConfig("video2.mp4", quality="accurate"),
-        ...     VideoConfig("video3.mp4", output_video="debug3.mp4"),
+        ...     DropJumpVideoConfig("video1.mp4"),
+        ...     DropJumpVideoConfig("video2.mp4", quality="accurate"),
+        ...     DropJumpVideoConfig("video3.mp4", output_video="debug3.mp4"),
         ... ]
-        >>> results = process_videos_bulk(configs, max_workers=4)
+        >>> results = process_dropjump_videos_bulk(configs, max_workers=4)
         >>> for result in results:
         ...     if result.success:
         ...         print(f"{result.video_path}: {result.metrics.jump_height_m:.3f}m")
         ...     else:
         ...         print(f"{result.video_path}: FAILED - {result.error}")
     """
-    results: list[VideoResult] = []
+    results: list[DropJumpVideoResult] = []
 
     # Use ProcessPoolExecutor for CPU-bound video processing
     with ProcessPoolExecutor(max_workers=max_workers) as executor:
         # Submit all jobs
         future_to_config = {
-            executor.submit(_process_video_wrapper, config): config
+            executor.submit(_process_dropjump_video_wrapper, config): config
             for config in configs
         }
 
         # Process results as they complete
         for future in as_completed(future_to_config):
             config = future_to_config[future]
-            result: VideoResult
+            result: DropJumpVideoResult
 
             try:
                 result = future.result()
             except Exception as exc:
                 # Handle unexpected errors
-                result = VideoResult(
+                result = DropJumpVideoResult(
                     video_path=config.video_path,
                     success=False,
                     error=f"Unexpected error: {str(exc)}",
@@ -552,20 +552,20 @@ def process_videos_bulk(
     return results
 
 
-def _process_video_wrapper(config: VideoConfig) -> VideoResult:
+def _process_dropjump_video_wrapper(config: DropJumpVideoConfig) -> DropJumpVideoResult:
     """
     Wrapper function for parallel processing. Must be picklable (top-level function).
 
     Args:
-        config: VideoConfig object with processing parameters
+        config: DropJumpVideoConfig object with processing parameters
 
     Returns:
-        VideoResult object with metrics or error information
+        DropJumpVideoResult object with metrics or error information
     """
     start_time = time.time()
 
     try:
-        metrics = process_video(
+        metrics = process_dropjump_video(
             video_path=config.video_path,
             quality=config.quality,
             output_video=config.output_video,
@@ -582,7 +582,7 @@ def _process_video_wrapper(config: VideoConfig) -> VideoResult:
 
         processing_time = time.time() - start_time
 
-        return VideoResult(
+        return DropJumpVideoResult(
             video_path=config.video_path,
             success=True,
             metrics=metrics,
@@ -592,7 +592,7 @@ def _process_video_wrapper(config: VideoConfig) -> VideoResult:
     except Exception as e:
         processing_time = time.time() - start_time
 
-        return VideoResult(
+        return DropJumpVideoResult(
             video_path=config.video_path,
             success=False,
             error=str(e),

{kinemotion-0.14.3.dist-info → kinemotion-0.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.14.3
+Version: 0.15.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
@@ -191,7 +191,7 @@ Use kinemotion as a library for automated pipelines and custom analysis.
 ### Drop Jump API
 
 ```python
-from kinemotion import process_video
+from kinemotion import process_dropjump_video
 
 # Process a single video
 metrics = process_video(
@@ -211,7 +211,7 @@ print(f"Flight time: {metrics.flight_time * 1000:.1f} ms")
 
 ```python
 # Drop jump bulk processing
-from kinemotion import VideoConfig, process_videos_bulk
+from kinemotion import DropJumpVideoConfig, process_dropjump_videos_bulk
 
 configs = [
     VideoConfig("video1.mp4", drop_height=0.40),

{kinemotion-0.14.3.dist-info → kinemotion-0.15.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-kinemotion/__init__.py,sha256=REBC9wrwYC_grvCS00qEOyign65Zc1sc-5buLpyqQxA,654
-kinemotion/api.py,sha256=jcUVn8UHysj8GNzdNShf3y2pp20G4iTBb1jvkpptUvU,31116
+kinemotion/__init__.py,sha256=vAEIg-oDX1ZkQMnWgXd__tekaA5KUcEvdJSAGWS8VUY,722
+kinemotion/api.py,sha256=T9oqDxelyrVPhWifxUV8BVm8lu9sTREBLkEbT9fr678,31360
 kinemotion/cli.py,sha256=cqYV_7URH0JUDy1VQ_EDLv63FmNO4Ns20m6s1XAjiP4,464
 kinemotion/cmj/__init__.py,sha256=Ynv0-Oco4I3Y1Ubj25m3h9h2XFqeNwpAewXmAYOmwfU,127
 kinemotion/cmj/analysis.py,sha256=4HYGn4VDIB6oExAees-VcPfpNgWOltpgwjyNTU7YAb4,18263
@@ -21,8 +21,8 @@ kinemotion/dropjump/cli.py,sha256=Oni7gntysA6Zwb_ehsAnk6Ytd2ofUhN0yXVCsCsiris,21
 kinemotion/dropjump/debug_overlay.py,sha256=LkPw6ucb7beoYWS4L-Lvjs1KLCm5wAWDAfiznUeV2IQ,5668
 kinemotion/dropjump/kinematics.py,sha256=txDxpDti3VJVctWGbe3aIrlIx83UY8-ynzlX01TOvTA,15577
 kinemotion/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kinemotion-0.14.3.dist-info/METADATA,sha256=bXdkMbmQD9B1Bg7ZeZpLySZdOvAAJG0tIfiwf9-LgxU,19010
-kinemotion-0.14.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-kinemotion-0.14.3.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
-kinemotion-0.14.3.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
-kinemotion-0.14.3.dist-info/RECORD,,
+kinemotion-0.15.0.dist-info/METADATA,sha256=IIkd1kZxf_Enam5KcY2dEAoIf0r5_ykJFUhfRuOn8KE,19036
+kinemotion-0.15.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+kinemotion-0.15.0.dist-info/entry_points.txt,sha256=zaqnAnjLvcdrk1Qvj5nvXZCZ2gp0prS7it1zTJygcIY,50
+kinemotion-0.15.0.dist-info/licenses/LICENSE,sha256=KZajvqsHw0NoOHOi2q0FZ4NBe9HdV6oey-IPYAtHXfg,1088
+kinemotion-0.15.0.dist-info/RECORD,,