Getting started with the SWARM Simulation Platform
These brief instructions will help you get started with the simulator. The other topics in this help provide additional information and detail about working with other aspects of this platform.
In the welcome email you received, please put the file labelled LicenseKey.json in
the `settings` folder in the root of the `SWARM-RDS-Client` repository.
3. Start the SWARM Core System
A shell file has been provided in the `scripts` folder called `run_swarm_container.sh` that will run
the Docker image containing the SWARM RDS Server.
To run this file, please run the following command in the root of the `SWARM-RDS-Client` repository:
`./scripts/run_swarm_container.sh swarm-home:1.7.4 127.0.0.1`
The first arguement is the name of the Docker image to run. The second arguement is the IP address for ROS to utilize. You can ommit the second arguement if you are running everything locally.
4. Set Up Your Simulation
Look at the following file, as shown below, in the `settings` folder called `DefaultSimulationSettings.json`.
You can leave everything as it is above. This configuration will run a simulation with a
single agent with a single camera, returning to you a tar file containing the images
collected and a set of flight logs.
**Note** This file, along with the Trajectory you define, will be validated before submission.
5. Define Your Trajectory
You will need to set the set of points you want to fly. This can be done by modifying the file called `DefaultTrajectory.json` in the `settings` folder. Each point must have
the five fields as shown below and you are defining points in North, East and Down (NED).
6. Run the SWARM Developer Client
In another terminal, run the following command: `python3 main.py --map-name SWARMHome`.
The system will validate your settings file and trajectory file to ensure they are valid and will run properly. Once you have submitted, you will see the following messages in the terminal.
7. View Your Simulation
View the Streaming output by going to any web browser and typing `127.0.0.1`, then click
start to view the stream. This is a fully interactive client that will allow you to control the camera. (Hit `F1` to view options!)
8. Collect and View the Data
Once the simulation has been completed, it will ask if you want to collect data from the
server. Enter the number `1`. This will start the download process.
9. View Your Data
Untar the tarball file by running `tar -xzvf data/example_data.tar.gz`. This will print out what files were collected. You can go to the `data` directory to see the files.
An example video is shown below: