diff --git a/docs/source/how-to/simulation_performance.rst b/docs/source/how-to/simulation_performance.rst index ec575685b00..77c260a1d10 100644 --- a/docs/source/how-to/simulation_performance.rst +++ b/docs/source/how-to/simulation_performance.rst @@ -1,5 +1,5 @@ -Simulation Performance -======================= +Simulation Performance and Tuning +==================================== The performance of the simulation can be affected by various factors, including the number of objects in the scene, the complexity of the physics simulation, and the hardware being used. Here are some tips to improve performance: @@ -46,5 +46,12 @@ if the geometry is not part of a dynamic rigid body. Additional Performance Guides ----------------------------- +There are many ways to "tune" the performance of the simulation, but the way you choose largely depends on what you are trying to simulate. In general, the first place +you will want to look for performance gains is with the `physics engine `_. Next to rendering +and running deep learning models, the physics engine is the most computationally costly. Tuning the physics sim to limit the scope to only the task of interest is a great place to +start hunting for performance gains. + +We have recently released a new `gripper tuning guide `_ , specific to contact and grasp tuning. Please check it first if you intend to use robot grippers. For additional details, you should also checkout these guides! + * `Isaac Sim Performance Optimization Handbook `_ * `Omni Physics Simulation Performance Guide `_ diff --git a/docs/source/setup/installation/include/src_python_virtual_env.rst b/docs/source/setup/installation/include/src_python_virtual_env.rst index 7757e40ca31..d94d908d831 100644 --- a/docs/source/setup/installation/include/src_python_virtual_env.rst +++ b/docs/source/setup/installation/include/src_python_virtual_env.rst @@ -67,7 +67,7 @@ instead of *./isaaclab.sh -p* or *isaaclab.bat -p*. .. tab-item:: Conda Environment - To install conda, please follow the instructions `here __`. + To install conda, please follow the instructions `here `__. You can create the Isaac Lab environment using the following commands. We recommend using `Miniconda `_, diff --git a/docs/source/setup/installation/index.rst b/docs/source/setup/installation/index.rst index cca8e5ca2a7..27acbbcf8ff 100644 --- a/docs/source/setup/installation/index.rst +++ b/docs/source/setup/installation/index.rst @@ -68,6 +68,25 @@ may work but have not been validated against all Omniverse tests. driver from the `Unix Driver Archive `_ using the ``.run`` installer. +DGX Spark: details and limitations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The DGX spark is a standalone machine learning device with aarch64 architecture. As a consequence, some +features of Isaac Lab are not currently supported on the DGX spark. The most noteworthy is that the architecture *requires* CUDA ≥ 13, and thus the cu13 build of PyTorch or newer. +Other notable limitations with respect to Isaac Lab include... + +#. `SkillGen `_ is not explicitly supported out of the box. This + is because cuRobo builds native CUDA/C++ extensions that requires specific tooling and library versions which may not have been explicitly documented + and validated for use with DGX spark. Use at your own risk! + +#. Extended reality teleoperation tools such as `OpenXR `_ is not supported. This is due + to encoding performance limitations that have not yet been fully investigated. + +#. SKRL training with `JAX `_ has not been explicitly validated or tested in Isaac Lab on the DGX spark, and so this functionality may be limited or + different than expected out of the box. + +#. Livestream and Hub Workstation Cache are not supported on the DGX spark. + Troubleshooting ~~~~~~~~~~~~~~~