MuShR: Multi-agent System for non-Holonomic Racing
This is the main repository for MuSHR. For a full directory structure see here. Below is a overview of each component:
mushr_demos: launch files for all demos on the mushr platform
mushr_description: meshes, stl files, and urdf's for each mushr platform. Also contains kinematic car model
mushr_docs: tutorials, assignments, and readme directory
mushr_hardware: launchfiles for running the car and location for installed hardware packages
mushr_utils: mapfiles, rviz setup files, and other utils for running various tasks
mushr_base: found here, provides core launchfiles and teleop scripts. Used for both real world and simulation
- mushr_base: Scripts that ties all mushr components together.
- vesc: Code for interfacing high-level commands with the low-level vesc controller.
- ydlidar: Package that contains all code for the laser scanner.
- push_button_utils: Package containing code for the push button.
- Realsense: External package for interfacing withe realsense camera.
- mushr_sim: The simulator package.
- mushr_pf: The particle filter used for localization in a map from laser scans.
- mushr_rhc: The receding horizon controller for navigating to goal points in a map.
The directory structure after install is here.
How do I get started?!
Visit our website! We have an ever-growing list of tutorials and build instructions there.
Who can use MuSHR?
This project is intended for students and researchers at the undergraduate and graduate level, but that doesn't mean you can't do it! We welcome motivated high school students, and makers to try out the platform too. You will need familiarity with the linux terminal, python, and general building skills. No soldering skills are required to build the platform.
Can I install mushr_sim on my desktop?
Yes, the easiest way is through following our quickstart tutorial. Otherwise, you can follow these instructions on a linux machine (you may need additional dependencies!). Only a subset of mushr is required to run the simulator. You will need ROS kinetic/melodic and ubuntu 16/18.04.
- Clone this repository into your catkin workspace
- Install vcstool.
vcs import < repos.yamlfrom inside the mushr directory and clone the sim into
- In your catkin workspace run
- You should now be able to launch the sim
roslaunch mushr_sim teleop.launch
This project is from the Personal Robotics Lab at the University of Washington Paul G. Allen School of Computer Science. It wouldn't be possible without the hard work and dedication of the following people:
Advisor: Sidd Srinivasa
Post Doctorial Advisor: Sanjiban Choudhury
Project Lead: Matt Schmittle
Our AMAZING Development Team: Matthew Rockett, Colin Summers, Johan Michalove, Patrick Lancaster, Max Thompson, and AJ Kruse