URDF Import: Turtlebot#

NVIDIA Isaac Sim has several tools to facilitate integration with ROS systems. We have both ROS and ROS2 bridges, a method to import URDF, and much more. This tutorial series gives examples of how to use these tools.

Learning Objectives#

In this example, we will setup up a Turtlebot3 in Isaac Sim and enable it to drive around.

If you already have a robot with rigged joints and properties in USD format, and you wish to jump straight into using our ROS bridges, go to the next tutorial in the series Driving TurtleBot via ROS2 messages.

Getting Started#

Important

Ensure to source your ROS 2 installation from the terminal before running Isaac Sim. If sourcing ROS 2 is a part of your bashrc then Isaac Sim can be run directly.

Prerequisite

  • Completed ROS and ROS 2 Installation so that ROS2 is available, ROS2 extension is enabled, and necessary environment variables are set.

  • Basic understanding of ROS workspaces.

Importing TurtleBot URDF#

  • Clone the Turtlebot3’s description package if you haven’t done so already.

    git clone -b <distro>-devel https://github.com/ROBOTIS-GIT/turtlebot3.git turtlebot3

  • Locate the URDF file for Turtlebot3 Burger in turtlebot3/turtlebot3_description/urdf/turtlebot3_burger.urdf.

  1. For the purpose of this tutorial series, we will use an Isaac environment for this tutorial, but you can import the robot into any environment of your choosing. Open the environment by going to the Isaac Sim Assets tab below the viewport, and find Environments/Simple_Room/simple_room. If you do not want to use the provided environment, just make sure there is a GroundPlane and a PhysicsScene to your environment. Both can be found in Create > Physics. You may also need some lighting, play with the various types of lighting in Create > Light to get the desired effect.

  2. On a new stage, drag the simple_room.usd onto the stage, and place it at the origin by zero out all the Translate components in the Transform Property. You many need to zoom in a bit to see the table inside the room.

  3. Click File > Import, then locate the URDF file and select it.

  4. In the prompt window, select Referenced Model. Inside the Links section, set to Moveable Base. Since this is a mobile robot, change targets of wheel_left_joint and wheel_right_joint to Velocity under the Joints & Drives section so that wheels can be properly driven later.

  5. The configuration of the robot should match the following:

  6. Click Import.

  7. Once the asset is imported into Omniverse Kit, a copy of the .usd version of the asset will be automatically saved. You can specify the folder you wish to save the asset in USD Output if it’s different than the folder that the .urdf file is located in. A folder name matching the .urdf file will be created in the specified directory, and the .usd file will be inside the newly created folder.

  8. When the Turtlebot is first imported, it will be on the table. Place it just above the floor of the room using the gizmo.

  9. Press Play and you should see the Turtlebot fall onto the floor.

Tune the Robot#

Importing the URDF automatically imports material, physical, and joint properties whenever it is available and have matching categories in NVIDIA Isaac Sim. However, in cases there are no available or matching categories, or if the units are different between the two systems, what gets automatically filled in may not be accurate and changes the robot’s behavior. Here are some properties that can be tuned to correct the robot’s behavior.

Frictional Properties

If your robot’s wheels are slipping, try changing the friction coefficients of the wheels and potentially the ground as well following steps 3.4.2 in Add Simple Objects.

Physical Properties

If no explicit mass or inertial properties are given, the physics engine will estimate them from the geometry mesh. To update the mass and inertial properties, find the prim that contains the rigid body for the given link (You can verify this by finding Physics > Rigid Body under its property tab). If it already has a “Mass” category under its Physics property tab, modify them accordingly. If there isn’t already a “Mass” category, you can add it by clicking on the +Add button on top of the Property tab, and select Physics > Mass.

Joint Properties

If your robot is oscillating at the joint or moving too slow, take a look at the stiffness and damping parameters for the joints. High stiffness makes the joints snap faster and harder to the desire target, and higher damping smoothes but also slows down the joint’s movement to target. For pure position drives, set relatively high stiffness and low damping. For velocity drives, stiffness must be set to zero with a non-zero damping.

  1. For this Turtlebot robot, try setting the Damping to a value of 10000000.0 and Stiffness to a value of 0.0.

Note

When URDF importing finishes, the robot that appears on stage is usually loaded as a reference. This can be confirmed by an orange or blue arrow on the robot prim on the stage tree eyecon. If you have problem changing the parameters and saving them, you may need to edit the original USD file that the reference is pointing to instead. To find the file path to the original USD file navigate to the property tab and go to References > Asset Path.

Summary#

This tutorial covered the following topics:

  1. URDF import

  2. Tuning the robot parameters

Next Steps#

Continue on to the next tutorial in our ROS Tutorials series, Driving TurtleBot via ROS2 messages, to learn how to add OmniGraph nodes to move the robot, and ROS2 bridge nodes to connect to the ROS network.

Further Learning#

On this page