# autonomous_systems

**Repository Path**: chendda/autonomous_systems

## Basic Information

- **Project Name**: autonomous_systems
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-11-05
- **Last Updated**: 2021-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Autonomous Systems
===

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.

Ubuntu instalation
===
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](https://www.ubuntu.com/download/alternative-downloads) in order to prevent unwanted issues that may arise from the use of a virtual machine.

ROS Kinetic installation
===

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:
http://wiki.ros.org/kinetic/Installation/Ubuntu

Git and Repository setup
===

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

Setup catkin workspace and scripts structure (one time only)
===

A partial documentation of this can be found [here](http://wiki.ros.org/catkin/Tutorials/create_a_workspace) and [here](http://catkin-tools.readthedocs.io/en/latest/index.html)

1. Create a folder for your ros workspace in your system:

        mkdir -p ~/catkin_ws/src

2. 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

3. 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

4. Compile your workspace:

        cd ~/catkin_ws && catkin build

5. 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

6. Copy scripts folder to your home directory:

        cp -r ~/autonomous_systems/resources/scripts $HOME

7. Source your new scripts structure:

        source ~/.bashrc

Lab1
===
Lab1 will give you some concepts on ROS, and how to use it. Please open lab1 folder to access the lab slides.

Lab2
===
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.


Questions
===

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!

Extra Resources
===

[Wiki with summarized information about system setup, git useful commands and information about the robots](https://github.com/socrob/autonomous_systems/wiki)

[Learn how to program in python, google developers nice online course](https://www.youtube.com/watch?v=tKTZoB2Vjuk&list=PL123FD827C7984559)

[ROS python example on how to publish / subcribe from code](http://wiki.ros.org/ROS/Tutorials/WritingPublisherSubscriber%28python%29)

[ROS beginner tutorials](http://wiki.ros.org/ROS/Tutorials)

[Nice ROS online course from ETH Zurich](http://www.rsl.ethz.ch/education-students/lectures/ros.html) see their youtube lectures [here](https://www.youtube.com/watch?list=PLE-BQwvVGf8HOvwXPgtDfWoxd4Cc6ghiP&v=0BxVPCInS3M)

[ROS tf tranformations library package](http://wiki.ros.org/tf)

[ROS tf tutorials](http://wiki.ros.org/tf/Tutorials)

[ROS AMCL package Adaptive Monte Carlo localization](http://wiki.ros.org/amcl)

[ROS gmapping : SLAM algorithm (simultaneous localization and mapping)](http://wiki.ros.org/gmapping)