Open Source Robotics

精選高品質的開源機器人專案、工具與軟體,推動機器人社群向前發展。

robot_descriptions.py

將 135 個以上的開源機器人描述載入為可匯入模組的 Python 函式庫

授權條款

Apache-2.0

概述

robot_descriptions.py 是一個 Python 函式庫,以可匯入的 Python 模組形式,提供以程式存取超過 135 個開源機器人描述檔(URDF 與 MJCF 格式)的方式。第一次匯入某個機器人描述時,函式庫會自動下載並快取相關的模型檔案。之後的匯入則使用快取版本,讓載入機器人模型以進行模擬、運動規劃與控制研究變得毫不費力。

這個函式庫內建六個熱門機器人平台的載入器:MuJoCo、Pinocchio、iDynTree、PyBullet、RoboMeshCat 與 yourdfpy。研究人員與開發者只需幾行程式碼,就能把任何支援的機器人載入自己的模擬或控制流程,不必手動下載 URDF/MJCF 檔案或管理檔案路徑。這個套件可透過 pip 與 conda-forge 安裝。

機器人目錄涵蓋手臂、雙足機器人、人形機器人、四足機器人、無人機、移動操作機器人、末端執行器、雙臂系統、教育用機器人與輪式平台。收錄的模型來自主要製造商與研究實驗室,包括 Universal Robots、KUKA、Franka Emika、Boston Dynamics、Unitree 與 Agility Robotics。

robot_descriptions.py 為載入機器人描述檔提供統一的 Python 介面:

用法:將任何機器人模型當作 Python 模組匯入。第一次匯入時,函式庫會自動下載並快取描述檔。

框架載入器:內建函式,可將模型直接載入 MuJoCo、Pinocchio、iDynTree、PyBullet、RoboMeshCat 與 yourdfpy。

機器人目錄(10 個類別、135 個以上的機器人): - 手臂:UR3/5/10、KUKA iiwa/LBR、Franka Panda、xArm、Gen3 等 - 人形機器人:Atlas、Digit、H1、NAO、Talos、Valkyrie 等 - 四足機器人:ANYmal、Go1/2、A1、Solo、Mini Cheetah 等 - 末端執行器:Allegro、Robotiq、Shadow Hand 等 - 另有雙足機器人、無人機、雙臂、教育用、移動操作機器人與輪式機器人

格式:支援 URDF(Unified Robot Description Format)與 MJCF(MuJoCo XML Format)。

由 Stephane Caron(Inria)維護,他也開發了 mink、qpsolvers 與 Upkie 機器人。這個函式庫已有 900 次以上的提交,並定期發布新版本。

為何重要

每位機器人研究人員都需要機器人描述檔,而手動尋找、下載與設定它們是一項反覆出現的繁瑣工作。robot_descriptions.py 將這件事變成一行 Python 匯入,並適用於所有主要的模擬框架。它收錄 135 個以上的機器人,並內建 MuJoCo、Pinocchio、PyBullet 等的載入器,已成為在 Python 中載入機器人模型的標準方式。

解決的問題

要把機器人模型載入模擬,需要找到正確的 URDF/MJCF 儲存庫、複製下來、修正檔案路徑,並為每個模擬器撰寫樣板程式碼。robot_descriptions.py 以一行簡單的 import 陳述式完全免除這些步驟,自動處理下載、快取與各框架專屬的載入。

重點

  • 135 個以上的機器人描述,可作為 Python 模組匯入,並自動下載與快取
  • 內建六個框架的載入器:MuJoCo、Pinocchio、iDynTree、PyBullet、RoboMeshCat、yourdfpy
  • 涵蓋 10 個類別:手臂、雙足機器人、人形機器人、四足機器人、無人機、末端執行器等
  • 可透過 pip 與 conda-forge 安裝,支援 Python 3.8 以上版本
  • 是 Awesome Robot Descriptions 精選清單(GitHub 星星數 1,400 以上)的配套專案

適用對象

  • 建置模擬環境的機器人研究人員
  • 以不同機器人進行原型開發的運動規劃與控制開發者
  • 需要快速取得機器人模型的機器人學習者
  • 打造需要標準化機器人模型存取之工具的框架開發者

限制

  • 只收錄採用寬鬆開源授權的描述檔
  • URDF 模型的慣性或碰撞屬性品質可能參差不齊
  • 第一次匯入時需要網路連線以下載模型檔案
  • 不包含網格最佳化或模型驗證工具

本網站需要 JavaScript 才能正常運作。請啟用 JavaScript 以瀏覽我們的開源機器人專案。