README.md

SINGABOAT-VRX | Virtual RobotX (VRX) Competition

COMPETITION: Virtual RobotX (VRX) Competition 2022

TEAM NAME: SINGABOAT-VRX

INSTITUTE: Nanyang Technological University, Singapore

MEMBERS: Tanmay Vilas Samak, Chinmay Vilas Samak and Chern Peng Lee

ADVISOR: Dr. Ming Xie

DEPENDENCIES

1. Robot Operating System (ROS) - Tested with ROS Noetic Ninjemys on Ubuntu 20.04.4 LTS (Focal Fossa).
2. Virtual RobotX (VRX) Simulation Environment - Included as vrx directory with this SINGABOAT-VRX repository.
3. Python3 Dependencies - Listed in requirements.txt file of singaboat_vrx ROS package. These can be simply installed using the following command:

   $ pip3 install -r requirements.txt

SETUP

1. Clone this SINGABOAT-VRX repository:

   $ git clone https://github.com/Tinker-Twins/SINGABOAT-VRX.git

2. Make a directory VRX_Workspace to act as your catkin workspace for VRX Competition.

   $ mkdir -p VRX_Workspace/src/

3. Move the SINGABOAT-VRX repository to the source space (src) of your VRX_Workspace.

   $ mv ~/SINGABOAT-VRX ~/VRX_Workspace/src/

4. Build the packages within your VRX_Workspace.

   $ cd ~/VRX_Workspace
   $ catkin_make

5. Source the setup.bash file of your VRX_Workspace.

   $ echo "source /home/$USER/VRX_Workspace/devel/setup.bash" >> ~/.bashrc
   $ source ~/.bashrc

USAGE

1. Launch any VRX task simulation instance.

$ roslaunch vrx_gazebo <TASK_NAME>.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf

$ roslaunch vrx_gazebo station_keeping.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf
$ roslaunch vrx_gazebo wayfinding.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf
$ roslaunch vrx_gazebo perception_task.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf
$ roslaunch vrx_gazebo wildlife.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf
$ roslaunch vrx_gazebo gymkhana.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf
$ roslaunch vrx_gazebo scan_dock_deliver.launch urdf:=$(rospack find singaboat_vrx)/urdf/singaboat.urdf

2. Launch singaboat_task_manager to automatically identify the VRX task and execute the corresponding SINGABOAT-VRX solution algorithm.

$ roslaunch singaboat_vrx singaboat_vrx.launch

DOCKER

The docker container image(s) containing all the source code as well as dependencies is available on Docker Hub.

VIDEOS

Demonstration videos are available on YouTube.

Task Descriptions	Task Solutions

VRX COMPETITION 2022

Our team worked meticulously to complete all the 6 tasks of VRX Competition 2022 and ultimately emerged as one of the winners of the challange, while also bagging several other special awards.

Station-Keeping Task	Wayfinding Task	Scene Perception Task
Semantic Navigation Task	Gymkhana Challenge Task	Scan-Dock-Deliver Task

The detailed scores and ranks of all the teams that qualified for finals of VRX Competition 2022 are available on VRX GitHub Wiki, and a summary of results and awards declared during the VRX 2022 Award Ceremony are available on VRX Website.