Code Structure#

AirLib#

Majority of the code is located in AirLib. This is a self-contained library that you should be able to compile with any C++11 compiler.

AirLib consists of the following components:

  1. Physics engine: This is header-only physics engine. It is designed to be fast and extensible to implement different vehicles.
  2. Sensor models: This is header-only models for Barometer, IMU, GPS and Magnetometer.
  3. Vehicle models: This is header-only models for vehicle configurations and models. Currently we have implemented model for a MultiRotor and a configuration for PX4 QuadRotor in the X config. There are several different Multirotor models defined in MultiRotorParams.hpp including a hexacopter as well.
  4. API-related files: This part of AirLib provides abstract base class for our APIs and concrete implementation for specific vehicle platforms such as MavLink. It also has classes for the RPC client and server.

Apart from these, all common utilities are defined in common/ subfolder. One important file here is ColosseumSettings.hpp which should be modified if any new fields are to be added in settings.json.

Colosseum supports different firmwares for Multirotor such as its own SimpleFlight, PX4 and ArduPilot, files for communicating with each firmware are placed in their respective subfolders in multirotor/firmwares.

The vehicle-specific APIs are defined in the api/ subfolder, along-with required structs. The AirLib/src/ contains .cpp files with implementations of various mehtods defined in the .hpp files. For e.g. MultirotorApiBase.cpp contains the base implementation of the multirotor APIs, which can also be overridden in the specific firmware files if required.

Unreal/Plugins/Colosseum#

This is the only portion of project which is dependent on Unreal engine. We have kept it isolated so we can implement simulator for other platforms as well, as has been done for Unity. The Unreal code takes advantage of its UObject based classes including Blueprints. The Source/ folder contains the C++ files, while the Content/ folder has the blueprints and assets. Some main components are described below:

  1. SimMode_ classes: The SimMode classes help implement many different modes, such as pure Computer Vision mode, where there is no vehicle or simulation for a specific vehicle (currently car and multirotor). The vehicle classes are located in Vehicles/
  2. PawnSimApi: This is the base class for all vehicle pawn visualizations. Each vehicle has their own child (Multirotor|Car|ComputerVision)Pawn class.
  3. UnrealSensors: Contains implementation of Distance and Lidar sensors.
  4. WorldSimApi: Implements most of the environment and vehicle-agnostic APIs

Apart from these, PIPCamera contains the camera initialization, and UnrealImageCapture & RenderRequest the image rendering code. AirBlueprintLib has a lot of utility and wrapper methods used to interface with the UE4 engine.

MavLinkCom#

This is the library developed by our own team member Chris Lovett that provides C++ classes to talk to the MavLink devices. This library is stand alone and can be used in any project. See MavLinkCom for more info.

Sample Programs#

We have created a few sample programs to demonstrate how to use the API. See HelloDrone and DroneShell. DroneShell demonstrates how to connect to the simulator using UDP. The simulator is running a server (similar to DroneServer).

PythonClient#

PythonClient contains Python API wrapper files and sample programs demonstrating their uses.

Contributing#

See Contribution Guidelines

Unreal Framework#

The following picture illustrates how Colosseum is loaded and invoked by the Unreal Game Engine:

ColosseumConstruction