Skip to content

Simulation assets ​

The main HiveBoard repository includes articulated digital assets for the physical mechanisms. Use these files when integrating HiveBoard into an existing simulator or robotics stack.

Browse the Simulation/ directory.

Available mechanism groups ​

FolderMechanisms
Button/Button
Circuit Breaker/Circuit breaker
Drawer/Drawer
Honeycomb/Honeycomb base
Key/Lock and key
Lamp/Light bulb
Peg Insertion/Peg insertion
Shock Absorber/Shock absorber
Threads/Thread (M8), Thread (M30)
Valves/Ball valve, Gate valve (small), Gate valve (large)

Folder names are retained for compatibility. The terminology reference maps older names to the task names used in the paper.

Model contents ​

Depending on the mechanism, the simulation package provides:

  • visual meshes
  • collision meshes
  • revolute, continuous, and prismatic joints
  • joint ranges and limits
  • nominal mass and inertia
  • URDF or USD exports.

Threaded motion is represented by coupled rotational and translational joints where a native helical joint is unavailable. This reproduces the advance of a threaded component while keeping the asset portable across simulators.

URDF and USD assets ​

GoalStarting point
Load or visualize a mechanism in an existing stackURDF or USD assets in the main repository
Inspect kinematics or create a custom environmentArticulated asset plus your simulator's loader
Run HiveBoard tasks with Isaac Lab and NewtonIsaac Lab installation and task reference
Edit commands, record episodes, or find learning workflowsSimulation workflows
Compare simulation with the printed boardRecord model commit and locally identified physical parameters

The Isaac Lab implementation uses generated Newton USD files. Follow the asset-generation steps after cloning the simulation repository. Its generated files are separate from the portable URDF/USD assets in the main HiveBoard repository.

Align the physical and simulated board ​

Use the optional ArUco cell as a visual reference for board pose. The guide covers marker detection, camera calibration, and the marker-to-board transform. ID 0 and ID 1 assembly meshes are provided as OBJ/MTL under CAD/ArUco Cell/, with ID 1 in the ID1/ subdirectory. For a metre-based simulator, multiply OBJ coordinates by 0.01 and verify the 0.0881 m overall width. ID 1 also has a USDZ export with declared millimetre units. Respect that metadata when importing it. Associate each detected ID with its own marker-to-board transform.

Place the mesh relative to the board using the measured transform. Check alignment at known board points before comparing physical and simulated trajectories.

Optional 360° valve model ​

The 360° ball-valve variant is provided as OBJ/MTL and USDZ under CAD/Valves/Lever Valve/Ball Valve 360/. Its USDZ contains geometry and materials, with no physics joints or rigid-body configuration. Integrating it requires defining and validating joint motion, collision geometry, mass, and friction. The existing articulated valve assets and Isaac Lab environments remain separate from this export.

Physical parameters ​

The provided masses, inertias, friction values, and contact properties are nominal. They are not system-identified values for every printed instance.

Printer calibration, filament, layer orientation, surface wear, sanding, and mechanism assembly can all change physical behavior. If close sim-to-real correspondence is required:

  1. print and assemble the target mechanism
  2. measure its range and actuation resistance
  3. identify the relevant simulation parameters
  4. store the overrides separately from the original asset
  5. report both the asset commit and the identified values.

Validation before use ​

Before training or evaluation, check that:

  • every referenced mesh resolves
  • the rest configuration has no unintended self-intersection
  • joint axes and ranges match the physical mechanism
  • collision geometry is sufficiently accurate for the task
  • units and scale are correct
  • a full actuation cycle completes without instability.

A simulation experiment must define observations, actions, reset states, success checks, termination conditions, and evaluation seeds.

HiveBoard documentation