V-Rep ROS Bridge is a plugin for V-Rep developed by the Inria Lagadic team located at Inria Rennes.

The main application of the plugin is to provide a communication interface between V-Rep and (ROS). The aim is to control the V-Rep simulation externally using ROS messages and ROS services.

V-Rep is a General purpose 3D robot simulator with integrated development environment developed by Coppelia Robotics. Sensors, mechanisms, robots and whole systems can be modelled and simulated in various ways.

You will find the documentation here.

##Installation

Note: The Ubuntu version used is 13.04. It is tested also with 12.04 and 14.04 (with ROS Indigo).

• Install ROS
• Install V-Rep
• Install Plugin

###ROS

####Installation ROS Hydro

Follow instructions you find in this page.

• Point 1.2 : choose instructions for your version of Ubuntu.

• Point 1.4 : Desktop-Full Install: (Recommended).

• When you configure the ROS Environment, choose catkin.

• Complete the tutorial page. It is mandatory to follow the tutorial number 1 "Installing and Configuring Your ROS Environment".

Now we have installed ROS and we have created our workspace.

####Installation ROS Indigo

As for Hydro, follow the instructions in this page.

###Installation V-Rep

• Go in http://www.coppeliarobotics.com/ .
• Check the licensing page and download the suitable V-REP version for you.
• To run it go to the folder of V-rep via terminal and type ./vrep.sh
• Follow this tutorial (Optional).

###Installation Plugin

• Go in the src folder of your catkin workspace in catkin_ws/src via terminal

• Download the plugin from GIT typing:

  git clone https://github.com/lagadic/vrep_ros_bridge.git

• Checkout the right branch depening on your ROS version (Hydro or Indigo)

  git checkout hydro-devel or

  git checkout indigo-devel

• It is possible that you will not need all the sub-plugins provided by the vrep_ros_bridge. A common case is the one in which you do not need to use the TeleKyb framework (if you do not know what TeleKyb is, it is likely that you will not need it). To ignore this sub-plugin you need to add the file CATKIN_IGNORE in the sub-plugin folder that you do not need (as it is done in quadrotor_tk_handler). To do it go via terminal in the sub-plugin folder and execute:

  touch CATKIN_IGNORE

• Open the file bashrc: gedit ~/.bashrc in the end of the file add:

  export VREP_ROOT_DIR=/ChangeWithyourPathToVrep/

and, if you want to avoid to type the following command every time:

`export ROS_PACKAGE_PATH=${ROS_PACKAGE_PATH}:/path_to_catkin_ws/catkin_ws/src`
`source /opt/ros/indigo/setup.bash`
`source /path_to_catkin_ws/catkin_ws/devel/setup.bash`

• Go in your catkin_workspace and run:

  catkin_make

• Now build again the pkg using the next instruction:

  catkin_make --pkg vrep_ros_bridge --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo

• In the folder catkin_ws/devel/lib/ you will find the main library (libv_repExtRosBridge.so) and the others libraries (libcamera_handler.so, libmanipulator_handler.so, libquadrotor_handler.so, librigid_body_handler.so ).

• The file libv_repExtRosBridge.so has to be in the V-Rep installation folder in order to be loaded. What we will do is to create a symbolic link to it. Go via terminal to the installation folder of V-Rep and type:

  ln -s /YOUR_CATKIN_WS_PATH/devel/lib/libv_repExtRosBridge.so

where /YOUR_CATKIN_WS_PATH is your actual path to reach your workspace.

• In order to test if the installation was succesfull go here

####Update the vrep_ros_bridge according to a new V-REP release

V-REP is a software undergoing through rapid development and there can be different releases in a short period of time.
If the user wants to use the vrep_ros_bridge always with the latest version of V-REP he/she has just to follow the following steps:

• Download the last version of V-REP here .

Note:

• The vrep_ros_bridge was tested up to the version 3.2.1 of V-REP released the May 4th 2015.
• If you encounter some problems of speed in the your simulations of V-REP (e.g. jumps in the frames) you could try to change the following parameter. In V-REP version 3.2.1 there is a feature that was mistakenly disabled, which will actually accelerate visualization of your scene. If you go in Tools-> User settings, under Adjust OpenGl settings, under VBO operation, make sure that default (recommended) is selected.

You will find a guide to use the plugin here .