dvrk_env icon indicating copy to clipboard operation
dvrk_env copied to clipboard

Accurate URDF and SDF models of Intuitive Surgical's daVinici Research Kit (dVRK)

Notification

All the models have been designed at WPI from scratch.

Description

This repository contains RViz and Gazebo simulations of the da Vinci Surgical System controlled using ROS.

Authors

Ankur Agrawal:[email protected] Radian Azhar Gondokaryono:[email protected]

Maintainer

Adnan Munawar: [email protected]

Install

  • download & compile dvrk_env

# cd to catkin ws src dir
cd /PATH/TO/CATKIN_WS/src

# clone repo
git clone https://github.com/WPI-AIM/dvrk_env.git

# copy models to .gazebo/models
cd dvrk_env/dvrk_description
./install.sh 

# build
cd /PATH/TO/CATKIN_WS
catkin_make

Packages

This is a short description of the packages in this repository. The detailed explanations and instructions are available in the packages itself.

dvrk_gazebo: Launch files to launch PSM, MTM, ECM, SUJ Cart and the full dvrk models in gazebo. Src includes model plugin which provides interface between the dvrk Gazebo simulation and ROS.

dvrk_gazebo_control: Example codes to control the gazebo simulation.

dvrk_description: CAD models, URDFs, SDFs of PSM, ECM, MTM, SUJ, and dVRk. Additionally it has launch files for all of the models in RViz.

Launching

# Run the Surgical System simulation
roslaunch dvrk_gazebo dvrk_gazebo.launch

Dependencies

Gazebo 7, ROS kinetic or ROS indigo, gazebo_ros_pkgs. If ROS-indigo is to be used with Gazebo 7, keep gazebo_ros_pkgs (https://github.com/ros-simulation/gazebo_ros_pkgs/tree/indigo-devel) in your src folder.

Citation

If you find this work useful and use it in your research. Please use the following citation

Gondokaryono RA, Agrawal A, Munawar A, Nycz CJ, Fischer GS, An Approach to Modeling Closed-Loop Kinematic Chain Mechanisms, applied to Simulations of the da Vinci Surgical System, Special Issue on Platforms for Robotics Research - Acta Polytechnica Hungarica, Vol 16, No 8, pp 29-48, Nov 2019