How shubhankarmondal/four-ur5e-cooperative-transport works
This repository is a MuJoCo simulation and demonstration of four UR5e arms cooperatively transporting a plate through contact grasps. The user-facing workflow builds or loads the scene, initializes grasp configurations, follows a payload trajectory under closed-loop control, and optionally records and renders the run. The graph includes documented validation and scene-building capabilities. Runtime call evidence is limited to the shown excerpts and SOURCE INDEX references; unsampled internal links are omitted where not established.
Main entry points: demo.py Interactive Demo · run_demo.py Run and Record · render.py Video Demo · controller.py Cooperative Controller
Components 17
Scene and Models
- MuJoCo Scene
src/homtrans/scene.py - Robot Assets
assets - Transport Model
models/four_ur5e_transport.xml - Scene Builder
scripts/build_scene.py
Motion and Grasp
- Payload Trajectory
src/homtrans/trajectory.py - Grasp IK
src/homtrans/kinematics.py
Control and Simulation
- Cooperative Controller
src/homtrans/controller.py - Wrench Allocation
src/homtrans/allocation.py - Simulation Loop
src/homtrans/simulation.py
Demo and Rendering
- Interactive Demo
scripts/demo.py - Run and Record
scripts/run_demo.py - Video Demo
scripts/render.py - Recording and Renderer
src/homtrans/render.py
Validation
- Validation Suite
scripts/validate.py
Other components
- User
- MuJoCo Viewer
- Rendered Video
Connections 34
- User → Interactive Demo: starts demo
README.md - User → Run and Record: runs transport
README.md - User → Video Demo: renders demo
README.md - User → Validation Suite: validates run
README.md - Scene Builder → MuJoCo Scene: builds from
scripts/build_scene.py - MuJoCo Scene → Robot Assets: uses models
README.md - MuJoCo Scene → Transport Model: defines model
README.md - Interactive Demo → Transport Model: loads model
scripts/demo.py - Interactive Demo → Payload Trajectory: creates reference
scripts/demo.py - Interactive Demo → Cooperative Controller: creates controller
scripts/demo.py - Interactive Demo → Grasp IK: initializes arms
scripts/demo.py - Interactive Demo → Simulation Loop: runs headless
scripts/demo.py - Interactive Demo → MuJoCo Viewer: steps interactively
scripts/demo.py - Run and Record → Transport Model: loads model
scripts/run_demo.py - Run and Record → Payload Trajectory: creates reference
scripts/run_demo.py - Run and Record → Cooperative Controller: creates controller
scripts/run_demo.py - Run and Record → Grasp IK: initializes arms
scripts/run_demo.py - Run and Record → Simulation Loop: runs simulation
scripts/run_demo.py - Run and Record → Recording and Renderer: records frames
scripts/run_demo.py - Video Demo → Transport Model: loads model
scripts/render.py - Video Demo → Payload Trajectory: creates reference
scripts/render.py - Video Demo → Cooperative Controller: creates controller
scripts/render.py - Video Demo → Grasp IK: initializes arms
scripts/render.py - Video Demo → Simulation Loop: runs simulation
scripts/render.py - Video Demo → Recording and Renderer: renders recording
scripts/render.py - Simulation Loop → Cooperative Controller: computes commands
README.md - Simulation Loop → Payload Trajectory: tracks reference
README.md - Cooperative Controller → Wrench Allocation: allocates wrench
src/homtrans/controller.py - Cooperative Controller → Payload Trajectory: samples reference
src/homtrans/controller.py - Recording and Renderer → Rendered Video: writes video
README.md - Validation Suite → Cooperative Controller: checks behavior
scripts/validate.py - Validation Suite → Grasp IK: checks workspace
scripts/validate.py - Validation Suite → Payload Trajectory: checks motion
scripts/validate.py - Validation Suite → Rendered Video: checks correspondence
scripts/validate.py