onshape-to-robot
將 Onshape CAD 組合件轉換為 URDF、SDF 與 MuJoCo 機器人描述
授權條款
MIT
概述
onshape-to-robot 是一個 Python 工具,它使用 Onshape API 取得 CAD 組合件資料,並自動建立適用於物理模擬的機器人描述檔。它將 Onshape 組合件轉換為 URDF、SDF 與 MuJoCo 描述格式,銜接 CAD 設計與機器人模擬之間的落差。
這個工具能理解 Onshape 中的組合件階層、配合連接器(mate connector)、關節類型與零件屬性,並將它們轉換為結構正確的機器人模型,包含連桿、關節、STL 網格、慣性屬性與碰撞幾何。它支援旋轉、滑動與固定關節,以及運動學迴路、齒輪關係、自訂座標框架與多個基座連桿。
主要功能包括:直接整合 Onshape API 以取得組合件資料與幾何、自動匯出網格、從 Onshape 約束轉移關節限位、透過 OpenSCAD 進行純幾何形狀近似,以及 9 個內建後處理器,用於網格簡化、凸分解(CoACD)、STL 合併等。
這個工具內建 PyBullet 與 MuJoCo 模擬檢視器、一個形狀編輯工具,以及可擴充的處理器架構,可進行自訂轉換。專案持續維護,最新版本(v1.8.4)於 2026 年 11 月發布。
由 University of Bordeaux 的 Rhoban 團隊開發,該團隊以 RoboCup 足球人形機器人聞名。
onshape-to-robot 是波爾多大學 Rhoban 團隊開發的 Python 工具,可將 Onshape CAD 組合件自動轉換為物理模擬用的機器人描述檔。Rhoban 團隊以其參加 RoboCup 足球賽的人形機器人在機器人社群中廣為人知,這個工具源自他們在機械設計與模擬之間快速迭代的需求。
此工具直接連接 Onshape API,取得完整的組合件資料,包括層級結構、結合連接器、關節類型、零件屬性與幾何。它將這些資料轉換為結構正確的機器人模型,包含連桿、關節、STL 網格、慣性屬性與碰撞幾何,輸出為 URDF、SDF 與 MuJoCo 格式。支援的關節類型包括旋轉、滑動與固定,另有運動學迴路、齒輪關係、自訂座標系與多個基座連桿等功能。
一大亮點是其後處理流程,內建 9 個處理器,可進行網格簡化、透過 CoACD 進行凸分解、合併 STL、透過 OpenSCAD 以純幾何形狀近似等。此工具也內建 PyBullet 與 MuJoCo 檢視器,可立即視覺化並驗證轉換結果,另有形狀編輯工具可手動微調。
onshape-to-robot 持續維護中,最新版本(v1.8.4)於 2026 年 11 月發布,已成為以 Onshape 進行機械設計的機器人團隊的標準工具。它省去了機器人開發中傳統上最繁瑣的步驟之一:把機器人從 CAD 帶進模擬。
為何重要
將機器人從 CAD 設計帶到物理模擬,是機器人開發中最繁瑣的瓶頸之一。onshape-to-robot 直接取得 Onshape 組合件,產生可直接用於模擬、運動學、動力學與網格皆正確的 URDF/SDF/MuJoCo 描述,消除了這個瓶頸。
解決的問題
以手動方式將 CAD 組合件轉換為物理模擬用的機器人描述檔(URDF/SDF/MuJoCo),過程繁瑣又容易出錯
重點
- 直接整合 Onshape API,不需手動匯出步驟
- 從單一來源產生 URDF、SDF 與 MuJoCo 格式
- 9 個內建處理器,用於網格簡化、凸分解與最佳化
- 內建 PyBullet 與 MuJoCo 檢視器,可立即視覺化轉換後的模型
適用對象
- 使用 Onshape 進行 CAD 設計的機器人工程師
- 需要 URDF/SDF 檔案的模擬工程師
- 建立機器人描述的 ROS 開發者
- 反覆迭代機器人設計的硬體團隊
限制
- 只適用於 Onshape,不支援 SolidWorks、Fusion 360 或其他 CAD 平台
- 需要 Onshape API 憑證(有免費方案)
- 具有多種配置的複雜組合件可能需要手動調整
- 純幾何形狀近似需要安裝 OpenSCAD