About Parrot Sphinx launcher

Parrot Sphinx features an interactive launcher that allows users to run simulations easily, without the need to write their own command lines.

It allows users to choose locations, environments, drones, and actors, as well as downloading the simulation logs.

To run Parrot Sphinx Launcher, within a shell you simply need to run the command:

$ sphinx-launcher

sphinx-launcher allows to:

1. World and Level Selection

   • Select the desired world and level from a list of available UE worlds installed on your computer.

   • Select the spawn point where you want to spawn the drone.

   • A preview of the spawn location is displayed on the “Environment” page.

   • Custom UE configuration files can be loaded using the Advanced tab. Custom configuration files allow to customize the UE environment. More information can be found here for AMS part and here for the environment part.

2. Drone Configuration

   • Choose the drone you want to simulate from a list of available drones within Parrot Sphinx.

   • Choose the firmware you want to use.

   • Adjust different drone’s parameters from available parameters. More information HERE.

   • A preview of the drone model is displayed ont the “Drone” page.

3. Interactive Map

   • Choose a GPS location using an interactive map. To set a new location you can use the mouse left/right click to place a marker.

   • You can search for a location using the search bar. You can also manually write the GPS location in the GPS coordinates field.

   • This map makes it easy to set the world GPS coordinates especially when using the world planet.

4. Actors and Paths

   • Add actors (vehicles, pedestrians) to the simulation.

   • The “Actors” tab shows the list of available paths in the world.

   • You can assign one or multiple actors to any of the available paths from the list of available actors.

5. Run Simulations

   • Run the simulation using the “Launch Simulation” button with the configuration described above.

   • A configuraion file is saved under ~/.parrot-sphinx/sphinx-launcher.json and allows to load the configuraion used in the last run.

   • Stop the simulation using the “Stop Simulation” button.

6. Interact with simulation

   • Four actions are available to interact with the simulation:

     • Open the web dashboard.

     • Toggle actors pause to make them move or stop.

     • Download logs. You can choose which logs you want to download and where to save them. More details.

     • Reset the simulation to its initial state.