Repository navigation
Summary
libuipc v0.0.29 fixes corrupted Python stitch indices and external-force activation, adds native tetrahedralization, and expands the independently packaged Blender integration with coupled baking, robot controls and compact affine playback.
Fixes
- Python vertex stitching (#498): both
SoftVertexStitch.create_geometryoverloads retain integer conversion buffers throughout the call. This fixes garbage topology and spurious out-of-range errors.int32,int64, sliced, reversed, transposed, Fortran-order and read-only arrays are supported. - External forces (#499): explicitly applied FEM vertex and ABD body forces are enabled by default and use their own activation mask, independently of soft position/transform constraints. Disabling all ABD forces now clears the active buffers instead of retaining stale forces.
- CUDA torque conversion (#497): materialize the affine inverse before transposing it, avoiding the problematic Eigen inverse-transpose expression.
Geometry and Blender
- Add native C++ tetrahedralization with C++/Python APIs, strict preservation of input surface connectivity, an optional boundary-refinement mode, input validation and mesh-quality reports. No external mesher dependency is required.
- Expand the separately installed Blender extension to coupled cloth, affine rigid bodies, volumetric FEM, rods and fixed colliders, with contact materials, physical presets and solver diagnostics.
- Add URDF joint/pose/keyframe controls, trajectory inspection, resumable multi-camera rendering from baked scenes, and bake-quality reports.
- Give cloth stretch, shear and bending independent material controls. Strengthen cache identity, validation and attachment rollback.
- Add compact fixed-body caches and full-affine ABD playback that preserves shear and scale through Blender's native playback. Reuse preview geometry and GPU batches to reduce host-side work.
The Blender extension is packaged separately from the Python wheels. See the Blender installation guide and extension source.
Build, Tooling and Documentation
- Declare Python binding/stub-generation build requirements explicitly and share stub generation between CMake and XMake packaging. Preserve direct-CMake automatic dependency setup and the established development install workflow.
- Add isolated samples-worktree selection and before/after hashes of benchmark runtime binaries, Python sources and declared inputs.
- Update API specifications, simulation/build guides and repository development instructions.
Upgrade Notes
External-force apply_to now defaults to enable=True in Python (true in C++). The supplied force starts contributing in subsequent simulation steps:
external_force.apply_to(mesh, force) # enabled
external_force.apply_to(mesh, force, enable=False) # stored, initially disabledTo toggle newly created forces in animation code, use external_force/is_constrained on FEM vertices or ABD instances. The shared is_constrained attribute continues to control soft constraints. Reapplying an external force resets its values and activation mask on all current entries. Serialized geometries without the new attribute retain the legacy shared-mask behavior.
The exported C++ external-force apply_to signatures gain a defaulted boolean parameter. Rebuild C++ consumers against the updated libraries.
Compatibility and Validation
- Python wheels target CPython 3.10–3.14 on 64-bit Windows and manylinux. They use CUDA 12.8 without requiring a system CUDA Toolkit; a compatible NVIDIA driver is required.
- Native GPU images cover compute capabilities 7.5, 8.0, 8.6, 8.9 and 12.0, with compute-8.9 PTX for forward JIT. Driver requirements remain unchanged from v0.0.28.
- The source merged through #500 passed Windows/Linux CMake and XMake CI and all ten Python wheel build/test variants.
- Local validation includes 166 portable Python tests (including 80 new stitch regressions), 36 focused external-force cases on RTX 4090, and 36 native core cases / 1040 assertions. One optional Warp test was skipped because Warp was not installed.
- The release workflow rebuilds versioned wheels, validates the complete TestPyPI matrix and smoke-tests installation before publishing to PyPI.
Full changelog: v0.0.28...v0.0.29