---
title: 'MuBlE/SHOP-VRB2: Integrated Robot Simulation'
url: https://www.emergentmind.com/topics/muble-shop-vrb2
type: topic
---

# MuBlE/SHOP-VRB2: Integrated Robot Simulation

MuBlE/SHOP-VRB2 encompasses an integrated simulation environment and benchmark designed to advance long-horizon robot manipulation research that requires combined visual, language, and physical reasoning. MuBlE is an open-source, modular platform built atop robosuite, utilizing the MuJoCo physics engine for physically accurate simulation and Blender as an off-line keyframe renderer for photorealistic, physically consistent image generation. This design targets closed-loop embodied reasoning agents that need to physically interact with the environment to acquire necessary information for complex tasks, such as sorting objects by latent attributes. The accompanying SHOP-VRB2 benchmark contains 12,000 procedurally generated tabletop scenes paired with ten classes of multi-step reasoning tasks, each demanding the agent to integrate perception, symbolic planning, and physical measurement [2503.02834].

## 1. Environment Design and Data Modalities

MuBlE integrates MuJoCo and Blender via a shared scene graph that synchronizes both visual (pose, geometry) and non-visual (weight, stiffness) object attributes. MuJoCo models rigid-body and contact dynamics while Blender, operating in an off-line rendering mode, generates high-resolution RGB images (configurable, e.g., 1024×768), depth maps, segmentation masks, and realistic photometric effects such as shadows and procedural materials. 

At each keyframe, a multimodal observation tuple is produced:
- Photorealistic RGB image and corresponding depth map;
- Per-object segmentation masks;
- Scene-graph state including pose, orientation, 3D bounding box, and current gripper contact flags for each object;
- Robot-centric proprioceptive signals (end-effector pose, joint angles, velocities, gripper state);
- Physical measurements accessible through primitives such as “weigh” (object mass), “squeeze” (stiffness), and elasticity.

## 2. Nested Interaction Loops

MuBlE provides two hierarchically nested interaction protocols:
- **Visual–Action Loop ("Action Loop")**: At this semantic level, an embodied reasoner observes rendered RGB images (optionally the scene graph and language instruction), outputs a symbolic primitive action (e.g., approach, close_gripper, weigh), and specifies target objects. The action planner computes a trajectory, and, upon completion, MuBlE renders the next keyframe.
- **Control–Physics Loop ("Physics Loop")**: Operating at a user-specified high frequency, this loop receives low-level end-effector motion commands—position Δx, orientation Δθ, and gripper command—and advances the MuJoCo physics simulation, integrating the dynamics:
  $$
  M(q)\ \dot{q} + C(q, \dot{q})\ \dot{q} + g(q) = \tau + J^T \lambda
  $$
  where $M$ is inertia, $C$ Coriolis/centrifugal, $g$ gravity, $\tau$ is the joint torque vector, $J$ Jacobian, and $\lambda$ contact impulses. Sensor readouts (joint torques, contact forces, and non-visual object attributes) are reported at each timestep.

## 3. Physics Modeling and Controller Architecture

MuJoCo implements smooth contact via nonlinear spring-damper models and friction:
- **Contact Normal Force**: $f_n = k_n d^n + c_n \dot{d}$
- **Tangential Friction**: $\|f_t\| \leq \mu f_n$; $f_t = -k_t \Delta x_t - c_t \dot{x}_t$
where $d$ is penetration depth, $\mu$ friction coefficient, $k_n$/$k_t$ stiffness, $c_n$/$c_t$ damping.

Operational-space control governs motion, with the default controller mapping task-space motion commands into joint torques:
$$
\tau = J^T F_{des} + (I - J^T (J J^T)^{-1} J) \tau_{null}
$$
where $F_{des}$ is a task-space PD-controlled wrench. This structure is extensible to custom controllers.

## 4. SHOP-VRB2 Benchmark: Task Suite and Dataset Organization

SHOP-VRB2 defines ten classes of multi-step reasoning tasks, each scene paired with one natural-language instruction and requiring both visual and physical measurements. Tasks encompass single/multi-object weight measurement, selecting or moving objects by weight or region, performing stacking operations (including by visual relation or weight), and long-horizon sorting (e.g., order all objects from heaviest to lightest). Each task mandates close integration of perception (visual, shape, material), manipulation, and latent attribute inference.

Scenes are generated procedurally with 4–5 objects sampled from ten everyday categories and randomized among plastic, metal, glass, rubber, and wood. Physical and visual diversity is ensured via collision-free mesh–mesh checks and controlled occlusion. For additional complexity, 30 YCB benchmark real-object scenes with nine YCB-Video models are included.

For each instruction–scene pair, a symbolic program in CLEVR-IEP format is generated via backward reasoning, with primitive-action sequence lengths ranging from 5 to 46.

## 5. Evaluation Protocol and Baselines

Evaluation is structured around the success rate:
$$
\text{SuccessRate} = \frac{1}{N} \sum_{i=1}^N S_i
$$
where $S_i \in \{0,1\}$ denotes success per test episode. Success is measured per-task-type and overall. Supplementary metrics include average trajectory length $\mathbb{E}[H]$ and cumulative reward $R_{cum} = \sum_{t=1}^H r_t$ for reinforcement learning settings.

The standard baseline is CLIER (Closed-Loop Interactive Embodied Reasoning), a transformer-based planner using scene graphs, remaining subgoals, ResNet-extracted visual features, and embedded instructions to predict the next primitive action and its targets. Ground-truth demonstrations supply expert paths with full observability (scene graph, segmentation, depth, symbolic program decomposition).

Performance outcomes are as follows:
- SHOP-VRB2 simulation overall: 43.9% success rate.
- YCB benchmark: 76.7% (simulated), 64.4% (real).
- High (>65%) success on single-object tasks, low (<35%) on multi-object and weight-sorting tasks.

Frequent failure modes include execution errors (14.4%), scene inconsistencies such as object ID swaps (12.6%), and action loops arising from small pose errors (10.8%).

## 6. Extensibility, API, and Practical Usage

MuBlE inherits the robosuite Python API. Primary usage involves:
```python
env = MuBlEEnv(config)
obs = env.reset(scene_spec, instruction)
for t in range(T):
    action = planner(obs.image, obs.scene_graph, subgoal)
    obs, reward, done, info = env.step(action)
```
Observations include images, depth, segmentation, physical attributes, and the scene graph. Adding new objects requires a MuJoCo XML model and corresponding Blender mesh/material; the procedural scene generator registers these for randomized trials. New tasks and instructions can be defined by extending instruction templates with decomposition rules, coupled with logic for backward validation. Sensors for new physical observables are constructed as robosuite extensions and mounted on robots or objects.

## 7. Research Scope and Significance

MuBlE establishes a physically realistic and photorealistic environment for long-horizon, multimodal task planning, addressing the gap in simulators that require integrated high-fidelity observations and closed-loop physical interaction. SHOP-VRB2 provides a challenging diagnostic testbed for embodied reasoning integrating vision, language, and manipulation. The modular and open-source design supports straightforward adaptation for sim-to-real transfer, new algorithmic baselines, and community-driven expansion of sensors and task classes [2503.02834].

Source: https://www.emergentmind.com/topics/muble-shop-vrb2