curobo.cuda_robot_model package

This module contains code for cuda accelerated kinematics.

Kinematics in CuRobo currently supports single axis actuated joints, where the joint can be actuated as prismatic or revolute joints. Continuous joints are approximated to revolute joints with limits at [-6, +6] radians. Mimic joints are not supported, so convert mimic joints to independent joints.

CuRobo loads a robot’s kinematic tree from types.KinematicsTensorConfig. This config is generated using cuda_robot_generator.CudaRobotGenerator. A parser base class kinematics_parser.KinematicsParer is provided to help with parsing kinematics from standard formats. Kinematics parsing from URDF is implemented in urdf_kinematics_parser.UrdfKinematicsParser. An experimental USD kinematics parser is provided in usd_kinematics_parser.UsdKinematicsParser, which is missing an additional transform between the joint origin and link origin, so this might not work for all robots.

In addition to parsing data from a kinematics file (urdf, usd), CuRobo also needs a sphere representation of the robot that approximates the volume of the robot’s links with spheres. Several other parameters are also needed to represent kinematics in CuRobo. A tutorial on setting up a robot is provided in Configuring a New Robot.

Once a robot configuration file is setup, you can pass this to cuda_robot_model.CudaRobotModelConfig to generate an instance of kinematics configuraiton. cuda_robot_model.CudaRobotModel takes this configuration and provides access to kinematics computations.

Note

cuda_robot_model.CudaRobotModel creates memory tensors that are used by CUDA kernels while cuda_robot_model.CudaRobotModelConfig contains only the robot kinematics configuration. To reduce memory overhead, you can pass one instance of cuda_robot_model.CudaRobotModelConfig to many instances of cuda_robot_model.CudaRobotModel.

Submodules