DiSECt is a simulator for the cutting of deformable materials. It uses the Finite Element Method (FEM) to simulate the deformation of the material, and leverages a virtual node algorithm to introduce springs between the two halves of the mesh being cut. These cutting springs are weakened in proportion to the knife forces acting on the material, yielding a continuous model of deformation and crack propagation. By leveraging source code transformation, the back-end of DiSECt automatically generates CUDA-accelerated kernels for the forward simulation and the gradients of the simulation inputs. Such gradient information can be used to optimize the simulation parameters to achieve accurate knife force predictions, optimize cutting actions, and more.
- Python 3.6 or higher
- PyTorch 1.4.0 or higher
- Pixar USD lib (optional, for advanced visualization)
Pre-built USD Python libraries can be downloaded from https://developer.nvidia.com/usd, once they are downloaded you should follow the corresponding instructions to add them to your PYTHONPATH environment variable. Besides using the provided basic visualizer implemented using pyvista, DiSECt can generate USD files for rendering, e.g., in NVIDIA Omniverse™ or usdview.
By default, the simulation back-end uses the built-in PyTorch cpp-extensions mechanism to compile auto-generated simulation kernels.
- Windows users should ensure they have Visual Studio 2019 installed
To set up our dataset of meshes, simulated knife forces and nodal motion fields we recorded in the ANSYS LS-DYNA simulator, download this zip file (96 MB) and extract it in the project folder, such that the folder dataset is at the top level.
We provide a README.md file with more details on the contents of this dataset in the dataset folder. The dataset is released under the Creative Commons Attribution-NonCommercial 4.0 International License.
Next, set up the Python dependencies listed in requirements.txt via
pip install -r requirements.txtSee meshing/README.md for instructions on how to install the recommended C++-based mesh cutting library that DiSECt relies on to process meshes.
For the mesh discretization we provide an example script in cutting/tetrahedralization.py based on the Wildmeshing Python API that can be used to generate a tetrahedral mesh from a triangle surface mesh, which allows it to be used in the FEM simulator.
The following demos are provided and can be executed via python examples/<example_name>.py.
| Example | Description |
|---|---|
basic_cutting |
Cutting a prism shape with a knife following a slicing motion, running in the interactive pyvista 3D visualizer |
render_usd |
Demonstrates how to generate a USD file from the simulation |
optimize_slicing |
Constrained optimization via MDMM to find a slicing motion of the knife that minimizes force while adhering to blade length and knife height constraints |
parameter_inference |
Optimizes simulation parameters to match a knife force profile from one of the measurements in our dataset |
@INPROCEEDINGS{heiden2021disect,
AUTHOR = {Eric Heiden AND Miles Macklin AND Yashraj S Narang AND Dieter Fox AND Animesh Garg AND Fabio Ramos},
TITLE = {{DiSECt: A Differentiable Simulation Engine for Autonomous Robotic Cutting}},
BOOKTITLE = {Proceedings of Robotics: Science and Systems},
YEAR = {2021},
ADDRESS = {Virtual},
MONTH = {July},
DOI = {10.15607/RSS.2021.XVII.067}
}
We do not accept outside code contributions in the form of pull requests, but you are welcome to open issues which we may address in future updates to this work.
Copyright © 2021, NVIDIA Corporation. All rights reserved.
This work is made available under the NVIDIA Source Code License.
