Skip to content

[Newton] Expose runtime MPM resolution controls - #8829

Draft
maxkra15 wants to merge 11 commits into
isaac-sim:mainfrom
maxkra15:maxkra15/mpm-runtime-controls
Draft

maxkra15 wants to merge 11 commits into
isaac-sim:mainfrom
maxkra15:maxkra15/mpm-runtime-controls

Conversation

@maxkra15

@maxkra15 maxkra15 commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Description

Expose Newton's runtime MPM grid/support controls through env.sim.backend_manager, allowing coarse-to-fine schedules without recreating the environment or changing observation/action layouts.

manager = env.sim.backend_manager
manager.set_voxel_size(0.020, entry_name="media")
manager.set_particle_radius(0.003, entry_name="media")

Call between physics steps. The manager uses the current coupled entry state, propagates radius changes to particle proxy views, and schedules CUDA graph recapture. Radius updates require ownership of all parent particles. Positions, velocities, material history, count and mass are preserved; changing radius changes reference density and does not resample particles.

Franka Pour gains an optional completed-success curriculum, disabled by default. A qualifying episode cohort advances one configured resolution stage at a reset boundary, globally for that rank, including active episodes. Documentation explains contact-capacity and material implications. Preserve physical kinematic-body mass/inertia for MuJoCo while letting MPM use its native effective-mass handling.

Dependency: Newton #4933, pinned to its fork revision; MuJoCo and mujoco-warp are aligned at 3.16.0.

Type of change

  • New feature
  • Bug fix
  • Documentation update

Validation

Merged main 210ee799; all CI checks pass at 74feed989, including multi-GPU unit tests and Kit/kitless training smokes. Eleven focused CPU runtime, ownership, proxy and curriculum cases pass, along with full formatting/changelog checks. Removing radius propagation makes the retained outgoing-proxy test fail. Native CUDA validation exercised direct and coupled runtime changes with graph recapture and no extra physics steps.

No throughput, policy-success or containment guarantee is implied by exposing the controls. A picN contact basis and sparse-grid storage must have adequate capacity for every planned stage.

Checklist

  • I have read and understood the contribution guidelines
  • I have run uv run isaaclab --format
  • I have made corresponding documentation changes
  • My changes generate no new warnings
  • I have validated changed behavior and applied the test-audit criteria
  • I have added changelog fragments for touched packages
  • My name already exists in CONTRIBUTORS.md

Add instance-owned voxel-size and uniform particle-radius updates for
standalone and coupled MPM. Preserve live material state and invalidate
physics graphs at resolution transitions.

Provide an optional terminal-success curriculum for Franka Pour with
explicit fixed-mass density semantics. Pin the supporting Newton API
while its upstream pull request is under review.
@github-actions github-actions Bot added documentation Improvements or additions to documentation isaac-lab Related to Isaac Lab team infrastructure labels Oct 26, 2026
Incorporate upstream Isaac Lab changes, including trusted native
actuator checkpoint import. Retain the exact feature dependency pin.
Keep physical mass and inertia intact for MuJoCo while native MPM
uses zero effective mass for kinematic colliders. Remove the obsolete
shared-builder override and cover the native compile boundary.

Merge compatibility also aligns MuJoCo dependencies with Newton 3.16,
updates backend solver access, and pins the reviewed runtime API.
Use ownership resolved during coupled solver construction rather than
view sizes, which include foreign proxies. Reject partial ownership
before mutation and refresh outgoing proxy radii for valid updates.

Exercise both proxy directions through the native coupled build path.
Document point-contact capacity requirements when coarsening grids.
Integrate upstream main at ce2900d to keep
the branch current with shared API and dependency changes.

Validate the merged revision with focused checks and full formatting
and lint hooks before committing. Remote CI remains separate.
Select the runtime-controls feature with current Newton main merged.
Keep the dependency and lockfile revisions identical for integration
validation against the redesigned Isaac Lab solver interface.
Merge outgoing particle-proxy checks into the existing coupled runtime
fixture and reuse returned curriculum metrics. Keep ownership, live-state,
material-history, and graph-invalidation coverage while removing repeated
setup and shortening the runtime-controls guide.

Pin Newton to the matching lean runtime-controls revision. Retain all
other dependency versions and lock metadata.
Track the runtime-controls revision that restores the final test hook
required by the Newton example runner. Keep all other dependency versions
and lock metadata unchanged.
Incorporate the upstream PhysX self-only clone fix while preserving\nthe focused MPM runtime adapters and current Newton feature pin.
Integrate upstream main at 6d37745 to keep
the branch current with shared API and dependency changes.

Validate the merged revision with focused checks and all repository
formatting and lint hooks. Remote CI remains separate.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation infrastructure isaac-lab Related to Isaac Lab team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant