rtmlib 可视化指南:draw_skeleton 的两种骨架风格与参数调优

原创2026-11-02 16:32:511,731 阅读

rtmlib 可视化指南:draw_skeleton 的两种骨架风格与参数调优

rtmlib 是一个无需 mmcv、mmpose 等重型依赖的人体姿态估计库,内置了简洁的骨架可视化函数 draw_skeleton,支持 mmpose 与 openpose 两种渲染风格。本文带你快速掌握 draw_skeleton 的两种骨架风格差异、自动骨架类型匹配机制,以及 kpt_thr、radius、line_width 等关键参数的调优技巧。

🎯 draw_skeleton 是什么?

在姿态估计中,模型输出的只是关键点坐标(keypoints)和置信度(scores)。要看到"骨架"效果,就需要可视化模块。rtmlib 把这些能力封装成了一个函数:

它的工作流程非常简单:

from rtmlib import Wholebody, draw_skeleton

keypoints, scores = wholebody(img)
img = draw_skeleton(img, keypoints, scores, kpt_thr=0.5)

rtmlib 姿态估计演示图片:足球场上两名运动员,用于 draw_skeleton 骨架可视化输入

上方为官方仓库自带的 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/ 目录。

登录后查看全文
rtmlib