ROS from the Ground Up Tutorials

Welcome to my repository of ROS (ROS1) and ROS2 tutorials, ROS from the Ground Up.

This repository contains several different branches, each containing tutorials and code specific to a single ROS or ROS2 distribution.

If you are seeing this README file, please switch your active Git branch, selecting a specific ROS distribution.

How to switch branches?

GitHub (Browser)

1. Click on the button that says start just above this section.
2. In the drop-down list that appeared, click on the branch you'd like to switch to.

For more guidance, see: https://www.howtogeek.com/789268/how-to-switch-branches-in-github/

Git (Terminal)

1. Get list of all branches.

git branch -r

2. Pick a branch, say origin/noetic. To switch to this branch, type the following command (excluding the origin/ prefix like shown):

git checkout noetic

These tutorials were developed in conjunction with my YouTube series, ROS from the Ground Up. All ROS from the Ground Up videos will be posted to my channel, Retro Engineer.

All tutorials will be based in ROS Python (i.e. rospy) unless otherwise specified.

Licensing and Citing My Work

These tutorials are provided free and as-is, as per the attached ROS From the Ground Up Multi-license.

A multi-license allows you, the licensee, to choose a license out of a list of choices to use based on the terms you agree to. This allows you to use and access my work for free, but if you want to use my work commercially, you will need to choose the commercial license option or otherwise break the terms of the other licenses.

If you use my work in research, please cite this repository using the built-in citation tool (more info here).

Each GitHub release will additionally include a DOI for easier references in research publications.

Acknowledgement

ROS from the Ground Up is greatly influenced by my previous tutorials published as the ROS (C++) With Git From The Ground Up Tutorial Series, created in partnership with Sun Devil Robotics Club. The original written tutorials can be found in the SDRC urc-code repository's wiki page, here.

An additional thank you to the following organizations for providing me years of education, support, excitement, opportunities, and fun: Clemson University, Arizona State University, Rossum Rumblers Robotics Club, PYRO Robotics, Sun Devil Robotics Club, Plasma Robotics, FIRST Robotics, VEX Robotics, and The Mars Society.