Skip to content

Restore V2 base motor collision clearance - #140

Merged
kou merged 1 commit into
enactic:mainfrom
stevenaya:fix/v2-base-motor-clearance
Nov 18, 2026
Merged

kou merged 1 commit into
enactic:mainfrom
stevenaya:fix/v2-base-motor-clearance

Conversation

@stevenaya

@stevenaya stevenaya commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Restore the historical Y = -61.5 mm cutoff on the V2 base motor collision piece. Rebuilding the two-piece representation from CAD had restored the nose to -62.5 mm, creating an overlap with link1 that locks joint1 in fixed-base MuJoCo models.

Changes

  • Remove the restored 1 mm nose section and close the cut face.
  • Retain the rest of the motor shape and the 316-triangle count.

Mesh comparison

Matched views of the actual STL geometry. Red and green highlight the old and new end faces. The end face moves inward by 1 mm; its area increases because the cut intersects the tapered nose. Both versions contain 316 triangles.

Before: Y = −62.5 mm After: Y = −61.5 mm
Before: original motor end face After: restored clearance

The section through X = 0 shows the removed 1 mm region. The zoomed axes use different scales for clarity.

End-face section and 1 mm cut

Validation

  • The STL remains closed, consistently wound and convex; the uncut source vertices are preserved.
  • Existing description tests: 35 passed.
  • Across 101 joint1 positions per side, the restored mesh has no base/link1 contact and at least 0.926 mm axial clearance. Joint1 motion is restored in native MuJoCo 3.8.1 and Web 4.0.1 without collision exclusions.

The corresponding MuJoCo mesh and left-side mirror are updated in openarm_mujoco #106.

Copilot AI balanced review requested due to automatic review settings November 17, 2026 08:53

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request. Check if the Files changed in this pull request are included in default exclusions.

kou pushed a commit to enactic/openarm_mujoco that referenced this pull request Nov 18, 2026
Replaces #103; submitted from `stevenaya/openarm_mujoco`.

Replace the coarse V2 collision meshes with the split assets from
[openarm_description](https://github.com/enactic/openarm_description/tree/38c64af1dd6f3bc246883754875cbb4259dce0fc/assets).
Built on #105, which is now merged into `master`.

## Changes

| Component | Collision pieces |
| --- | ---: |
| Shoulder base | 2 |
| link2 / link3 | 3 each |
| link4, including cable covers | 4 |
| link5 | 9 |
| link6 | 6 |
| Each finger | 5 |
| Pedestal | 6 |
| ZED mount | 2 |

- Refresh link1 and retain the current single-piece gripper base. Add
the ZED body's collision using its existing official mesh and pose.
- Store assets under `collision/arm`, `gripper`, `body`, and
`zed_mount`; update references and the existing left-mesh mirroring
script.
- Retain the Cell's rotated shoulder-base installation. Cell frame and
lifter collisions are unchanged.
- Collision STL storage decreases from 2.04 MiB to 1.08 MiB; input
triangles decrease from 42,806 to 22,516, including mirrored copies.

The finger assets are five closed mesh pieces; [MuJoCo evaluates each
piece's convex
hull](https://mujoco.readthedocs.io/en/stable/XMLreference.html#asset-mesh)
separately.

## Base motor clearance

Restore the historical `Y = -61.5 mm` cutoff on the motor collision
piece. The CAD-derived split had reinstated the removed 1 mm nose,
causing a base/link1 overlap that blocked joint1 in fixed-base models.
Both right and mirrored-left meshes retain 316 triangles. The matching
source correction is [openarm_description
#140](enactic/openarm_description#140).

With collision filtering unchanged, both joint1s move to ±0.5 rad in
native MuJoCo 3.8.1 and Web 4.0.1. A 101-position sweep per side finds
no motor/link1 contact and at least 0.926 mm axial clearance.

## Visual comparison

Before: #105 (`3b90f8d`). After: `cabf000`. Matching camera and joint
poses; collision hulls are shown opaque. Colors distinguish finger
pieces.

| View | Before | After |
| --- | --- | --- |
| Complete pedestal robot | ![Robot collisions
before](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/robot_before.png)
| ![Robot collisions
after](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/robot_after.png)
|
| Pedestal and head camera | ![Pedestal collisions
before](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/body_before.png)
| ![Pedestal collisions
after](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/body_after.png)
|
| Gripper and fingers | ![Gripper collisions
before](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/gripper_before.png)
| ![Gripper collisions
after](https://raw.githubusercontent.com/stevenaya/openarm_mujoco/c00d999d5fd9bc2babeb1fbaf46ab475a091de46/v2-collision/gripper_after.png)
|

## Validation

- All 79 collision STLs are closed, consistently wound, and free of
degenerate faces; 32 mirrored assets regenerate byte-for-byte.
- Existing V2 model/scene entries and the Cell-specific bimanual entry
load. Robot, pedestal and Cell run 1,000 steps without warnings.
- A 17-pose comparison preserves visual and camera transforms, body mass
properties, mass matrices, bias forces and control parameters.
- Existing Python tests (3), Web Node test files (4), and Ruff checks
pass.
@kou
kou merged commit f6aa3bb into enactic:main Nov 18, 2026
10 checks passed

This branch was successfully deployed

1 active deployment
release — c31adb86 Deployed Nov 17, 2026 by stevenaya via Publish #518
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants