Skip to content

User's Guide

Jump to bottom
Yavuz Uslubas edited this page Sep 22, 2017 · 25 revisions

Getting Started with WilsonROS

Installing ROS kinetic

ROS kinetic can be installed as described here.

A VM with an ubuntu with pre-installed ROS can be found here: PC-Setup ROS-Kinetic

Requirements for WilsonROS

WilsonROS requires some packages which can be installed e.g. on ubuntu using this command:

sudo apt-get -y install ros-kinetic-openslam-gmapping ros-kinetic-smach-viewer

Initialization and compiling WilsonROS

Create a directory and initialize a workspace for WilsonROS

mkdir -p wilsonros/src
cd wilsonros/src
catkin_init_workspace

Clone the repository into the src folder

git clone https://github.com/WilsonROS/wilson_ros

Go to the wilsonros folder and compile the project.

cd ..
catkin_make

It may appear that catkin_make fails at first, repeating this command can solve the issue.

Preparing the environment

The environment variables for WilsonROS can be set persistently using this commands, assuming that the workspace folder was created in the home directory:

cat - >> ~/.bashrc <<EOF
export ROS_MASTER_URI=http://10.42.0.1:11311/
cd ~/wilsonros/
source ./devel/setup.bash
EOF

source ~/.bashrc

Starting Nodes

TODO

Simulator

TODO

Turtlebot 2

TODO

Start Each Node Separately

TODO

Shutdown the Robot Gracefully

TODO

Moving the Robot

TODO

Using rviz

TODO

Starting rviz

TODO

Mapping Visualization

Mapping Visualization

Coverage Visualization

Coverage Visualization

Navigation Visualization

Navigation Visualization

Floor Mapping

TODO

Floor Navigation

TODO

Fixing the initial position of the robot

The initial position is used and published by AMCL. It can be configured by editing the launch/amcl.launch file. But first one needs to know the new position. This can be achieved as follows

  1. Booting up the robot (as explained above) ![commandline](User's-Guide/rviz_from commandline.png)
  2. Starting RViz from the command line with rviz (with a configured command line, as explained above) Adding topics
  3. Adding relevant topics to the visualization: /map, /amcl_pose Select pose
  4. Selecting "2D pose estimate" ant place it at the new position approximately. The AMCL position should move to the point previously selected Pose on command line
  5. The command line shows the newly selected pose Update launch file
  6. The launch file needs to be edited to match the position from the command line

Clone this wiki locally