用途:面向 CMJ(反向纵跳)与落地跳(drop jump)的运动员视频分析工作流,覆盖分析执行、姿态检测调试、失败排查与批量处理。
主要能力:提供 CMJ 与落地跳两类分析命令,支持批量处理与质量预设,并可输出调试视频。CMJ 指标包括 jump_height_cm、flight_time_ms、countermovement_depth_cm、takeoff_velocity_m_s、triple_extension;落地跳指标包括 ground_contact_time_ms、flight_time_ms、reactive_strength_index、drop_height_cm。
使用方式:命令行执行 uv run kinemotion cmj-analyze <video> [--output debug.mp4] 或 uv run kinemotion dropjump-analyze <video> [--output debug.mp4];批量用 uv run kinemotion cmj-analyze videos/*.mp4 --batch --workers 4;质量预设 fast、balanced(默认)、accurate,例如 --quality accurate。也可用 Python API:from kinemotion import process_cmj_video, process_dropjump_video,调用 process_cmj_video("video.mp4", quality="balanced") 或 process_dropjump_video("video.mp4", quality="balanced")。
适用场景:指标异常、姿态检测排查、新视频验证、教练视频质量培训时建议加 --output debug.mp4,调试视频含骨架叠加与关节角度、阶段标记(起跳、落地、峰值)及实时指标。相机角度推荐 45° 斜侧,90° 侧向与正/背面不推荐。
限制与要求:视频需 30+ fps(建议 60+)、720p 以上、完整跳跃周期、均匀前向光、背景与运动员有对比、相机稳定(建议三脚架)。常见问题包括未检测到起跳、指标无效、关键点抖动、手机视频旋转(kinemotion 经 video_io.py 自动处理,必要时用 ffmpeg -i input.mp4 -vf "transpose=1" output.mp4 预处理)。