How aks-lab-univertsity-of-tartu/bimanual_manipulation works
This is a ROS 2 dual-arm manipulation demo whose principal workflow is online planning: the demo coordinates an MPC/CEM planner, which uses MJX-based trajectory optimization and can use an IK solver to refine end-effector targets. The repository also includes a MuJoCo trajectory visualizer and a Mink differential-IK library with task and limit abstractions. The README documents the launch and visualization capabilities, but the robot model/configuration files it describes are absent from this tree. Relationships for unsampled implementations are included only where the README or source index documents them.
Main entry points: configuration.py Robot configuration · mpc_planner.py MPC / CEM · ik_solver.py IK solver · solve_ik.py QP IK solve
Components 20
ROS applications
- Demo launch
real_demo/launch/dual_arm_demo.launch.py - Dual-arm demo
real_demo/real_demo/dual_arm_demo.py - Visualizer launch
real_demo/launch/visualizer.launch.py - Trajectory visualizer
real_demo/real_demo/visualizer.py
Planning
- MPC / CEM
real_demo/sampling_based_planner/mpc_planner.py - MJX planner
real_demo/sampling_based_planner/mjx_planner.py - MLP projection
real_demo/sampling_based_planner/Simple_MLP/mlp_singledof.py - Quaternion math
real_demo/sampling_based_planner/quat_math.py
Inverse kinematics
- IK solver
real_demo/ik_based_planner/ik_solver.py - QP IK solve
real_demo/collision_free_ik/mink/solve_ik.py - Frame task
real_demo/collision_free_ik/mink/tasks/frame_task.py - Task objective
real_demo/collision_free_ik/mink/tasks/task.py
Mink foundations
- Robot configuration
real_demo/collision_free_ik/mink/configuration.py - Configuration limit
real_demo/collision_free_ik/mink/limits/configuration_limit.py - Collision limit
real_demo/collision_free_ik/mink/limits/collision_avoidance_limit.py - Limit interface
real_demo/collision_free_ik/mink/limits/limit.py - Lie geometry
real_demo/collision_free_ik/mink/lie - IK exceptions
real_demo/collision_free_ik/mink/exceptions.py
Demo data
- Setup and trajectories
real_demo/data
Other components
- Operator
Connections 26
- Operator → Demo launch: launches
- Demo launch → Dual-arm demo: starts
- Dual-arm demo → MPC / CEM: runs planning
real_demo/real_demo/dual_arm_demo.py - Dual-arm demo → Quaternion math: uses rotations
real_demo/real_demo/dual_arm_demo.py - Operator → Visualizer launch: launches
- Visualizer launch → Trajectory visualizer: starts
- Trajectory visualizer → Quaternion math: uses rotations
real_demo/real_demo/visualizer.py - Trajectory visualizer → Setup and trajectories: reads trajectories
- MPC / CEM → MJX planner: optimizes trajectory
real_demo/sampling_based_planner/mpc_planner.py - MPC / CEM → MLP projection: loads projection
real_demo/sampling_based_planner/mpc_planner.py - MPC / CEM → Quaternion math: uses rotations
real_demo/sampling_based_planner/mpc_planner.py - MPC / CEM → IK solver: solves targets
real_demo/sampling_based_planner/mpc_planner.py - IK solver → Robot configuration: initializes state
real_demo/ik_based_planner/ik_solver.py - IK solver → Frame task: sets target
real_demo/ik_based_planner/ik_solver.py - IK solver → Configuration limit: sets limit
real_demo/ik_based_planner/ik_solver.py - IK solver → QP IK solve: solves velocity
real_demo/ik_based_planner/ik_solver.py - QP IK solve → Task objective: builds objective
real_demo/collision_free_ik/mink/solve_ik.py - QP IK solve → Limit interface: builds inequalities
real_demo/collision_free_ik/mink/solve_ik.py - QP IK solve → Robot configuration: uses state
real_demo/collision_free_ik/mink/solve_ik.py - Frame task → Task objective: extends
real_demo/collision_free_ik/mink/tasks/frame_task.py - Frame task → Robot configuration: reads transforms
real_demo/collision_free_ik/mink/tasks/frame_task.py - Robot configuration → Lie geometry: builds transforms
real_demo/collision_free_ik/mink/configuration.py - Robot configuration → IK exceptions: raises errors
real_demo/collision_free_ik/mink/configuration.py - Configuration limit → Limit interface: implements
real_demo/collision_free_ik/mink/limits/configuration_limit.py - Collision limit → Limit interface: implements
real_demo/collision_free_ik/mink/limits/collision_avoidance_limit.py - Collision limit → Robot configuration: checks contacts
real_demo/collision_free_ik/mink/limits/collision_avoidance_limit.py