Melodic_Tutorial using ROS for ver.3

Tutorial for ver.3

Melodic Edition Backup

Virtual robots can be controlled by using SIGVerse and ROS (Robot Operating System).

This section describes examples using ROS. For the examples which do not requires ROS, please see here.

System Requirements †

If you want to use ROS, prepare an Ubuntu environment and install ROS there.
ROS communicates with Unity on Windows.

The requirements for Windows can be found at here.

The ROS requirement is that the OS is Ubuntu 18.04 and ROS Distribution is Melodic Morenia.

#ref(): File not found: "RobotOperationUsingROS.png" at page "Melodic_Tutorial using ROS for ver.3"

Environment Setup †

Build Windows Environment †

Please refer to here to build the Windows environment.
After that, please build the following environment.

Build Ubuntu Environment †

Build Ubuntu environment as follows.

Using VMware †

Instead of preparing an Ubuntu PC, you can use an Ubuntu virtual machine on Windows.
However, in this case, it will be difficult to run tutorials using the GPU.
Also note that using VMware requires a lot of computational resources.

The procedure for building an Ubuntu environment using VMware is as follows.

1. Download VMware Workstation Player.
   https://my.vmware.com/web/vmware/downloads/info/slug/desktop_end_user_computing/vmware_workstation_player/16_0
2. Download Iso file of Ubuntu 18.04.5 LTS.
   http://releases.ubuntu.com/bionic/
3. Launch VMware Workstation Player.
4. Click [Create a New Virtual Machine].
5. Use [Installer disc image file(iso):] and select ubuntu-18.04.5-desktop-amd64.iso.
6. Recommend to check "Store virtual disk as a single file" on Specify Disk Capacity window.
7. After you have finished creating the VM, adjust the memory and processors in the Virtual Machine Settings of VMware Workstation Player.
   And also set the settings to use the Enhanced keyboard.

Install ROS Melodic †

Run this page up to section 1.6 to install ROS.
Then follow chapter 3 of the ROS tutorial to create a ROS workspace.

And add "~/catkin_ws/devel/setup.bash" to .bashrc to simplify subsequent commands. Be careful if you manage multiple ROS workspaces.

$ echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
$ source ~/.bashrc

Install ROSBridge_suite †

Start the terminal and execute the following command.

$ sudo apt-get install ros-melodic-rosbridge-server

Install Mongo C driver †

In the terminal, execute the following command:

$ cd ~/Downloads
$ wget https://github.com/mongodb/mongo-c-driver/releases/download/1.4.2/mongo-c-driver-1.4.2.tar.gz
$ tar zxvf mongo-c-driver-1.4.2.tar.gz
$ cd mongo-c-driver-1.4.2
$ ./configure
$ make
$ sudo make install

Install Mongo C++ driver †

In the terminal, execute the following command:

$ cd ~/Downloads 
$ wget https://github.com/mongodb/mongo-cxx-driver/archive/r3.0.3.tar.gz
$ tar zxvf r3.0.3.tar.gz
$ cd mongo-cxx-driver-r3.0.3/build
$ cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local -DLIBMONGOC_DIR=/usr/local -DLIBBSON_DIR=/usr/local ..
$ sudo make EP_mnmlstc_core
$ make
$ sudo make install

sigverse_ros_bridge settings †

In the terminal, execute the following command:

$ cd ~/catkin_ws/src
$ git clone https://github.com/SIGVerse/sigverse_ros_package.git
$ cd ..
$ catkin_make

Install TurtleBot Packages †

Install ROS packages to use Turtlebot.

$ sudo apt install ros-melodic-rgbd-launch
$ sudo apt install ros-melodic-gmapping
$ sudo apt install ros-melodic-turtlebot*

$ cd ~/catkin_ws/
$ curl -sLf https://raw.githubusercontent.com/gaunthan/Turtlebot2-On-Melodic/master/install_basic.sh | bash
$ cp src/sigverse_ros_package/examples/turtlebot2/resources/asus_xtion_pro_sigverse.launch.xml src/turtlebot/turtlebot_bringup/launch/includes/3dsensor
$ catkin_make

$ cd ~/catkin_ws/src
$ git clone https://github.com/ros-drivers/openni2_camera.git
$ git clone -b legacy https://github.com/IntelRealSense/librealsense.git
$ git clone -b indigo-devel https://github.com/IntelRealSense/realsense-ros.git
$ cd ~/catkin_ws
$ catkin_make --pkg librealsense
$ catkin_make

$ source ~/.bashrc

* Regarding this matter, Mr. Isao Hara from the National Institute of Advanced Industrial Science and Technology provided files and advices. Thank you.

Install PR2 Package †

Install the PR2 packages with the following command to use the PR2.

$ sudo apt-get install ros-melodic-pr2*

Execute Example Scenes with ROS †

Unity Scene Execution †

Before running the Unity example scene, you need to set the IP address for ROS on Unity.

1. Check the IP address of the Ubuntu side.
   Execute the following command in Ubuntu side to check the IP address.

    $ hostname -I

2. Open the SIGVerse project in Unity.
3. Click [SIGVerse]-[SIGVerse Settings] in the Unity menu to open the SIGVerse settings window.
4. Enter the IP address of Ubuntu side in [Config file Settings]-[Rosbridge IP].
   (You can also change [Rosbridge Port] and [SIGVerse Bridge Port] in the same way.)

#ref(): File not found: "SIGVerseSettings.png" at page "Melodic_Tutorial using ROS for ver.3"

The Unity scene is executed as follows:

1. Double-click [Assets/SIGVerse/ExampleScenes/xxxxx/yyyyy(.unity)] on the [Project] tab to open the target scene.
2. Click the play button at the top center of the Unity to play the scene.

Example Scenes †

• (TurtleBot3)Grasp by Keyboard Operation
• (TurtleBot3)Grasp Automatically #darknet_ros(YOLO)
• (TurtleBot3)SLAM
• (TurtleBot3)Recognize Human Pointing
• (PR2)Operate with Keyboard
• (HSR)Operate with Keyboard
• (HSR)Cleanup Task
• (HSR)Cleanup Task using Cloud and VR #Cloud, VR
• (HSR)Cleanup Task using Cloud and VR with Playback function #Cloud, VR
• (TIAGo)Operate with Keyboard
• (TIAGo)Cleanup Task