onshape-to-robot
Converte gli assiemi CAD di Onshape in descrizioni di robot URDF, SDF e MuJoCo
Licenza
MIT
Panoramica
onshape-to-robot è uno strumento Python che usa l'API di Onshape per recuperare i dati degli assiemi CAD e costruire automaticamente file di descrizione del robot adatti alla simulazione fisica. Colma il divario tra progettazione CAD e simulazione robotica convertendo gli assiemi Onshape nei formati di descrizione URDF, SDF e MuJoCo.
Lo strumento interpreta da Onshape la gerarchia dell'assieme, i mate connector, i tipi di giunto e le proprietà delle parti, e li traduce in modelli di robot ben strutturati con link, giunti, mesh STL, proprietà inerziali e geometrie di collisione. Supporta giunti rotoidali, prismatici e fissi, catene cinematiche chiuse, relazioni di ingranaggio, frame personalizzati e più link di base.
Le funzionalità principali includono l'integrazione diretta con l'API di Onshape per recuperare dati e geometria degli assiemi, l'esportazione automatica delle mesh, il trasferimento dei limiti dei giunti dai vincoli di Onshape, l'approssimazione con forme pure tramite OpenSCAD e 9 post-processori integrati per la semplificazione delle mesh, la decomposizione convessa (CoACD), l'unione di STL e altro.
Lo strumento include visualizzatori di simulazione integrati per PyBullet e MuJoCo, uno strumento di modifica delle forme e un'architettura di processori estendibile per trasformazioni personalizzate. È mantenuto attivamente, con l'ultima release (v1.8.4) a novembre 2026.
Sviluppato dal team Rhoban dell'Università di Bordeaux, noto per i suoi robot umanoidi calciatori della RoboCup.
onshape-to-robot è uno strumento Python sviluppato dal team Rhoban dell'Università di Bordeaux che automatizza la conversione degli assiemi CAD di Onshape in file di descrizione del robot per la simulazione fisica. Il team Rhoban è noto nella comunità robotica per i suoi robot umanoidi che giocano a calcio alla RoboCup, e questo strumento è nato dalla loro esigenza di passare rapidamente dalla progettazione meccanica alla simulazione e viceversa.
Lo strumento si collega direttamente all'API di Onshape e acquisisce i dati completi dell'assieme, compresi gerarchia, connettori di accoppiamento, tipi di giunto, proprietà dei pezzi e geometria. Li traduce in modelli di robot correttamente strutturati con link, giunti, mesh STL, proprietà inerziali e geometrie di collisione nei formati URDF, SDF e MuJoCo. I tipi di giunto supportati comprendono rotoidale, prismatico e fisso, con funzioni aggiuntive per catene cinematiche chiuse, relazioni tra ingranaggi, frame personalizzati e più link di base.
Una caratteristica di spicco è la pipeline di post-elaborazione con 9 processori integrati per la semplificazione delle mesh, la decomposizione convessa tramite CoACD, l'unione di STL, l'approssimazione con forme pure tramite OpenSCAD e altro. Lo strumento include anche visualizzatori integrati per PyBullet e MuJoCo per visualizzare e verificare subito i risultati della conversione, oltre a uno strumento di modifica delle forme per il perfezionamento manuale.
onshape-to-robot è mantenuto attivamente, con l'ultima release (v1.8.4) a novembre 2026, ed è diventato uno strumento standard per i team di robotica che usano Onshape per la progettazione meccanica. Elimina quello che tradizionalmente è uno dei passaggi più noiosi dello sviluppo robotico: portare un robot dal CAD alla simulazione.
Perché è importante
Portare un robot dal progetto CAD alla simulazione fisica è uno dei colli di bottiglia più noiosi dello sviluppo robotico. onshape-to-robot lo elimina recuperando direttamente gli assiemi Onshape e generando descrizioni URDF/SDF/MuJoCo pronte per la simulazione, con cinematica, dinamica e mesh corrette.
Il problema che risolve
Il processo manuale, noioso e soggetto a errori, di conversione degli assiemi CAD in file di descrizione del robot (URDF/SDF/MuJoCo) per la simulazione fisica
Punti chiave
- Integrazione diretta con l'API di Onshape: nessun passaggio di esportazione manuale
- Genera i formati URDF, SDF e MuJoCo da un'unica fonte
- 9 processori integrati per semplificazione delle mesh, decomposizione convessa e ottimizzazione
- Visualizzatori PyBullet e MuJoCo integrati per vedere subito i modelli convertiti
A chi si rivolge
- Ingegneri robotici che usano Onshape per il CAD
- Ingegneri di simulazione che hanno bisogno di file URDF/SDF
- Sviluppatori ROS che costruiscono descrizioni di robot
- Team hardware che iterano sui progetti dei robot
Limiti
- Funziona solo con Onshape: nessun supporto per SolidWorks, Fusion 360 o altre piattaforme CAD
- Richiede credenziali per l'API di Onshape (è disponibile un piano gratuito)
- Assiemi complessi con molte configurazioni possono richiedere una messa a punto manuale
- L'approssimazione con forme pure richiede l'installazione di OpenSCAD