rtmlib 可视化指南:draw_skeleton 的两种骨架风格与参数调优
rtmlib 可视化指南:draw_skeleton 的两种骨架风格与参数调优
rtmlib 是一个无需 mmcv、mmpose 等重型依赖的人体姿态估计库,内置了简洁的骨架可视化函数 draw_skeleton,支持 mmpose 与 openpose 两种渲染风格。本文带你快速掌握 draw_skeleton 的两种骨架风格差异、自动骨架类型匹配机制,以及 kpt_thr、radius、line_width 等关键参数的调优技巧。
🎯 draw_skeleton 是什么?
在姿态估计中,模型输出的只是关键点坐标(keypoints)和置信度(scores)。要看到"骨架"效果,就需要可视化模块。rtmlib 把这些能力封装成了一个函数:
- 函数定义:rtmlib/visualization/draw.py
- 模块导出:rtmlib/visualization/init.py
- 骨架定义目录:rtmlib/visualization/skeleton/
它的工作流程非常简单:
from rtmlib import Wholebody, draw_skeleton
keypoints, scores = wholebody(img)
img = draw_skeleton(img, keypoints, scores, kpt_thr=0.5)
上方为官方仓库自带的 demo.jpg,正是各 demo 脚本的默认输入图
🎨 两种骨架风格:openpose_skeleton 参数详解
openpose_skeleton 是控制渲染风格的核心开关,取值 True 或 False:
风格一:mmpose 风格(默认,openpose_skeleton=False)
适合人体全身、半身、手部等场景,由 draw_mmpose 实现:
- 直线段连接相邻关节,简洁清爽
- 实心圆点表示关键点,每个关节自带固定配色(如左肩绿色、右肩橙色)
- 关键点置信度低于阈值时,该点及其连线自动隐藏
风格二:openpose 风格(openpose_skeleton=True)
适合动物姿态(Animal)、openpose18 等场景,由 draw_openpose 实现:
- **多边形"肌肉条"**绘制躯干与四肢,带 0.6 的半透明混合效果,更有立体感
- 关键点圆点更大、颜色更柔和,面部细节(如 openpose134 的 30+ 个面部点)渲染更细腻
- ⚠️ 注意:动物姿态估计(rtmlib/tools/solution/animal.py)必须使用该风格
两种风格内部的实现差异可对照源码:draw_skeleton 的骨架选择逻辑
⚡ 骨架类型自动匹配:不用手动指定
draw_skeleton 会根据关键点数量自动选择骨架定义,这是它最省心的地方:
| openpose_skeleton | 关键点数量 | 自动匹配的骨架 | 典型用途 |
|---|---|---|---|
| False | 17 | coco17 | 人体全身 |
| False | 133 | coco133 | 全身+面部 |
| False | 21 | hand21 | 手部 |
| False | 25 | coco25 | 全身+脚部 |
| False / True | 26 | halpe26 | 全身+手指 |
| True | 18 | openpose18 | openpose 人体 |
| True | 134 | openpose134 | openpose 人体+面部 |
| True | 17 | animal17 | 动物 17 关键点 |
每个骨架的颜色与连线关系都在对应文件中定义,例如 coco17.py 里为"左肩/右肩"分配了不同颜色,animal17.py 则定义了猫狗的 17 个关节。关键点数量与风格不匹配时会抛出 NotImplementedError,请确保与模型的 to_openpose 输出保持一致。
🎛️ 参数调优技巧:让骨架更清晰
draw_skeleton 共有 4 个可调参数,默认值如下:
def draw_skeleton(img, keypoints, scores,
openpose_skeleton=False,
kpt_thr=0.5, radius=2, line_width=2)
kpt_thr:置信度阈值(最常用)
- 作用:过滤低质量关键点,低于阈值的关键点不显示、连线断开
- 数值调高(如 0.6~0.7):画面更干净,但遮挡/模糊部位会"断骨"
- 数值调低(如 0.3~0.4):骨架更完整,但可能画出误检点
- 💡 经验值:人体场景常用
0.43,参考 body_with_feet_demo.py;animal_demo.py 同样采用0.43
radius:关键点圆点半径
- 默认
2,小图或远距离拍摄建议调到3~5,骨架点更醒目 - openpose 风格下内部会自动放大一倍(
radius * 2),所以通常无需手动加大
line_width:连线宽度
- 默认
2,高清大图或远距离监控画面建议3~4 - 同样,openpose 风格下会自动 ×2
完整调优示例
img = draw_skeleton(img, keypoints, scores,
openpose_skeleton=False,
kpt_thr=0.4, # 放宽阈值,保留更多骨架
radius=3, # 加大关键点
line_width=3) # 加粗连线
🚀 动手实践:3 个常用场景
场景 1:全身姿态(mmpose 风格) — 见 wholebody_demo.py,openpose_skeleton=False + kpt_thr=0.4
场景 2:动物姿态(必须 openpose 风格) — 见 animal_demo.py,openpose_skeleton=True + kpt_thr=0.43
场景 3:WebUI 实时调参 — 运行 webui.py(需 pip install gradio)即可在网页上切换风格与模型,效果最直观
📋 常见问题速查
| 问题 | 原因与解决 |
|---|---|
抛出 NotImplementedError |
关键点数量与 openpose_skeleton 不匹配,检查模型 to_openpose 设置 |
| 骨架"断骨"、缺胳膊少腿 | kpt_thr 过高,降到 0.3~0.4 试试 |
| 骨架点太小看不清 | 调大 radius(如 4)或 line_width(如 3) |
| 动物姿态画不出躯干 | 必须设置 openpose_skeleton=True |
总结
| 选择依据 | 推荐配置 |
|---|---|
| 人体全身/手部/脚部 | openpose_skeleton=False,mmpose 风格 |
| 动物姿态 / openpose18 / openpose134 | openpose_skeleton=True |
| 画面要干净 | kpt_thr 调高至 0.5~0.7 |
| 骨架要完整 | kpt_thr 调低至 0.3~0.4 |
| 大图远距离 | radius 与 line_width 各加 1~2 |
掌握 openpose_skeleton 风格开关 + kpt_thr 阈值这两个核心参数,就能覆盖 rtmlib 绝大多数骨架可视化需求。更多骨架颜色定义可查阅 rtmlib/visualization/skeleton/ 目录下的各文件,相关测试用例见 tests/ 目录。
