a2s-institute / foundations_course

Materials for the preparatory course for new students of the Master of Autonomous Systems program

Foundations Course

Tentative Schedule

FC Schedule

Requirements

In case you need any help installing any of this, please ask your study buddy or come to one of the b-it-bots labs (C025 and C069).

Software

• Ubuntu 20.04

• ROS Noetic. Installation instructions can be found here

• LaTeX

  sudo apt install texlive-full
  
  

• texMaker

• TeXstudio

  sudo add-apt-repository ppa:sunderme/texstudio
  sudo apt update
  sudo apt install texstudio
  

• python 3.5+ (3.8 already installed with Ubuntu 20.04)

• Jupyter notebooks

  sudo pip install jupyter
  

• Visual Studio Code

• PyCharm EDU

• git

  sudo apt install git-all
  

• Java 8

  Please visit the Oracle wesbite and download the latest stable Java JDK version available.

  1. Download Java SE Development Kit 8 The following link leads you to the download website for the Java SE Development Kit 8. Make sure you download one of the two versions:

     • 32-bit: jdk-8u161-linux-i586.tar.gz
     • 64-bit: jdk-8u161-linux-x64.tar.gz

  2. Move the extracted JDK files to /opt/Oracle_Java/

     • Extract the JDK files from the downloaded tar.gz.
     • Create the folder Oracle_Java in the directory /opt/:

     sudo mkdir /opt/Oracle_Java
     

     • Move the folder jdk1.8.0_161 to /opt/Oracle_Java/:

     sudo mv ~/Downloads/jdk1.8.0_161/ /opt/Oracle_Java/
     

  3. Set up and configure the evironment variables Set up the environment variables by executing the following commands one by one:

     sudo update-alternatives --install "/usr/bin/java" "java" "/opt/Oracle_Java/jdk1.8.0_161/bin/java" 1
     
     sudo update-alternatives --install "/usr/bin/javac" "javac" "/opt/Oracle_Java/jdk1.8.0_161/bin/javac" 1
     
     sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/opt/Oracle_Java/jdk1.8.0_161/bin/javaws" 1
     
     sudo update-alternatives --install "/usr/bin/jar" "jar" "/opt/Oracle_Java/jdk1.8.0_161/bin/jar" 1
     

     Configure the environment variables by executing the following commands one by one:

     sudo update-alternatives --set "java" "/opt/Oracle_Java/jdk1.8.0_161/bin/java"
     
     sudo update-alternatives --set "javac" "/opt/Oracle_Java/jdk1.8.0_161/bin/javac"
     
     sudo update-alternatives --set "javaws" "/opt/Oracle_Java/jdk1.8.0_161/bin/javaws"
     
     sudo update-alternatives --set "jar" "/opt/Oracle_Java/jdk1.8.0_161/bin/jar"
     

  After finishing the aforementioned steps the Java JDK installation is complete and the development with Java can begin.

• Eclipse

  Eclipse is an Integrated Development Environment (IDE) that is well suited for Java development. The following steps describe how to set it up.

  1. Download the latest Eclipse version

     • Visit https://www.eclipse.org/ and download Eclipse OXYGEN

  2. Set up Eclipse

     • Extract the content of the tar.gz folder and rund eclipse-inst.
     • Choose Eclipse IDE for Java Developers and foolow the instructions.

  3. Lock Eclipse to your launcher (Optional)

     • Go to the folder in which you have installed Eclipse.
     • Run Eclipse and right click its icon in the launcher. Then choose the option Lock to Launcher.

References

The sources of the files used in this repository can be found here

foundations_course's Issues

add documentation for ROS installation process

Few of the points that I think ought to be documented in the ROS installation README.md or in the installation script:

• Why is the bugfix necessary for stage, and what's changed compared to the original. Are these changes needed in future stage versions?
• Why is desktop-full needed for installation. I don't think students need the full version even for AMR right?

At least these are not obvious to me. If somebody explains I can also make a pull request.

Adding sources to the wiki

I've set up a wiki page to cite the sources of any materials we have used.
@kiranvasudev can you help us out by adding any sources you may have for the materials you've provided? We can do a reverse search for the rest or substitute them for new ones.

Changing git exercises

Hi @kiranvasudev, I’ve taken a look at the current exercises in the gut folder. Are this the ones planned for this semester?
If so, could you add the LaTeX file?

I would like to propose some changes to make it clearer to students what’s the function of git.

Adding course contents

Hi @kiranvasudev, can you help us out with the topics that will be covered for the lessons that we planned?
It doesn't have to be the course contents as such, just a markdown file per class, the name of the person giving it and topics covered. Optionally, adding links to resources.

Since some of this is up to the person giving that session, feel free to open issues for those helping out and letting them do pull requests for their files.