/mushr

MuSHR: Multi-agent System for non-Holonomic Racing

Primary LanguageCMakeBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

no image

MuSHR

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

Component Documentation

  • 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.

FAQ

  • 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.

  1. Clone this repository into your catkin workspace /src directory.
  2. Install vcstool.
  3. Run vcs import < repos.yaml from inside the mushr directory and clone the sim into catkin_ws/src.
  4. In your catkin workspace run catkin_make.
  5. You should now be able to launch the sim roslaunch mushr_sim teleop.launch

Acknowledgements

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