This repository holds code and resources for the Autonomous Systems course that takes place at Instituto Superior Tecnico, Lisboa.
For this course you will need to have a machine running Ubuntu, ROS and some other things, please follow the instructions bellow before the laboratory classes begin.
The supported distribution is ROS Kinetic on Ubuntu 16.04, although both ROS Melodic and ROS Noetic on Ubuntu 18.04 and 20.04 should also work. It is preferable to use ROS Kinetic, but if for some reason you already have one of the other Ubuntus you can try that distribution, at your own risk. If there is a problem of incompatibility, you might have to change to ROS Kinetic.
For the first classes you may use a virtual machine, but it is advisable, at some point, to use a native instalation of Ubuntu 16.04 64-bit in order to prevent unwanted issues that may arise from the use of a virtual machine.
Install git on your system:
sudo apt-get install git
It is advisable to go for the Desktop-Full Instalation of ROS, please go through the instructions in the following link: https://wiki.ros.org/kinetic/Installation/Ubuntu
Navigate to your home folder:
cd $HOME
Clone the repository:
git clone https://github.com/socrob/autonomous_systems.git
Whenever the repo is updated you can get the latest updates with:
cd $HOME/autonomous_systems
git pull origin master
(Optional) Terminator is a usefull tool when you want to have several terminals open. If you want to install it just run:
sudo apt-get install terminator
A partial documentation of this can be found here and here
-
Create a folder for your ros workspace in your system:
mkdir -p ~/catkin_ws/src
-
Install python catkin tools (to be able to compile with the new catkin build system, instead of catkin_make which is the old one)
sudo apt-get install python-catkin-tools
-
Source (enable) ROS on your system (only one time, this line should not be there on your .bashrc as it will be bashed by the scripts structure)
source /opt/ros/kinetic/setup.bash
-
Compile your workspace:
cd ~/catkin_ws && catkin build
-
Add lines of code to your .bashrc to source the scripts configuration files
echo "# personal config starts here" >> ~/.bashrc && echo "source ~/scripts/permanent.sh" >> ~/.bashrc
-
Copy scripts folder to your home directory:
cp -r ~/autonomous_systems/resources/scripts $HOME
-
Source your new scripts structure:
source ~/.bashrc
Lab1 will give you some concepts on ROS, and how to use it. Please open lab1 folder to access the lab slides.
Lab2 has 2 components, a simulation focused part and the real robot part. Please open lab2-simulation or lab2-real-robot folders to access the content and follow the instructions for the practical exercise. There is README.md file inside. You should follow the instructions in the Before the Lab section so you can perform the tasks during the lab. This lab will be more hands on than the previous, and you are expected to experiment ROS yourself. If you can, perform all the tasks in lab2-simulation by yourself so in the classroom you can present your doubts and have time to try the real robot instructions.
Please post your questions under:
https://github.com/socrob/autonomous_systems/issues
By creating an issue, so that we can all benefit from the answers.
Thanks!
Learn how to program in python, google developers nice online course
ROS python example on how to publish / subcribe from code
Nice ROS online course from ETH Zurich see their youtube lectures here
ROS tf tranformations library package
ROS AMCL package Adaptive Monte Carlo localization
ROS gmapping : SLAM algorithm (simultaneous localization and mapping)