Open Source Robotics

Una raccolta curata di progetti, strumenti e software di robotica open source di alta qualità per la comunità della robotica.

robot_descriptions.py

Libreria Python che carica oltre 135 descrizioni di robot open source come moduli importabili

Licenza

Apache-2.0

Panoramica

robot_descriptions.py è una libreria Python che fornisce accesso programmatico a oltre 135 file di descrizione di robot open source (in formato URDF e MJCF) come moduli Python importabili. Quando una descrizione di robot viene importata per la prima volta, la libreria scarica automaticamente i file del modello e li mette in cache. Le importazioni successive usano la versione in cache, il che rende immediato caricare modelli di robot per la ricerca su simulazione, pianificazione del movimento e controllo.

La libreria include loader integrati per sei piattaforme robotiche diffuse: MuJoCo, Pinocchio, iDynTree, PyBullet, RoboMeshCat e yourdfpy. Ricercatori e sviluppatori possono caricare qualsiasi robot supportato nella propria pipeline di simulazione o di controllo con poche righe di codice, senza scaricare manualmente file URDF/MJCF né gestire percorsi di file. Il pacchetto si installa sia tramite pip sia tramite conda-forge.

Il catalogo di robot comprende bracci, bipedi, umanoidi, quadrupedi, droni, manipolatori mobili, end effector, sistemi a doppio braccio, robot didattici e piattaforme su ruote. Copre modelli dei principali produttori e laboratori di ricerca, tra cui Universal Robots, KUKA, Franka Emika, Boston Dynamics, Unitree e Agility Robotics.

robot_descriptions.py fornisce un'interfaccia Python unificata per caricare i file di descrizione dei robot:

Uso: si importa qualsiasi modello di robot come modulo Python. Alla prima importazione, la libreria scarica i file di descrizione e li mette in cache automaticamente.

Loader per i framework: funzioni integrate per caricare i modelli direttamente in MuJoCo, Pinocchio, iDynTree, PyBullet, RoboMeshCat e yourdfpy.

Catalogo di robot (oltre 135 robot in 10 categorie): - Bracci: UR3/5/10, KUKA iiwa/LBR, Franka Panda, xArm, Gen3 e altri - Umanoidi: Atlas, Digit, H1, NAO, Talos, Valkyrie e altri - Quadrupedi: ANYmal, Go1/2, A1, Solo, Mini Cheetah e altri - End effector: Allegro, Robotiq, Shadow Hand e altri - Inoltre bipedi, droni, doppi bracci, robot didattici, manipolatori mobili e robot su ruote

Formati: supporta URDF (Unified Robot Description Format) e MJCF (MuJoCo XML Format).

È mantenuta da Stephane Caron (Inria), che sviluppa anche mink, qpsolvers e il robot Upkie. La libreria conta oltre 900 commit e release regolari.

Perché è importante

Ogni ricercatore di robotica ha bisogno di file di descrizione dei robot, e trovarli, scaricarli e configurarli a mano è un compito noioso e ricorrente. robot_descriptions.py lo trasforma in un'importazione Python di una riga che funziona con tutti i principali framework di simulazione. Con oltre 135 robot e loader integrati per MuJoCo, Pinocchio, PyBullet e altri, è diventata il modo standard per caricare modelli di robot in Python.

Il problema che risolve

Caricare un modello di robot in una simulazione richiede di trovare il repository URDF/MJCF giusto, clonarlo, correggere i percorsi dei file e scrivere codice boilerplate per ogni simulatore. robot_descriptions.py elimina del tutto questo lavoro con una semplice istruzione di importazione che gestisce automaticamente download, cache e caricamento specifico per ogni framework.

Punti chiave

  • Oltre 135 descrizioni di robot disponibili come moduli Python importabili, con download e cache automatici
  • Loader integrati per sei framework: MuJoCo, Pinocchio, iDynTree, PyBullet, RoboMeshCat, yourdfpy
  • Copre 10 categorie: bracci, bipedi, umanoidi, quadrupedi, droni, end effector e altre
  • Installabile tramite pip e conda-forge, con supporto a Python 3.8+
  • Complementare alla lista curata Awesome Robot Descriptions (oltre 1.400 stelle su GitHub)

A chi si rivolge

  • Ricercatori di robotica che configurano ambienti di simulazione
  • Sviluppatori di pianificazione del movimento e controllo che prototipano con robot diversi
  • Studenti di robotica che hanno bisogno di accedere rapidamente ai modelli di robot
  • Sviluppatori di framework che costruiscono strumenti con bisogno di un accesso standardizzato ai modelli di robot

Limiti

  • Include solo descrizioni con licenze open source permissive
  • I modelli URDF possono avere una qualità variabile nelle proprietà inerziali o di collisione
  • La prima importazione richiede una connessione a Internet per scaricare i file del modello
  • Non include strumenti di ottimizzazione delle mesh né di validazione dei modelli

Questo sito richiede JavaScript. Attiva JavaScript per esplorare i nostri progetti di robotica open source.