Isaac Lab Documentation

repository·release/3.0.0-beta2·Indexed 27 days ago

https://github.com/isaac-sim/isaaclab

A GPU-accelerated, open-source framework built on NVIDIA Isaac Sim for unifying robotics research workflows, including reinforcement learning, imitation learning, and motion planning. It provides high-fidelity physics and sensor simulation for sim-to-real transfer and supports large-scale deployments across cloud distributions. The framework includes integrations for VLA fine-tuning via RLinf and supports various Isaac Sim version compatibilities.

Tokens
234.3K
Snippets
399
Records
1.1K
Agent score
90%

What's inside Isaac Lab

  1. Overview of Isaac Lab

    release/3.0.0-beta2
    Isaac Lab is a GPU-accelerated, open-source framework built on NVIDIA Isaac Sim. It is designed to unify and simplify robotics research workflows, including reinforcement learning, imitation learning, and motion planning. It provides high-fidelity physics and sensor simulation (RTX-based cameras, LIDAR, contact sensors) suitable for sim-to-real transfer. The framework supports running simulations locally or across cloud distributions for large-scale deployments.
  2. Overview of Isaac Lab Mimic for Synthetic Data Generation

    release/3.0.0-beta2

    Isaac Lab Mimic (Mimic) is a trajectory data generation tool designed to augment human demonstrations by generating synthetic data. It automatically creates new demonstrations of the same task but with different spatial configurations.

    How it works:

    • Splits human demonstrations into subtasks based on reference objects.
    • Applies rigid body transformations to the robot's actions.
    • Evaluates new demonstrations for success and adds them to the dataset.

    Requirements:

    • OS: Supported on Linux only.
    • Action Space: The embodiment's action space must be defined in task space. If using joint space, actions must be converted to task space using forward kinematics.
    • Compatibility: Supports single-eef (manipulators) and multi-eef (humanoids) embodiments.
  3. Overview of Isaac Teleop

    release/3.0.0-beta2

    Isaac Teleop is a unified framework for high-fidelity egocentric and robot data collection. It provides a standardized device interface and a flexible graph-based retargeting pipeline that works across simulated and real-world robots. It replaces the previous native XR teleop stack (isaaclab.devices.openxr) in Isaac Lab.

    Quick Start: For installation and first-run steps, refer to the cloudxr-teleoperation how-to guide.

  4. Overview of Isaac Lab Visualizer Backends

    release/3.0.0-beta2

    Isaac Lab provides four lightweight visualizer backends for real-time simulation inspection and debugging. These are intended for fast, interactive feedback rather than high-fidelity sensor data rendering.

    VisualizerBest ForKey Features
    OmniverseHigh-fidelity, Isaac Sim integrationUSD, visualization markers, live plots, tiled camera panel
    NewtonFast iterationLow overhead, visualization markers, tiled camera panel
    RerunRemote viewing, replayWebviewer, time scrubbing, recording export, visualization markers
    ViserWeb-based remote visualization, sharing, recordingWarp-based rendering, browser-based, share URL, visualization markers

    Important Compatibility Note: The Kit visualizer (--visualizer kit) cannot be used with presets=ovphysx or ovrtx_renderer in the same process. For those backends, use newton, rerun, viser, or omit the visualizer for headless execution.

  5. Overview of PhysX Backend Capabilities

    release/3.0.0-beta2

    PhysX is the primary and most broadly supported backend in Isaac Lab. It serves as the reference for behavior parity and supports all public assets, sensors, and renderer surfaces. Most existing isaaclab_tasks default to the PhysX preset.

    Core Simulation Support:

    • Articulation API: Supports multi-link, fixed-base, floating-base, and single-body articulations (modeled as rigid bodies).
    • Rigid Objects: Supports Rigid Object and Rigid Object Collection APIs.
    • Pipelines: Supports both CPU and GPU pipelines. The GPU pipeline is the default for vectorized Reinforcement Learning (RL) workloads.
    • Soft-body/Particles: Available via PhysX schemas, though not directly exposed through the standard Isaac Lab asset surface.
  6. Overview of the Isaac Lab Reference Architecture

    release/3.0.0-beta2

    The Isaac Lab reference architecture provides an end-to-end workflow for robot learning, covering the entire process from initial asset input to model deployment. It is designed for robotics developers and researchers to build foundational environments, design tasks, and train/test policies using Isaac Sim and Isaac Lab.

    The workflow consists of six major components:

    1. Asset Input: Providing the raw assets.
    2. Configuration: Defining assets and the scene.
    3. Robot Learning Task Design: Designing the learning task.
    4. Register with Gymnasium: Making the environment compatible with the Gymnasium API.
    5. Environment Wrapping: Wrapping environments for specific training needs.
    6. Run Training/Testing: Executing the training and evaluation loops.
  7. Overview of Isaac Lab extensions and modules

    release/3.0.0-beta2

    Isaac Lab is organized into several specialized extensions. Use the following mapping to locate specific functionality:

    Core Isaac Lab (isaaclab)

    Provides fundamental simulation and environment components including:

    • app, actuators, assets, cloner, controllers, devices, envs, managers, markers, physics, renderers, scene, scene_data, sensors, sim, terrains, utils, visualizers.
    • Simulation utilities: isaaclab.sim.converters, isaaclab.sim.schemas, isaaclab.sim.spawners, isaaclab.sim.views, isaaclab.sim.utils.
    • Environment MDP and UI: isaaclab.envs.mdp, isaaclab.envs.ui.
    • Sensor patterns: isaaclab.sensors.patterns.

    Reinforcement Learning (isaaclab_rl)

    • Provides wrappers for RL integration.

    Mimicry and Data Generation (isaaclab_mimic)

    • Modules: datagen, envs.

    Contributed Modules (isaaclab_contrib)

    • Modules: actuators, assets, controllers, deformable, mdp, rl, sensors.

    Tasks (isaaclab_tasks & isaaclab_tasks_experimental)

    • isaaclab_tasks: Contains stable task implementations.
    • isaaclab_tasks_experimental: Contains experimental task implementations under active development.

    Teleoperation (isaaclab_teleop)

    • Provides modules for teleoperating robots.

    Physics Engines (isaaclab_physx, isaaclab_newton, isaaclab_ovphysx)

    • PhysX: assets, cloner, physics, renderers, sensors, sim.schemas, sim.spawners.
    • Newton: assets, cloner, physics, renderers, sensors, sim.schemas, sim.spawners.
    • OVPhysX: assets, cloner, physics.

    Assets and Visualization

    • Assets (isaaclab_assets): robots, sensors.
    • Visualizers (isaaclab_visualizers): kit, newton, rerun, viser.
    • Omniverse (isaaclab_ov): renderers.

    Experimental Core (isaaclab_experimental)

    • Modules: envs, managers, utils.
  8. Overview of Isaac Lab

    release/3.0.0-beta2

    Isaac Lab is a modular framework for robot learning, designed to simplify workflows like reinforcement learning, learning from demonstrations, and motion planning.

    Key Capabilities:

    • Simulation Backends: Supports NVIDIA Isaac Sim for photo-realistic RTX rendering, and can run standalone using the Newton physics backend for high-efficiency simulation without a full Isaac Sim installation.
    • Physics Engines: Powered by both PhysX and Newton.
    • Rendering: Tiled rendering APIs for vectorized rendering with support for RTX and Newton camera sensors.
    • Features: Includes domain randomization and support for cloud execution.

    Batteries-included Robot Assets:

    • Classic: Cartpole, Humanoid, Ant
    • Fixed-Arm and Hands: UR10, Franka, Allegro, Shadow Hand
    • Quadrupeds: Anybotics Anymal-B/C/D, Unitree A1, Unitree Go1, Unitree Go2, Boston Dynamics Spot
    • Humanoids: Unitree H1, Unitree G1
    • Quadcopter: Crazyflie
  9. Overview of the Newton Physics Backend

    release/3.0.0-beta2

    Newton is a GPU-accelerated, extensible, and differentiable physics simulation engine integrated into Isaac Lab. It is built on top of NVIDIA Warp and integrates MuJoCo Warp. In Isaac Lab, Newton support is currently in beta and is focused on a validated set of classic Reinforcement Learning (RL) and flat-terrain locomotion environments.

    Key characteristics:

    • High Performance: GPU-accelerated simulation.
    • Differentiable: Designed for research and advanced simulation workflows.
    • Validated: Newton simulation has been validated against PhysX via policy transfer.
    • Extensible: Supports multiple solvers through the NewtonManager abstraction.
  10. Overview of the Isaac Lab Framework

    release/3.0.0-beta2

    Isaac Lab provides a specialized set of interfaces and wrappers around Isaac Sim classes, specifically optimized for reinforcement learning (RL) requirements. While Isaac Sim is a general-purpose simulator, Isaac Lab specializes in:

    • Augmenting simulators with non-ideal actuator models.
    • Managing observation and reward settings for learning tasks.
    • Integrating various sensors into the simulation loop.
    • Providing interfaces to physics features not natively available in Isaac Sim (e.g., deformable bodies).

    This specialization aims to provide a unified description for different simulation systems tailored for learning workflows.

  11. Overview of Ray Job Dispatch and Tuning in Isaac Lab

    release/3.0.0-beta2

    Isaac Lab provides integration with Ray to streamline the dispatching of multiple training jobs (in parallel or in series) and to perform hyperparameter tuning on both local and remote clusters.

    Key capabilities include:

    • Parallel/Sequential Job Dispatching: Run multiple training jobs with minimal interaction.
    • Hyperparameter Tuning: Support for multiple GPUs and/or multiple GPU nodes.
    • Resource Isolation: Use resource-wrapped jobs to define specific requirements for each sub-job.
    • Consistency: Use the same training setup across local and cloud environments.

    Note: This functionality is experimental and has only been tested on Linux. Due to security risks, Ray clusters should only be deployed in trusted, isolated networks.