pose-platform 1.25.0__tar.gz

pose-platform-1.25.0/MANIFEST.in

@@ -0,0 +1,50 @@
+# ── 后端/API（完整 Pose Platform 才有）──
+prune products/sports_assistant
+prune products/rehab_app
+prune api
+
+# ── Auth / DB（仅后端需要）──
+prune pose_platform_core/auth
+prune pose_platform_core/db
+exclude pose_platform_core/config.py
+
+# ── 后端/运维模块 ──
+exclude pose_platform_core/feedback_triage.py
+exclude pose_platform_core/monitoring.py
+exclude pose_platform_core/observability.py
+exclude pose_platform_core/rate_limiter.py
+exclude pose_platform_core/capability_negotiator.py
+exclude pose_platform_core/wtp_analysis.py
+
+# ── CLI 后端/内部命令 ──
+exclude products/pose_cli/admin_client.py
+exclude products/pose_cli/cmd_annotations.py
+exclude products/pose_cli/cmd_calib.py
+exclude products/pose_cli/cmd_data_seed.py
+exclude products/pose_cli/cmd_deploy.py
+exclude products/pose_cli/cmd_ops.py
+exclude products/pose_cli/cmd_rxlib.py
+exclude products/pose_cli/cmd_wtp.py
+
+# ── 平台层运动（不包含在 CLI 公开包中）──
+prune capabilities/tools/badminton
+prune capabilities/tools/_internal
+prune capabilities/recognition
+exclude capabilities/mcp_server.py
+
+# ── data_hub DB/标注模块 ──
+prune data_hub/registry
+prune data_hub/annotation
+prune data_hub/annotations
+prune data_hub/catalog
+exclude data_hub/pipeline/purge.py
+exclude data_hub/pipeline/template_slicer.py
+
+# ── Web 标注工具静态文件 ──
+include products/pose_cli/annotate/static/index.html
+
+# ── 开发文件 ──
+prune tests
+prune docs
+prune .pytest_cache
+prune .pose

pose-platform-1.25.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.1
+Name: pose-platform
+Version: 1.25.0
+Summary: Pose CLI — open motion-analysis toolkit for sports scientists
+License: Pose Platform License v1.0
+Project-URL: Homepage, https://posecap.com/posecli/
+Project-URL: Documentation, https://posecap.com/posecli/docs/
+Project-URL: Repository, https://github.com/posecap/pose-platform
+Keywords: motion-analysis,sports-science,biomechanics,skeleton-tracking,pose-estimation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: llm
+Provides-Extra: server
+
+# Pose CLI
+
+**Open motion-analysis toolkit for sports scientists.**
+`pip install pose-platform` — analyze 3D skeleton data on your machine.
+
+[![PyPI version](https://img.shields.io/pypi/v/pose-platform)](https://pypi.org/project/pose-platform/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+
+```bash
+pip install pose-platform
+pose analyze data/session.csv --tool stats
+```
+
+---
+
+## What is Pose CLI?
+
+Pose CLI turns 3D body-skeleton data into reproducible sports analytics.
+It runs **entirely on your machine** — your data never leaves your computer.
+
+```
+Pose Coach Recording → JointData3D CSV → pose analyze --tool <name> → JSON Output
+```
+
+**11 built-in analysis tools**, two supported sports:
+
+| Category | Tools | Sport |
+|----------|-------|-------|
+| **General** (any movement) | `stats`, `detect_peak_energy`, `segment_motion_phases`, `detect_velocity`, `detect_action_boundaries`, `detect_highlight` | `freeplay` |
+| **Running** (reference implementation) | `measure_running_speed`, `score_sprint`, `analyze_running_gait`, `score_running_efficiency` | `sprint` |
+| **Multi-sport** | `analyze_motion_angles` | both |
+
+Sprint tools serve as a reference for building your own sport-specific tools.
+[See contributing guide →](https://posecap.com/posecli/docs/#contributing)
+
+## Quickstart
+
+```bash
+pip install pose-platform
+
+# Download sample data
+curl -O https://posecap.com/samples/sample_sprint.csv
+
+# Run your first analysis
+pose analyze sample_sprint.csv --tool stats
+
+# Explore available tools
+pose tools && pose sports
+
+# LLM-powered analysis (optional)
+export POSE_DEEPSEEK_API_KEY=sk-xxx
+pose chat ./data
+```
+
+## Installation
+
+- **Python 3.10+** required. Works on macOS, Linux, Windows.
+- **Optional**: `pip install openai anthropic` for LLM chat support.
+- **Full guide**: [posecap.com/posecli/docs/](https://posecap.com/posecli/docs/)
+
+## Data Format
+
+Pose CLI reads **JointData3D CSV** (12-column, no header):
+
+```
+timestamp, joint, wx, wy, wz, mx, my, mz, ldq_x, ldq_y, ldq_z, ldq_w
+```
+
+Record with Pose Coach (iOS, TestFlight) or convert from OpenPose / MediaPipe / motion capture.
+[Data format reference →](https://posecap.com/posecli/docs/#data-format)
+
+## Commands
+
+```bash
+pose analyze <file.csv> --tool <name> [--param key=value]  # Run analysis
+pose tools [--sport <id>] [--detail]                         # List tools
+pose sports                                                   # List sports
+pose gaps list|submit|show|summary                            # Track feature requests
+pose chat [data_dir]                                          # LLM-powered analysis
+pose cache list|clear                                         # Manage cache
+pose telemetry stats [--since 7d]                             # Usage statistics
+pose version [--changelog]                                    # Version info
+```
+
+## Extending Pose CLI
+
+Every analysis tool is a Python class. Build your own:
+
+```python
+from capabilities.tools.base import DirectTool
+from capabilities.tools.loader import load_pose
+import json
+from pathlib import Path
+
+class MyTool(DirectTool):
+    name = "my_tool"
+    supported_sports = ["basketball"]  # or [] for all
+    input_schema = {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
+
+    def run(self, tool_input: dict, output_dir: Path) -> str:
+        pose = load_pose(tool_input["path"])
+        # your analysis here
+        return json.dumps({"result": 42}, ensure_ascii=False)
+```
+
+Register a new sport in 3 lines of config.
+[Contributing →](https://posecap.com/posecli/docs/#contributing)
+
+## From Source (Platform Developers)
+
+Pose CLI is the public distribution of the Pose Platform. The full platform
+(in this repository) also includes the Pose Coach backend, operations tooling,
+and badminton-specific analysis tools — these are excluded from the pip package.
+
+```bash
+git clone <repo-url>
+cd pose_platform
+pip install -e .
+```
+
+## License
+
+Pose CLI is distributed under the [Pose Platform License v1.0](LICENSE.txt):
+- **Research use**: free for academic and educational purposes
+- **Commercial use**: requires a separate agreement
+- **Attribution**: cite the Pose Platform in publications
+
+## Citation
+
+```bibtex
+@software{pose_platform,
+  title = {Pose Platform: Open Motion Analysis Toolkit},
+  author = {{PoseCap Inc.}},
+  year = {2026},
+  url = {https://github.com/posecap/pose-platform},
+}
+```

pose-platform-1.25.0/README.md

@@ -0,0 +1,137 @@
+# Pose CLI
+
+**Open motion-analysis toolkit for sports scientists.**
+`pip install pose-platform` — analyze 3D skeleton data on your machine.
+
+[![PyPI version](https://img.shields.io/pypi/v/pose-platform)](https://pypi.org/project/pose-platform/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+
+```bash
+pip install pose-platform
+pose analyze data/session.csv --tool stats
+```
+
+---
+
+## What is Pose CLI?
+
+Pose CLI turns 3D body-skeleton data into reproducible sports analytics.
+It runs **entirely on your machine** — your data never leaves your computer.
+
+```
+Pose Coach Recording → JointData3D CSV → pose analyze --tool <name> → JSON Output
+```
+
+**11 built-in analysis tools**, two supported sports:
+
+| Category | Tools | Sport |
+|----------|-------|-------|
+| **General** (any movement) | `stats`, `detect_peak_energy`, `segment_motion_phases`, `detect_velocity`, `detect_action_boundaries`, `detect_highlight` | `freeplay` |
+| **Running** (reference implementation) | `measure_running_speed`, `score_sprint`, `analyze_running_gait`, `score_running_efficiency` | `sprint` |
+| **Multi-sport** | `analyze_motion_angles` | both |
+
+Sprint tools serve as a reference for building your own sport-specific tools.
+[See contributing guide →](https://posecap.com/posecli/docs/#contributing)
+
+## Quickstart
+
+```bash
+pip install pose-platform
+
+# Download sample data
+curl -O https://posecap.com/samples/sample_sprint.csv
+
+# Run your first analysis
+pose analyze sample_sprint.csv --tool stats
+
+# Explore available tools
+pose tools && pose sports
+
+# LLM-powered analysis (optional)
+export POSE_DEEPSEEK_API_KEY=sk-xxx
+pose chat ./data
+```
+
+## Installation
+
+- **Python 3.10+** required. Works on macOS, Linux, Windows.
+- **Optional**: `pip install openai anthropic` for LLM chat support.
+- **Full guide**: [posecap.com/posecli/docs/](https://posecap.com/posecli/docs/)
+
+## Data Format
+
+Pose CLI reads **JointData3D CSV** (12-column, no header):
+
+```
+timestamp, joint, wx, wy, wz, mx, my, mz, ldq_x, ldq_y, ldq_z, ldq_w
+```
+
+Record with Pose Coach (iOS, TestFlight) or convert from OpenPose / MediaPipe / motion capture.
+[Data format reference →](https://posecap.com/posecli/docs/#data-format)
+
+## Commands
+
+```bash
+pose analyze <file.csv> --tool <name> [--param key=value]  # Run analysis
+pose tools [--sport <id>] [--detail]                         # List tools
+pose sports                                                   # List sports
+pose gaps list|submit|show|summary                            # Track feature requests
+pose chat [data_dir]                                          # LLM-powered analysis
+pose cache list|clear                                         # Manage cache
+pose telemetry stats [--since 7d]                             # Usage statistics
+pose version [--changelog]                                    # Version info
+```
+
+## Extending Pose CLI
+
+Every analysis tool is a Python class. Build your own:
+
+```python
+from capabilities.tools.base import DirectTool
+from capabilities.tools.loader import load_pose
+import json
+from pathlib import Path
+
+class MyTool(DirectTool):
+    name = "my_tool"
+    supported_sports = ["basketball"]  # or [] for all
+    input_schema = {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
+
+    def run(self, tool_input: dict, output_dir: Path) -> str:
+        pose = load_pose(tool_input["path"])
+        # your analysis here
+        return json.dumps({"result": 42}, ensure_ascii=False)
+```
+
+Register a new sport in 3 lines of config.
+[Contributing →](https://posecap.com/posecli/docs/#contributing)
+
+## From Source (Platform Developers)
+
+Pose CLI is the public distribution of the Pose Platform. The full platform
+(in this repository) also includes the Pose Coach backend, operations tooling,
+and badminton-specific analysis tools — these are excluded from the pip package.
+
+```bash
+git clone <repo-url>
+cd pose_platform
+pip install -e .
+```
+
+## License
+
+Pose CLI is distributed under the [Pose Platform License v1.0](LICENSE.txt):
+- **Research use**: free for academic and educational purposes
+- **Commercial use**: requires a separate agreement
+- **Attribution**: cite the Pose Platform in publications
+
+## Citation
+
+```bibtex
+@software{pose_platform,
+  title = {Pose Platform: Open Motion Analysis Toolkit},
+  author = {{PoseCap Inc.}},
+  year = {2026},
+  url = {https://github.com/posecap/pose-platform},
+}
+```

pose-platform-1.25.0/capabilities/tools/_audio_utils.py

@@ -0,0 +1,85 @@
+"""
+Audio sidecar utilities for loading and matching iOS hit-sound events.
+
+Sidecar format (schemaVersion=1):
+{
+    "schemaVersion": 1,
+    "segmentStartSeconds": float,
+    "segmentEndSeconds": float,
+    "detectorThresholdRatio": 2.5,
+    "events": [{"timestampSeconds": float, "ratio": float}, ...]
+}
+
+Naming convention (confirmed from AudioEventsSidecar.swift):
+    <sessionStem>_audio_events.json
+where sessionStem = csv stem with "_3d" / "_2d" suffix stripped.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+_AUDIO_SIDECAR_SUFFIX = "_audio_events.json"
+
+# ARSession audio buffer introduces a fixed ~21 ms delay relative to body3D timestamps.
+_AUDIO_SYSTEMATIC_DELAY_S = 0.021
+
+# Tolerance for matching an audio event to a detected swing peak.
+# Accounts for: delay compensation residual + frame quantisation (~1/fps at 60 Hz ≈ 17 ms).
+AUDIO_PEAK_TOL_S = 0.06
+
+
+def _sidecar_path(csv_path: Path) -> Path:
+    """Return the expected audio sidecar path for a given body-3D CSV."""
+    stem = csv_path.stem
+    for sfx in ("_3d", "_2d"):
+        if stem.endswith(sfx):
+            stem = stem[: -len(sfx)]
+            break
+    return csv_path.parent / (stem + _AUDIO_SIDECAR_SUFFIX)
+
+
+def load_audio_events(csv_path: Path) -> list[dict]:
+    """
+    Load audio hit-sound events from the companion sidecar file.
+
+    Returns an empty list when the sidecar does not exist (silent degradation).
+    Applies systematic delay compensation and filters events below the detector
+    threshold used at recording time.
+
+    Return format: [{"time_s": float, "ratio": float}, ...] sorted by time_s.
+    """
+    sidecar = _sidecar_path(csv_path)
+    if not sidecar.exists():
+        return []
+
+    raw = json.loads(sidecar.read_text(encoding="utf-8"))
+    threshold = raw.get("detectorThresholdRatio", 2.5)
+    events = [
+        {
+            "time_s": e["timestampSeconds"] - _AUDIO_SYSTEMATIC_DELAY_S,
+            "ratio": e["ratio"],
+        }
+        for e in raw.get("events", [])
+        if e["ratio"] >= threshold
+    ]
+    return sorted(events, key=lambda x: x["time_s"])
+
+
+def audio_corroborates(
+    peak_s: float,
+    audio_events: list[dict],
+    tol_s: float = AUDIO_PEAK_TOL_S,
+) -> tuple[bool, float | None]:
+    """
+    Check whether any audio event falls within *tol_s* of *peak_s*.
+
+    Returns (matched, best_ratio) where best_ratio is the highest ratio among
+    matching events, or None when no event matches.
+    """
+    matches = [e for e in audio_events if abs(e["time_s"] - peak_s) < tol_s]
+    if not matches:
+        return False, None
+    best = max(matches, key=lambda x: x["ratio"])
+    return True, best["ratio"]