Skip to content

Overview

Starter Project Scene

Welcome to the autonomy starter project tutorial! In this tutorial, you will write code for all three subsystems encompassed by autonomy: perception, navigation, and localization. You will then put them all together in order to complete a task with a simulated rover. The goal is to familiarize yourself with what type of problems we tackle and how to do that with our codebase.

When you complete the project you will have a rover that uses its localization system to navigate to a set waypoint and then uses its perception system to drive it to a tag, here is an example of a working solution (click the image below, it’s a link):

Solution Video

Visit the starter project repo

A working mrover install, per the Install ROS wiki page.

Then build the ROS 2 workspace by running

Terminal window
mrover
./build.sh
Terminal window
curl -fsSL https://raw.githubusercontent.com/umrover/auton-starter-project/main/scripts/setup.sh | bash

After it finishes:

Terminal window
source ~/.zshrc

In every new terminal run

Terminal window
auton_starter

After making changes to your code, compile through

Terminal window
build_starter

Then to run the simulator with your code run

Terminal window
ros2 launch mrover_autonomy_starter starter_project.launch.py