Author: Huanyu Li
This is the repository for MRAC01 25/26 workshop 2.1. The seminar focuses on the "infrastructure" of a robotic perception project. Guide students how to allow multiple members to code simultaneously without conflict. Understand the complexity of hardware + software integration and learn how to use the software tools for developing projects in a standard environment.
Before starting, you must have:
- A Windows 11 or Linux laptop (reserve at least 60GB free space in your "C" Disk)
- Github account
- Python installed(basic knowledge required)
- VSCode
You should understand:
- Variables, lists and dictionaries
- Functions and loops
- Reading and writing files in Python
- Navigating the file system using the command line (using
cd,ls,dir,mkdir, etc. in PowerShell or Command Prompt)
All workshop tasks must be completed using the terminal or command prompt. GUI downloads or clicks are not allowed.
🚨 Students who do not have the required Python knowledge or command-line skills will fall behind in the workshop at the very beginning. It is essential to come prepared with these basic skills.
🚨 Do NOT attempt to install Linux or set up a dual-boot system if you have never done it before.
Installing Linux alongside Windows can be risky: it may accidentally overwrite or delete important Windows files, and recovering your system can be difficult.
All necessary software (Git, docker, virtual environments, etc.) will be installed together with the faculty during the workshop.
All the materials are orgnized by day. Each folder contains:
README.md- overview and instructionsdoc- slides and imagesexcercises- hands-on tasks
You can jump to the worksop material from the following links:
- Day 1: Introduction & Setup
- Day 2: Github Collabrative Workflow & WSL Basic
- Day 3: Environments, Docker & Advanced Python
- Day 4: Robotic Kinematics & Perception Systems
- Day 5: ROS 2 Tour & Motion Planning with MoveIt
Here are some common problems students may encounter during the workshop, and how to fix them.
Solution
- Free up space by deleting unnecessary files (temporary files, downloads, old projects).
- Uninstall heavy softwares that you don't use often, or migrate it to another disk.
- Enlarge your C drive by extending volumns with tools. You can find tutorials here, but make sure you understand risk before you do it.
Solution Windows Subsystem for Linux (WSL) now supports running Linux GUI applications (X11 and Wayland) on Windows in a fully integrated desktop experience.
- You will need to be on Windows 10 Build 19044+ or Windows 11 to access this feature.
- To run Linux GUI apps, you should first install the driver matching your system below. This will enable you to use a virtual GPU (vGPU) so you can benefit from hardware accelerated OpenGL rendering.
This project is licensed under the MIT License. See the LICENSE file for details.