Open Source Robotics

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

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

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