Quick Start
On this page
Run mura in simulation, on the bench, or on the car.
There are three ways to run mura, and each one puts more real hardware in place of the simulator:
- Software in the loop (SIL): everything runs on your computer, and
mura_simstands in for the car. - Hardware in the loop (HIL): the stack runs on the car’s hardware, fed by the simulator.
- On the car: the full sensor suite, on the real car.
Start with SIL. You don’t need any hardware for it.
Software in the loop (SIL)
Section titled “Software in the loop (SIL)”-
Install Pixi.
murabuilds on Linux and Apple Silicon Macs. -
Clone and build
mura:Terminal window git clone https://github.com/Melbourne-University-Motorsports/mura.gitcd murapixi installpixi run build -
Start the simulator with the stack driving it:
Terminal window pixi run ros2 launch mura_bringup sim.launch.py -
Open Foxglove, choose Open connection → Foxglove WebSocket, and connect to
ws://localhost:8765. In the 3D panel, set the display frame tomap.
You should see the car driving a circle.
To see the car model instead of a bare frame, run this in a second terminal, then add a URDF layer from /robot_description in the 3D panel:
pixi run ros2 launch mura_sim publish_urdf.launch.pyDrive it yourself
Section titled “Drive it yourself”Start the simulator on its own, without the stack:
pixi run ros2 launch mura_sim mura_sim.launch.pyThen drive with the keyboard in a second terminal, or with Foxglove’s Teleop panel publishing to /cmd_vel:
pixi run ros2 run teleop_twist_keyboard teleop_twist_keyboardi accelerates, , brakes, j and l steer, and k zeroes the input. The simulator takes acceleration, not speed, so the car keeps rolling when you let go.
More detail
Section titled “More detail”muraREADME: building, adding packages and common build problems.mura_simREADME: launch arguments, topics, parameters and how the simulator works.mura_coreREADME: the nodes in the stack and the topics between them.