This guide explains how to build and run the VRX environment. Make sure to review the System Requirements before you begin.

To build the VRX software, you need a development environment with the necessary dependencies installed (these include ROS, Gazebo and some utilities). There are two ways to do this:

Set up your host machine as your development environment.

• This involves installing all dependencies directly on the host itself.
• This is the simplest option provided you are willing to set up your machine to use the specific version of Ubuntu/ROS/Gazebo listed in the System Requirements.

Set up a Docker container with the necessary dependencies.

• This involves installing Docker, then installing dependencies into a Docker image.
• The image functions like a lightweight virtual machine that allows you to build and run VRX.
• This option is a little more complex conceptually, but has the advantage of leaving the configuration of your host machine (mostly) undisturbed.
• Use this option if you are using the same host for multiple development projects that make use of different software environments (for example, different ROS versions), or just prefer not to install packages on your host system.

Set up a simple ROS workspace and get a copy of the VRX Simulation Environment source code.

After completing either Option A or B above, follow this tutorial to build and run the VRX software itself.