Repository navigation
This release expands Python support, improves simulation performance, and adds
new tools for recording episodes, authoring robot scenes, and processing CAD.
What's New
- Python 3.13 and 3.14 support. Native wheels now use the CPython stable ABI
and support standard CPython 3.12+. The nanobind port preserves the Python API
and enables parallel calls in free-threaded CPython source builds. - Experimental sleeping islands. Settled islands can skip simulation work
and wake when affected by scene changes. This is a work-in-progress. Enable
it throughexperimental::SleepParams. Off by default. - Experimental independent contact skins. Rods, shells, and soft bodies can
use contact meshes independently of their simulation and visual meshes. New
contact-skin queries expose deformed positions and normals. - More robust shells. A new membrane-collapse barrier guards against
instability under strong in-plane compression, eliminating solution explosions
in many scenarios. - More control over contact. Override contact parameters for specific actor
pairs in code or prefabs. Skinned articulations can also list links whose rigid
contact is replaced by skin contact through
ArticulatedSkinParams::nonCollidingLinks. - Actor preconditioner overrides. Select a supported preconditioner for each
actor withexperimental::SetActorPreconditionerType(Python:
experimental.set_actor_preconditioner_type) when using
PreconditionerType::PerActor. - Prefab pose snapshots. Save and restore soft deformation and articulated
joint poses withExportParams::exportCurrentPose(export_current_pose).
This is opt-in; velocities are not included. - Episode recording for source builds. The new
superdex.recorderAPI writes
transactional Rerun episodes with rigid and articulated state, robot
controllers, step durations, body parameters, and optional contact forces.
EpisodeReadersupports selective frame reads. Robot and keypoint shadows add
visualization without changing the simulation. - Skinned bots in Studio. Render and edit bot skins, attach skins to composed
bots, drag a skin through its nearest link, and export skinned GLB meshes and
simulation prefabs. A measurement tool measures vertices, triangles, and
facets, including while simulation is paused. - Studio automation. Run processing pipelines without a window using
--process, redirect exports with--out, and explicitly allow conflicting
exports with--override. Capture repeatable screenshots with--screenshot,
camera and framing controls, and a chosen output size. Screenshots require a
display or Xvfb. - Better CAD workflows. Control STEP mesh density by CAD face color and
preview models in their authored colors. Mesh exports have improved UV
packing. The CAD exporter has a DPI-aware UI, restored SolidWorks part export,
per-link meshing overrides, and an NX installer. - Filament rendering for SuperDex Lab. Lab now uses the Filament-based viewer
with automatic server launch, per-actor colors, ground planes, grids, and
working camera controls. Camera roll and background-color issues are fixed. - New robot assets. Added skinned Wuji hand variants, FR3/Wuji and FR3/DG5F
combinations, and DG5F/Seed mounting-adapter CAD. Wuji collisions and joints and
the Robotiq 2F-85 gripper have updated tuning. Left-hand Wuji kinematics,
visual meshes, and colliders have corrected mirroring. - Debugger profiling. A new profiler panel displays per-step timings
and statistics. If you don't see it docked at the bottom, then use the
"Reset Layout" option in the menu. - Debugger debug-draw. Enable various debug draw options to visualize
contacts, forces, bounds, and more. Controlled through the properties panel. - Native neural inference. Native MLPs now support SiLU activation.
Performance
- Various optimizations resulting in up to 2X overall performance improvement,
depending on the scene and settings. - Soft and shell actors use closed-form element mass and store fewer redundant
matrices and sparsity patterns, reducing assembly work, memory use, and scene
creation time. - Reduced contact work with sphere-tree culling, sort-and-sweep broadphase,
cached collider bounds, and specialized point-cloud and GridSDF queries. - Reworked skinned contact assembly around sparse bone maps, Jacobian-free
sums, and batched SIMD reductions. Articulated Hessians use compact link
Jacobians and symmetric assembly. - Reduced PCG and AMG synchronization, improved per-actor preconditioner
scheduling, and removed redundant solver setup, temporary storage, and copies. - Nonlinear solver skips redundant retries.
- Expanded opt-in AVX-512 support. AVX-512 remains disabled by default because it
requires a compatible CPU and it isn't always faster. This is expected to
improve in future versions. You're welcome to try it out now by building with
CMake flag-DMOCHI_USE_AVX512=ON. - Improved SIMD processing, small-matrix operations, eigensolvers, and FEM
assembly. - Reduced FEM and ECS memory overhead and eliminated unnecessary copies in NumPy
mesh conversion, and viewer frame reception. Shared-library calls also have less
dynamic-linking overhead. Renderer capture can reuse caller-owned frame buffers,
and rigid and articulated boundary-condition updates use fewer temporary
allocations.
Fixes
- Articulation pose and velocity resets now update link, soft-skin, and blended
state consistently. Rods now supportSetZeroDisplacementsAndVelocities. - Revolute joint velocities now report exact angle rates at large rotations per
step. Changing a body's center of mass preserves its root transform, and
inertia validation accepts valid rotated slender bodies. - Mass and density queries now work on static articulated links. Setting density
on shapeless links no longer produces NaN inertia. - Fixed missed contacts after point-cloud threshold changes, incorrect rod
contact bounds, and oversized sphere colliders on non-cubic meshes. SDF distance
queries report correct world positions for recentered soft actors. - Fixed slow drift of resting rigid actors far from the world origin,
incorrect forces and normals against rotated soft colliders, and contact
torques on reduced-order soft colliders. - Fixed crashes and incorrect force reporting for partitioned skinned contacts.
- Failed IK target replacement and solver creation preserve existing targets
and scenes. Pose-controller parameter updates are all-or-nothing. IK no longer
produces NaN actuator energy from an infinite time step or constraint damping. - Newton-Euler mass and Coriolis terms no longer include contact forces.
PsdProjectionMode::Neveris now honored on Newton retries. Non-finite
line-search values are checked consistently in optimized builds.- Corrected triangle quadrature weights and Smith neo-Hookean PSD projection
near rest states. - Partial-rotation boundary conditions return an error instead of triggering
an assertion in debug builds. - Python handles now work as dictionary keys and set members.
- Restoring state now refreshes debugger visual meshes. Static actors support
visual-node queries, and the debugger handles playback-time resets safely. - Prefab reload preserves in-memory nested prefabs. Studio refreshes stale
models, handles inaccessible paths without crashing, and avoids invalid link
selections. - Source and wheel builds respect compiler selection. CMake builds handle
jemalloc compatibility correctly, and Android builds without FP16 arithmetic
use a supported fallback. CUDA sparse solver builds support cuDSS 0.8.
API Changes
- Legacy viewer dependency: Polyscope is now optional. Install
polyscope>=2.5.0,<2.6separately if you use the legacy viewer. This range
has no Python 3.14 wheels. - Equality comparisons: constraint and prefab comparisons now include
derived fields such as actor names and translations. Compare selected
fields explicitly if your code relied on the previous partial comparison.
Defaulted C++ prefab equality operators require C++20. - Prefab export: replace
prefab::ExportSceneExcludingwithExportScene
andExportParams::excludeActors. In Python, useexport_scenewith
ExportParams(exclude_actors=...). Existing exports without options still work. - Newton fallback: removed
gradientDescentFallback(Python:
gradient_descent_fallback) from the solver configuration. Default behavior is
unchanged. - Computed inertia: rigid bodies and articulated links using
P1Q1boundary
elements now get exact mesh-derived inertia. - Python precision names: use
fp32andfp64in configuration and precision
comparisons.PRECISION_NAMEnow returns those names. Existingdouble
environment aliases and thedoublesource-build extra remain accepted. - Rod contact: replace
useVisualMeshContactwithuseContactSkinand
visualMeshContactElementTypewithcontactSkinElementType. In Python, use
use_contact_skinandcontact_skin_element_type. Move contact geometry and
its skinning data intoModelData::contactSkinMesh(contact_skin_mesh). - Contact-skin access: surface-mesh getters no longer return deformable
contact skins. UseGetShapeContactSkinMeshorActor::GetContactSkinMesh.
RegisterContactSkinNodePositionsandContactSkinNodeNormalsfor deformed
data, then read the corresponding contact-skin position and normal getters. - Lab environments: import
superdex.lab.gymand construct registered
environments withgymnasium.make, for example
gymnasium.make("superdex_gym/CartPole-v0", cfg={}). Update discovery-based
environment names in scripts, training recipes, and checkpoint configuration
to the registeredsuperdex_gym/<Name>-v0IDs. - Lab rendering: remove
renderer_backend,render_coordinate_system, and
the sample runner's--rendereroption. Configuremochi_renderer_cfginstead.
Public builds do not include the new interactiverender_mode="human"viewer.
Userender_mode="rgb_array"orNone. Passup_direxplicitly to camera-view
calls if your observations depend on the previous orientation. - Shell material defaults:
membraneCollapseBarrierScalenow defaults to
1e-3. Set it to0to retain the previous plain StVK membrane response. - Mesh authoring: remove nodes that no element references before creating
soft or shell actors, articulated skins, or blended skins. Contact-skin models
also require skinning data at shape creation. Blended vertices must have
matching rest coordinates and skinning transforms in the articulated and
nested-soft meshes. Previously accepted invalid assets can now return errors.
Runtime SDF collider creation also rejects empty meshes, oversized grids,
and unusable cell spacing. Check mesh padding and grid resolution when
actor creation returns an SDF error. - Solver limits: iterative solvers reject
maxIter = 0. Use the automatic
limit or a positive value. The default maximum is now 500 rather than 1000.
SetLinearSolverParams::maxIterexplicitly if you need the previous limit. - Native linking: shared Physics libraries no longer export
mochi_core
implementation symbols. Linkmochi_coredirectly if your application uses
those symbols. ReplaceMOCHI_PMR_USES_JEMALLOCwith
MOCHI_PMR_ENABLE_JEMALLOC_COMPATIBILITYin custom build configuration. - Experimental scene recording: HDF5 scene recording has moved to the
experimental API. It will probably be removed in the future. All new recording
efforts are directed toward SuperDex Recorder (superdex.recorder), described
above.